Markdown 编辑器推荐
学完语法之后，另一个现实问题会浮上来：到底该用什么工具写？这一页要说明的是，编辑器只影响你的写作体验，不影响文件本身——无论你用哪一款工具写下的 .md，最终都只是磁盘上一个纯文本文件，语法规则完全一致。选工具时真正该看的，是它能不能在你打字的时候就把常见问题挡在门外。
- VS Code：插件丰富（Markdown All in One、Paste Image、Preview Enhanced）。
- Typora：所见即所得，写作体验好。
- Obsidian：双链、知识库管理。
- Notion：协作/团队文档，支持 Markdown 导入导出。
- 浏览器/在线：GitHub、GitLab、Gitee 均支持在线编辑与预览。
这几类工具的差别，可以按「所见即所得的程度」和「是否围绕文件与仓库」两个维度来理解：
| 编辑器 | 类型 | 适合谁 | 需要注意 |
|---|---|---|---|
| VS Code | 源码编辑器加插件 | 写代码、边写边看文档 | 依赖插件补齐预览与目录 |
| Typora | 所见即所得 | 纯写作、长文 | 扩展语法支持有限 |
| Obsidian | 本地知识库 | 双链笔记、跨文档管理 | 自定义语法较多，容易和通用写法混用 |
| Notion 等在线工具 | 协作平台 | 团队协作、多端编辑 | 导入导出可能丢失部分语法 |
- 自动目录、代码高亮、公式（KaTeX/MathJax）、任务清单、图表（Mermaid）。
- 图片粘贴/拖拽，剪贴板直传。
其中最省事的一项是图片粘贴：在 Typora、Obsidian、VS Code 里直接复制一张截图，编辑器会自动存成图片文件，并在正文中插入一个相对路径链接。源码里留下的是这样一行：
渲染出来的 HTML 则是：
<p><img src="./images/arch.png" alt="架构示意图"></p>你只需要确认图片确实被存进了同一目录，就不必关心任何标签细节。
另一项值得留意的是「所见即所得」与「所见即源码」的取舍。纯源码视图的好处是符号全部可见，出问题时你能一眼看出多敲了一个空格；所见即所得的好处是排版直观，不容易漏掉空行。多数编辑器同时提供两种模式，建议写长文时用所见即所得理顺结构，提交前切到源码视图通读一遍——很多「渲染不对」的问题，在源码视图里是肉眼可见的。
同一个文件，在编辑器的源码视图里是这样：
## 安装
- 执行 `npm install` 安装依赖在预览窗口里则是这样：
<h2>安装</h2>
<ul>
<li>执行 <code>npm install</code> 安装依赖</li>
</ul>两个视图指向同一份文件，改动的始终是磁盘上的源码，预览只是它的一种呈现方式。
- 写代码/文档：VS Code。
- 纯写作：Typora/Obsidian。
- 团队协作：Notion/Confluence（Markdown 兼容）。
不管最终用哪一款，有三个能力值得优先确认：能否实时预览、能否自动插入目录、能否粘贴图片。满足这三点，日常写作基本不会卡壳；其余功能都是加分项。
工具不会替你纠正语法错误。 预览面板显示的是解析结果，不是校验结果：源码里多敲一个空格，预览里就少一个换行，而编辑器往往不会给出任何提示。因此定期切到源码视图检查一遍，比换一个更贵的编辑器更有效。
在任意一款编辑器里新建一个文件，输入下面三行，然后切到源码视图检查：
## 安装
- 执行 `npm install`解题思路： 这道题检查的是「源码视图与预览视图是否一致」。源码视图必须能看到井号、反引号和短横线这些标记符号本身；如果预览里没有生效，说明标记符号写错了或被中文输入法替换了。
详细步骤：
- 在编辑器里新建文件，输入三行：标题行、列表行、命令行。
- 切到源码视图，确认井号、反引号和短横线都是正常的英文半角符号。
- 检查预览窗口：
npm install应当显示为等宽字体，列表项应当缩进成列表。 - 如果没有生效，常见原因是：① 用中文输入法打出了顿号「、」而不是反引号「`」；② 在标记符号后面多敲了一个空格。
最终答案：
源码视图里应该能直接看到井号、反引号和短横线本身。如果预览窗口里 npm install 没有变成等宽字体、也没有缩进成列表，说明反引号或短横线没有被识别——常见原因是用了中文输入法打出的顿号，或者在符号后面多敲了一个空格。
读完这一页，你应当能说清主流编辑器各自的定位，并能按「实时预览、自动目录、粘贴图片」这三条标准做选择。下一步不妨挑一款工具新建一个文件，把前面学过的语法逐条敲一遍，看着预览结果确认自己的理解。