Markdown 语法字典：从零开始的完整指南

Markdown 用键盘上常见的少量字符描述文档结构。本篇可以当作词典使用：读一条规则、照着抄一个小样例，再放进自己的文件里。

MarkIOY Team · 2026 年 8 月 12 日 · 约 24 分钟阅读

Markdown 是什么？

Markdown 是轻量标记语言：在纯文本中加少量表示“含义”的字符。渲染器看到 # 标题 就把它当标题，看到 - 项目 就把它当列表，看到 [文字](地址) 就把它当链接；即使没有渲染器，源码也仍然能读懂。

把它理解成一份约定：你写出稳定的模式，编辑器或网站负责呈现样式。它适合笔记、README、产品说明、技术文档、博客草稿和提示词；不适合杂志级精确排版、页面定位的合同或任意视觉布局。

常用 Markdown 语法与符号

下表的每一行都是一个小模式，并不是“猜出来”的。第一次请原样抄写，保留其中的空格、标点和换行。标题、段落、强调、链接、列表、引用和代码是最可移植的核心；表格和任务列表等属于不同工具支持程度不一的扩展。

一段可复制的开始模板

# 文档标题

一句话说明这份文档解决什么问题。

## 步骤

1. 先完成准备工作。
2. 运行 `npm run build`。

> 提示：代码块请标明语言，例如 ```ts。

段落、空格、换行、嵌套和表格

普通句子直接输入即可。一个换行通常仍属于同一段；留一个空行才开始新段落。若要强制换行但不另起段落，可在前一行末尾加两个空格或一个反斜杠后再回车。子列表在父项下缩进 2 到 4 个空格。任务项是扩展语法：- [ ] 未完成，完成后写成 - [x] 已完成。表格用竖线 | 分列、表头下一行连字符分隔，只应用来比较真正的行列数据，不应用来排版页面。

链接、图片和显示字面符号

链接文字要说明去哪里，例如 [查看安装指南](...)，不要只写裸 URL 或“点这里”。当 Markdown 标点本身需要显示时，在它前面加 \；例如行首的 \# 会显示井号，而不会变成标题。表格、脚注、数学公式、HTML 和 Mermaid 图表属于常见扩展，分享给他人前请在最终工具中预览。需要输入公式时，可查看 Markdown 数学公式完整指南。

让 Markdown 长期好维护的最佳实践

1. 先设计层级，再填内容

一个文档只保留一个 # 标题，后续按 ##、### 顺序递进，不要为了“看起来大”而跳级。每个标题应准确概括后面的内容；只调大文字而不用标题，读者、屏幕阅读器、搜索和 AI 都无法可靠定位。

2. 让链接文字表达目的

避免“点击这里”。写成“查看部署检查清单”能让脱离上下文的读者知道链接会带去哪里，也让检索、引用和朗读更可靠。发布前确认链接有效；只有文件会一起迁移时才使用相对路径。

3. 用代码围栏保留原样

命令、配置和提示词使用代码块；给开头围栏加 bash、json、swift、mermaid 或 latex 等语言标签。结尾三个反引号必须独占一行。若代码本身包含三个反引号，外层就用四个反引号。

4. 把“事实、决策、待办”写成不同结构

事实写成短段落并附来源；决策写清日期、取舍和负责人；行动用复选框。引用块应用来引用原话，而不是单纯让文字显得重要。结构化区分比更长的说明更能降低协作误解。

5. 以纯文本可读性为验收标准

发布前在源码里读一遍：标题顺序是否合理？链接是否说明目的？图片有无替代文字？表格会不会在窄屏超宽？代码围栏是否闭合？引用能否识别？若原文难读，迁移、版本比较、无障碍与 AI 使用也更脆弱。

这也是 MarkIOY Web 同时保留可视化与源码编辑的原因：你可以直接在舒适的阅读界面中组织内容，让 Markdown 同步更新；也能随时检查、复制和带走真正的 Markdown 文件。

为什么 AI 时代更需要 Markdown

AI 并没有让结构化写作失去价值，反而放大了它的价值。Markdown 是人类可读、机器可解析、版本控制友好的共同中间层：一份规范能被人审阅、被模型总结、被检索系统切分，也能被网页或文档工具渲染。

不过 Markdown 不是事实保证。AI 生成的链接、数字、代码和引用仍须核验；复杂表格、公式和图表也要在实际目标渲染器中检查。最可靠的流程是：先让 AI 生成结构化草稿，再由人补充来源、做事实校验，并在发布前预览。

它同样让知识不被单一平台锁住：文件可以保存在本地、进入 Git、迁移到另一个编辑器，或作为 RAG 知识库的清晰输入。格式简单，未来的选择就更多。