Markdown 是一种轻量级标记语言，由 John Gruber 于 2004 年创建，用易读易写的纯文本格式编写文档，再转换成结构化的 HTML。你只需要记住十来个符号，就能在任意文本编辑器里写出带标题、列表、表格、代码块的文档，并一键导出为 HTML、PDF、Word 等格式。下面按「语法 → 编辑器能力 → 写作流程 → 常见问题」的顺序讲清楚。
Markdown 基础语法
标题\n用 # 的数量表示层级，# 后需要一个空格：
# 一级标题
## 二级标题
### 三级标题\n```
一级标题通常对应文档主标题，一篇文档里一般只用一个；二级、三级用于章节划分。注意 `#` 与文字之间必须有空格，否则多数解析器不会识别为标题。
### 文本样式\n```markdown
**粗体文本**
*斜体文本*\n~~删除线~~\n`行内代码`\n```
粗体用两个星号包裹，斜体用一个星号，删除线用两个波浪线，行内代码用反引号。星号与文字之间不要留空格，否则样式不会生效。
### 列表\n```markdown
- 无序列表项 1
- 无序列表项 2
1. 有序列表项 1\n2. 有序列表项 2\n```
无序列表用 `-`、`*` 或 `+` 开头，有序列表用数字加点。同一份文档里建议统一用一种符号。嵌套列表通过缩进实现，通常缩进两个或四个空格。
### 链接与图片\n```markdown\n[链接文本](https://example.com)\n\n```
链接是方括号写文字、圆括号写地址；图片在链接语法前多一个感叹号。方括号里的描述文字在图片加载失败时会作为替代文本显示，不要留空。
### 代码块\n````markdown\n```python\ndef hello():
print("Hello, World!")\n```\n````
用三个反引号包裹，并在开头反引号后写上语言名，编辑器就能对代码块做语法高亮。语言名写错或省略时，代码仍会以等宽字体显示，但不会着色。
### 表格\n```markdown
| 列1 | 列2 | 列3 |
|-----|-----|-----|
| A | B | C |\n```
第一行是表头，第二行是用竖线和短横线组成的分隔行，之后每行是一条数据。列数不必手动对齐，但竖线数量要与表头一致。分隔行里用冒号可以控制对齐：左侧冒号左对齐，右侧冒号右对齐，两侧都有冒号居中。
## 为什么选择 Markdown
1. 专注内容：不需要操心排版，专注于写作本身。
2. 纯文本格式：任何文本编辑器都能打开，不会过时。
3. 版本控制友好：Git 可以轻松追踪 Markdown 文件的变化。
4. 一键导出：可导出为 HTML、PDF、Word 等多种格式。
5. 广泛支持：GitHub、Notion、Obsidian 等主流平台都支持。
## 在线 Markdown 编辑器的优势
使用在线 Markdown 编辑器，你可以获得：
- 实时预览：左边编写，右边即时查看渲染效果。
- 语法高亮：代码块自动高亮，支持多种编程语言。
- 自动保存：内容实时保存在浏览器本地，不怕丢失。
- 导出功能：一键导出为 HTML 或 Markdown 文件。
实时预览的核心价值在于「所见即所得」的反馈速度：你在左侧改动一个符号，右侧立刻能看到渲染结果，不必反复切换窗口或手动刷新。语法高亮则让代码块里的关键字、字符串、注释用不同颜色区分，长代码段的可读性明显提升。自动保存一般依赖浏览器的本地存储，关闭标签页后重新打开通常还能恢复内容，但它不等同于云端备份，重要文档仍建议另存一份。导出功能让你把同一份源文件输出成不同格式：导出 HTML 便于发布到网页，导出 Markdown 便于迁移到其他编辑器或平台。
## 分步操作：从零写一篇 Markdown 文档
1. 新建文件：在编辑器里新建一个空白文档，文件名以 `.md` 结尾。
2. 写主标题：第一行输入 `# 文档标题`，`#` 后加一个空格。
3. 划分章节：用 `##` 写二级标题，用 `###` 写三级标题，层级不要跳级使用。
4. 填充正文：段落之间空一行；需要强调时用粗体，需要列举时用列表。
5. 插入代码或表格：代码用三个反引号包裹并标注语言；表格先写表头和分隔行。
6. 打开实时预览：在编辑器里切换到分栏或预览模式，检查渲染效果。
7. 检查细节：确认标题层级、列表缩进、链接地址、表格竖线数量是否正确。
8. 导出或保存：按需要导出为 HTML 或 Markdown，并确认自动保存已生效。
## 进阶技巧
- 使用 `[TOC]` 自动生成目录。
- 使用任务列表 `- [ ]` 和 `- [x]` 管理待办事项。
- 合理使用引用块 `>` 突出重要内容。
- 用水平线 `---` 分隔不同段落。
## 常见问题
**问：`#` 后面不加空格会怎样？**\n答：多数解析器不会把它识别为标题，而是当作普通文本显示。标题、列表、引用等符号后通常都需要一个空格。
**问：为什么我的表格渲染不出来？**\n答：最常见的原因是缺少第二行的分隔行，或分隔行与表头的竖线数量不一致。补上 `|---|---|` 这类分隔行即可。
**问：实时预览和导出结果不一致怎么办？**\n答：不同编辑器对 Markdown 的扩展语法支持程度不同。尽量使用基础语法，扩展语法在目标平台上先测试一遍。
**问：自动保存的内容会丢吗？**\n答：自动保存通常保存在浏览器本地，清理浏览器数据或更换设备后可能无法恢复。重要内容建议同时导出或另存。
**问：Markdown 适合所有人使用吗？**\n答：它适合技术写作、文档编写和笔记记录，也适合需要版本控制的场景。如果需求是复杂排版、精细控制字体和版式，传统富文本或排版软件可能更合适。
Markdown 的简单优雅，让它成为了数字时代最受欢迎的写作格式之一。