使用 VSCode 管理 Markdown 笔记，还有必要吗？

在 201x 年的时候，使用 VSCode 编写 Markdown 笔记，是一件很极客很酷的事情。

轻敲 Markdown 语法，即可生成还不错的格式；使用 VSCode 以及强大的插件系统，可以得到一个免费强大离线化的 Markdown 编辑器。

但在 2023 年的今天，我们发现除了给项目写 README 文件，好像很少人会单独使用 VSCode 来写 Markdown 笔记了。

尝试从上手成本、编写体验、管理能力三个方向来分析：

VSCode 上手成本太高：如果只是简单编写和展示，VSCode 的 Markdown 默认能力是支持的。但如果想要增强功能（比如支持流程图、思维导图等）、优化编写体验（比如粘贴上传、可视化工具栏等），就需要去安装各种插件，尝试各种配置，踩各种坑，才能实现目的。人的时间宝贵，真不如直接使用各种在线文档（飞书文档、腾讯文档、Notion 等）或者笔记软件（印象笔记、Obsidian 等）。
Markdown 编写体验不佳：现在更流行的是 Notion 这种 编辑即所得 的编写方式，体验比 Markdown 编辑器这种「左侧编写、侧边预览」的体验更好。同时 Notion 等类型软件也能导出 Markdown 原数据，还支持更丰富的编辑区块，对纯 Markdown 软件来说就是降维打击。
笔记管理能力太弱：包括数据同步和分类索引。如果要做数据同步，我们需要创建 Git 仓库，配合 GitHub 等服务来进行同步；如果要支持分类和标签，我们可能还得引入博客工具，搭建在线博客服务才能进行索引。而这些能力，常见的笔记工具都提供了，且大多数免费。

那么，如今我们是否还有必要学习 Markdown 语法，写 Markdown 笔记？以及是否还有必要使用 VSCode 来管理笔记？

本篇文章就来回答这两个问题，方便笔记软件选型，纯个人见解，欢迎讨论。

# 1. 是否还有学习 Markdown 语法的必要？

先说我的观点：需要了解基础语法，但相对复杂的比如 表格、数学公式、mermaid 图表 等无需了解，永远交给工具来自动生成

基础语法的定义是什么？常用且简单，比如

基本每篇 Markdown 文档都会含有的元素

为什么要了解？因为高效，相比点击工具栏图标，直接手敲语法字符更快，同时保持连续编辑状态不会有打断和跳脱感。Notion 等主流笔记软件也基本兼容 Markdown 语法。

当然你也可以使用快捷键达到相同的目标，但由于各家笔记软件的快捷键标准并不统一，有些还不支持（原生 VSCode），因此个人还是推荐了解并手敲基础语法。

除此之外，研发人员经常需要给项目编写 README 和 SDK 文档，直接使用 VSCode 编辑可没有笔记软件那些操作功能。

复杂语法是什么？不常用，很难写，很难记。每个人认为的复杂语法可能不一样，对我来说，表格就是复杂语法了。

为什么不需要了解？有以下两点：

那么，有哪些工具可以帮忙生成复杂语法呢？

正常描述需求，让它提供 Markdown 语法。

比如让他生成一个表格：

如果不知道怎么描述，可以先这样问它：

假设我是 ChatGPT，你想让我生成 Markdown 语法表格，你会怎么描述

使用 ChatGPT 进行对话描述，有时候效率太低，我更喜欢使用在线工具

Markdown 表格在线生成 (opens new window)
Markdown 数学公式在线生成 (opens new window) 还提供图片渲染地址，比如 https://latex.codecogs.com/svg.image?\int_{a}^{b} ，将渲染为： $\int_{a}^{b}$
mermaid 在线编辑 (opens new window) 不支持可视化操作，需要了解并编写语法。暂未找到支持可视化编辑 mermaid 图表的工具，因此我更偏好于使用 ChatGPT

先说我的观点：

大多数人没必要使用 VSCode ，而是使用现成的笔记软件比如 Obsidian 等，更好用更强大，也支持数据导出。如果想快速对外分享，可以尝试 Notion、飞书文档；如果想定制站点样式，可以尝试 Notion、Wordpress 等。
少数有完全自定义并部署博客的需求（通常是前端研发同学），那就可以使用 VSCode 来管理。
在如今降本增效的今天，把时间花在更有意义的事情上。

本文不做笔记软件的推荐，读者可以根据自己的诉求选择合适的软件。

我个人常用的是飞书文档，也自己搭了一个博客站点 (opens new window)，有一些 VSCode 管理 Markdown 笔记的经验。

分享几个不错的 VSCode 拓展：

Front Matter CMS (opens new window)（强烈推荐）: 像 CMS 一样管理自己的本地 Markdown 笔记。提供了 3 个很强大的功能：front-matter 可视化编辑、类似 CMS 的本地预览、Markdown 工具栏，详情查看官方文档。
Foam (opens new window)：支持笔记图谱、双链笔记、卡片写作等等。少数派有一篇文章介绍了如何使用 Foam 来管理双链笔记 (opens new window)，感兴趣可以看看。

本文讨论了在笔记软件盛行的今天，是否还有使用 VSCode 管理笔记的必要。

总结一下观点：

最后，重要的不是工具，而是内容和思维方式，不能因噎废食。

上次更新: 2023/08/23, 09:32:05