Markdown
Markdown 是一种轻量级标记语言,用纯文本加少量符号来描述文档排版,最初由 John Gruber 于 2004 年提出。它的核心是「源码即可读」:像 *斜体*、# 标题、- 列表 这样的写法不经渲染也能看懂。写好的 .md 文件由解析器转换成 HTML,再显示为带格式的页面。
它在开发中几乎无处不在:项目的 README.md、GitHub 的 Issue 与评论、技术博客、笔记软件等大多用它。相比手写 HTML,它写起来更快、也更专注内容。常见语法有:
- 标题用
#到######,井号个数代表层级; - 代码块用三个反引号包裹,行内代码用单个反引号;
- 链接写作
[文字](URL),图片在前面再加一个!。
要注意 Markdown 并没有唯一标准,不同实现(俗称「方言」)在表格、删除线、任务列表等扩展语法上有差异,最通用的是 CommonMark 和 GitHub Flavored Markdown(GFM)。常见误区:段落之间要空一行才会分段,行末想强制换行需加两个空格或写 <br>;此外 Markdown 允许直接内嵌 HTML,但多数平台出于安全会过滤掉脚本等标签。
常见问题
Markdown 和 HTML 有什么区别,该用哪个?
Markdown 是一层简写语法,最终仍要转成 HTML 才能显示,写起来更快、更适合专注内容。当需要精细控制样式或复杂布局时,可以在 Markdown 里直接嵌入 HTML,或干脆改用 HTML。
为什么我敲了回车换行却没生效?
在 Markdown 里,单个回车通常被当成同一段落的续行。想分成两段就空一行;只想换行不分段,则在行尾加两个空格,或使用 br 换行标签(GFM 也支持行末回车直接换行)。
CommonMark 和 GitHub Flavored Markdown 是什么关系?
CommonMark 是对原始 Markdown 的严格规范化标准,消除了早期实现的歧义;GFM 在它基础上增加了表格、任务列表、删除线、自动链接等扩展。写跨平台文档时,尽量只用两者共有的语法最稳妥。