Markdown

Markdown 边写边练：从打开编辑器到写出可发布的文档

Markdown 是一门用纯文本写格式化文档的轻量标记语言：几个符号管加粗，几个井号管标题，写完随手就能发布成网页、文档或笔记。本教程采用"边写边练"的编排——每一节都从一段可以直接敲进编辑器的文本开始，先看到源码，再看渲染结果，最后讲清楚背后的规则和坑。

这套教程不按"语法手册"的顺序罗列知识点，而是按你真实写作时遇到的需求推进：想给文档搭骨架，就学标题与段落；想强调重点，就学强调与转义；想让文档里出现表格、流程图、架构图，就进第二、三章；写到一半发现不同平台渲染结果不一样，第四、五章解释方言与工具链；最后一章把书写规范和排错经验收拢。

你将学到什么

1. Markdown 全部基础语法：标题、段落、强调、列表、引用、代码、链接与图片，每一项都配"源码 → 渲染结果"对照。
2. 结构化表达：表格对齐、任务列表、脚注、Emoji、上下标这些进阶记号。
3. 图表能力：用 Mermaid 画流程图与时序图，用内联 SVG 画 mermaid 不好表达的架构图与对比矩阵。
4. 方言与规范：CommonMark、GFM 以及各平台变种的差异，写出的文档换平台不翻车。
5. 工具链：编辑器、解析器、格式转换，从写作到发布的完整链路。
6. 规范与排错：团队书写约定、渲染原理，以及十几个最常见的"为什么不生效"。

全教程知识地图

怎么使用这套教程

准备任何一个支持实时预览的编辑器（Typora、VS Code 加预览插件、或你正在看的这个平台的编辑器都可以），左边写源码、右边看渲染。每节给出的示例都刻意保持在一屏以内，照着敲一遍比读三遍有效。

各章相对独立，但第 1 章是地基，建议顺序读；第 4、5 章偏"知其所以然"，写作遇到困惑时再翻也来得及。

每一节末尾都有一段可以立刻上手的小练习或小观察，多数五到十分钟就能完成——它们不是课后作业，而是教程正文的一部分：很多"一看就懂、一写就错"的细节（井号后的空格、列表的缩进、定界符的边界），只有手指经历过一次才会真正记住。如果只能抽出碎片时间，优先把第 1 章的每节练习做完，那是全书投入产出比最高的一段路。

这套教程假设你有什么基础

不假设任何编程或排版基础：会打开文本文件、会打字、能把一段话写通顺，就足够了。写代码的读者可以跳过第 1 章里已熟悉的段落，但别跳过各节的"排错"小节——那里的案例来自真实文档事故，多数与编程无关，而是与解析规则的理解有关。反之，从不写代码的读者会在第 3、5 章遇到少量 HTML 与命令行，教程在那些位置都补了够用的背景，不必先去另学一门课。唯一需要自备的是一份"想写点什么"的真实素材：项目笔记、学习总结、团队文档都行，教程里的练习都鼓励换成你自己的内容来做，用自己的素材练，印象比照抄示例深得多。

一句话：Markdown 的符号就那么十几个，难的不是记忆，而是在真实文档里知道什么时候用哪一个。这套教程练的就是这个判断。