Markdown 入门

Markdown 是一种用纯文本写结构化文档的轻量标记语言:你在文件里敲下 #、*、-、[]() 几个符号,解析器再把它们翻译成 HTML、PDF 或幻灯片。写作时你面对的是一份可以直接阅读、可以直接提交进版本库的普通文本文件,而不是只有某个编辑器才能打开的私有格式。

这一章要回答三个最基础、却最常被含糊带过的问题。第一,Markdown 到底规范了什么、没规范什么——它只规定「哪些符号意味着什么」,不规定字体、间距和主题,也不管你写的是中文段落还是一段代码。第二,它和 HTML 是什么关系——Markdown 只是 HTML 的一部分的另一种写法,两者可以互相嵌套,最终内容仍然要落到 HTML 上。第三,在所见即所得的编辑器如此普及的今天为什么还要用它——答案在于纯文本带来的可移植性、可比较性,以及多年之后依然能被任何工具读懂。

读完这一章,你应该能一眼判断一个文件是不是 Markdown,能说清它和 HTML 的分工,也能解释为什么在项目里写说明文档时,Markdown 几乎总是比富文本更稳妥。同时你会形成一个习惯:Markdown 只负责表达结构,视觉呈现交给渲染器和主题;一旦你开始纠结字号和间距,那说明该换工具,而不是继续往正文里加标记。

所谓「轻量」有两层意思。一是符号少,核心语法十来行就能学完,并不存在一张需要从头背到尾的语法表;二是边界清晰,规范明确写出了哪些写法有效、哪些无效,你不必去猜解析器的心情,遇到分歧时答案总能在规范里找到。

本章不需要任何前置知识,会打字、会用文本编辑器即可。读完后的收获是一套判断标准:什么样的内容适合写成 Markdown,写作时该把力气花在哪里,以及遇到不顺手的工具时该如何取舍。把这份判断标准带到后面的章节里,你会发现所有语法其实都在回答同一个问题——这段文字的结构是什么,而不是它最终长什么样。

章节

发现内容有问题?

告诉我们哪里需要改进。