Markdown编辑器与预览器完全指南：语法、选型到常见问题排查

1. 先搞清楚：Markdown 编辑器到底解决什么问题

1.1 标题里的两个词，我们到底在讨论什么

先说结论：Markdown Editor，也就是 Markdown 编辑器，本质上就是给“用纯文本写结构化内容”这件事配的一个顺手的工具。它的核心价值不在于“打字”，而在于“边写边能看到最终效果”——这就是标题里“预览器”三个字的含义。

我在实际使用中，几乎每天都会打开 Markdown 编辑器，无论是写技术文档、记录工作笔记，还是维护个人博客。说实话，Markdown 本身的门槛低到可以忽略不计，真正拉开体验差距的，反而是你选哪个编辑器、怎么配置预览、怎么导出成果。这就像学车，手动挡和自动挡都能到目的地，但城市通勤你肯定选自动挡。Markdown 编辑器就是帮你把“写作”这个动作变得足够顺滑的东西。

这篇文章适合几类人：刚接触 Markdown、还没找到顺手工具的新手；已经用了挺久但总被图片路径、表格导出、PDF 转换这些问题卡住的进阶用户；还有需要在不同设备之间切换写作场景的办公族。我会把选型思路、核心语法细节、常见坑全部拆开讲，争取你看完就能搭出一套自己的写作工作流。

1.2 编辑器与编译器：一字之差，完全不同的东西

很多人第一次搜“Markdown Editor”时，会连带搜出“编译器和编辑器的区别”，这俩确实容易绕晕，但理解清楚了对后续选型特别重要。

编辑器（Editor）是你在上面写代码、写文本的工具，比如 Typora、VS Code、记事本，它们负责“输入”。编译器（Compiler）是把人类可读的源代码转换成机器可执行代码的程序，比如 GCC 之于 C 语言，它负责“翻译”。Markdown 的情况有点特殊，它没有一个传统意义上的“编译器”，而是靠“解析器”把 Markdown 文本渲染成 HTML。解析器读入 # 标题，输出 <h1>标题</h1>，然后浏览器或者预览面板把 HTML 显示成带格式的网页效果。

所以你在搜“markdown语法”的时候，实际上是在学一套“写给解析器看的规则”。理解了这层关系，后面遇到的很多问题，比如“为什么我的预览效果和导出 PDF 不一致”“为什么换行没生效”“为什么表格到 Excel 里乱了”，根源几乎都在解析器对语法的处理差异上。

现在市面上主流 Markdown 解析器有好几个，CommonMark、GitHub Flavored Markdown（GFM）、Pandoc 各自的规则细节略有不同。GitHub 用的 GFM 支持任务列表、表格、删除线，这些在标准 CommonMark 里是没有的。你本地编辑器的预览效果和发布到网上的效果不一致，十有八九就是解析器差异导致的。

2. 核心语法细节与预览渲染原理

2.1 语法优先级：先学会这几个，就够用了

Markdown 语法手册一搜一大把，但我个人的建议是：别试图一次性背完所有语法，那没有意义。你只需要先掌握下面几个出现频率最高的，就能覆盖日常 90% 的写作场景：

• 标题：# 到 ######，对应六级标题，注意 # 后面要加一个空格，不加在某些解析器里会被当作普通文本。
• 粗体与斜体：**加粗**、*斜体*、***加粗斜体***，符号必须成对出现。
• 链接与图片：[文字](网址) 和 ![alt](图片路径)，结构几乎一样，图片多了个 !。
• 列表：无序列表用 -、*、+，有序列表用 1. 2.` 这种，注意嵌套列表要缩进。
• 引用：行首加 >，引用块内还可以嵌套标题、列表，写嵌套的时候每个子行都要加 >。
• 代码块：行内代码用反引号 `code`，多行代码块用三个反引号包裹，并且可以指定语言实现语法高亮，比如 ```python。

从实际经验看，这六个语法点学会之后，你就能写绝大多数文档了。表格、脚注、数学公式、Mermaid 流程图这些属于“进阶模块”，用到的时候再查语法手册完全来得及。所以我一直跟朋友说：Markdown 不是你专门花时间学的，而是写着写着就会了。

2.2 换行为什么是新手第一个坑

“Markdown 换行”能成为热搜词，说明这不是一个小众困惑。很多新手写第一份 Markdown 文档时都会遇到这个情况：在编辑器里敲了回车换行，预览效果里两行文字却挤在一起，没有形成新的段落。

这里涉及一个关键规则：在 Markdown 里，单纯的敲一次回车，在渲染结果中只会被视为一个空格，而不是换行。如果你想真正换行，有两种方式：

1. 行尾加两个空格，然后回车，实现“软换行”（在 HTML 里对应 <br>）。
2. 两个段落之