Markdown 教程
本电子书内容整理自 CommonMark 规范、GitHub Flavored Markdown 与 Markdown Guide,遵循开源 CC BY-SA 4.0 协议。
Markdown 是一种轻量级标记语言,用纯文本即可写出带格式(标题、列表、表格、代码、链接、图片等)的文档。它的设计理念是:易读、易写、纯文本、可移植。
为什么学习 Markdown
- 语法简洁:只有少量符号(
#、*、>、-、|等),学习曲线平缓 - 纯文本:用任意编辑器即可编写,无锁定到特定工具
- 跨平台:GitHub、博客、Wiki、文档站点(Hugo / Jekyll / VuePress)、笔记(Obsidian / Notion)等普遍支持
- 可版本控制:纯文本天然适配 Git,方便团队协作
- 可扩展:GFM、CommonMark 等方言在标准之上扩展表格、任务列表、删除线等
- 可导出:可一键转为 HTML、PDF、Word、EPUB 等
适用场景
技术文档(README、API 文档)、博客写作、笔记、电子书、论坛回复、Slack/飞书消息、静态站点生成器内容源等。
本书章节
- 简介与发展史
- 标题、段落与分隔线
- 文本强调(粗体、斜体、删除线、高亮)
- 列表与任务列表
- 链接、图片与脚注
- 代码(行内与代码块、语法高亮)
- 引用、表格与定义列表
- 转义字符、HTML 与表情
- 进阶(锚点、目录、提示框、数学公式)
- 最佳实践与工具链
准确性说明
本电子书力求忠实于 CommonMark 0.30 规范与 GFM 0.29 规范;如对渲染细节有歧义,以 CommonMark 规范 与 GFM 规范 为准。每个语法标识均附源码示例与渲染效果说明,可在任意支持 Markdown 的编辑器或站点直接验证。