概述
Markdown 的目标是实现「易读易写」。
Markdown 是一种轻量级的「标记语言」,Markdown 的格式语法只涵盖纯文本可以涵盖的范围,一份使用 Markdown 格式撰写的文件应该可以直接以纯文本发布,并且看起来不会像是由许多标签或是格式指令所构成。
语法
兼容HTML
不在 Markdown 涵盖范围之内的标签,都可以直接在文档里面用 HTML 撰写。
在 HTML 文件中,需要特殊处理的两个字符: < 和 & 会根据使用的场景自动转换为 <
和 &
;
基本语法
使用空白行来分割段落,很多Markdown语法都是基于段落的,例如:引用,在段落的开始处使用引用符号后,同一个段落的文字(即紧邻的下一行和其后连续的多行)都会被视为引用内容。
使用反斜杠 \ 来展示特殊字符,例如展示星号符 * 则使用 \*
标题
在文字的下一行使用===
表示1级标题
在文字的下一行使用---
表示2级标题
注:标题级别和=或-的数量无关
注:需要多级标题,可以在文字前方加n个#号来表示n级标题,支持1-6级标题
例子: