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