Markdown 写作教程¶
欢迎来到 Markdown 从零到上手 中文教程！
Markdown（简称 md）是一种 纯文本排版格式：你用几个简单符号写内容，它就能被渲染成带标题、列表、表格、代码块的网页、PDF 或文档。读起来还是干净的纯文本，渲染出来却是排好版的文章。
这套教程讲什么¶
| 部分 | 内容 | 适合谁 |
|---|---|---|
| 第一部分 · 入门 | Markdown 是什么、怎么选编辑器、怎么实时预览 | 完全没接触过 |
| 第二部分 · 基础语法 | 标题、段落、列表、链接、图片、引用、代码、表格 | 想快速写东西 |
| 第三部分 · 进阶技巧 | 折叠块、脚注、Emoji、HTML 混排、常见坑、中文排版规范 | 想写得规范好看 |
| 第四部分 · 实战 | 用 MkDocs 搭文档站、写 GitHub README | 想应用到项目 |
最后有一页 🧪 Markdown 在线练习场（左边写、右边实时预览，不用装任何软件）和一页 📋 Markdown 速查表（可以当公式表随时查）。
为什么要学 Markdown¶
- 到处都在用：GitHub / Gitee 的 README、Issue、Pull Request；语雀、飞书、Obsidian、Notion；各大博客平台；AI 对话的回答格式。
- 不用鼠标排版：手不离键盘，写完就是排好版的。
- 纯文本、永不跑版：任何设备打开都是纯文本，不依赖 Word 那种复杂格式。
- 好版本管理：配合 Git 可以清楚看到「哪一行改了什么」，Word 二进制文件做不到。
⚠️ 提示：Markdown 是「轻量」排版，做不了复杂排版（多栏、精细排版、复杂表格布局）。需要那种效果时，用 Word / LaTeX / 排版工具。
与本站其它文档的关系¶
- ☕ Java 入门到 Forge 模组开发：学编程
- 🔨 Forge 开发文档：学模组开发
- 📦 KubeJS 中文文档：不写 Java 也能做内容
本教程讲的 Markdown，是 写这些文档、写项目说明、写笔记 的基础工具——本站四个文档站的源文件，全都是 Markdown 写的。
学习建议¶
- 边看边敲：打开任意一个 Markdown 编辑器（见 02 编辑器与预览工具），跟着例子自己写一遍。
- 不要背语法：常用符号就十来个，忘了就查 速查表。
- 先求能写，再求好看：语法对了就够，排版风格慢慢养成。
- 每章末尾有练习，动手做完再往下走。