AI 时代的 Markdown 入门教程

一份笔记，起初可能只在自己的电脑上写。过几天要放进项目仓库，想请 AI 帮忙检查，最后还得发布成网页，或者导出给别人。一路换工具，正文总不能每次都重写。

Markdown 适合做这份内容底稿。不过，语法能不能正常显示、图片会不会丢，还得看用的是什么工具。这门课就从写好一份文档开始，一路讲到兼容性、工具选择和格式交付。

学习目标

学完后，你应该能自己写出一份有标题、列表、链接、图片和代码的 README.md，并且知道怎么预览、检查它。

需要表格或其他扩展写法时，能按需求使用；换了工具，知道去核对显示效果。

最后，也能判断什么时候用 Markdown 合适，什么时候该换富文本或排版工具，并检查导出文件的结构、样式和图片等资源。

学习方式

顺着章节读就行。

• 前 3 章先弄清 Markdown 用在哪儿，以及怎样与 AI 协作；
• 第 4、5 章动手写文档；
• 第 6、7 章处理语法差异、挑合适的工具；
• 最后用第 8 章练习格式转换。

从第 4 章开始，最好把示例存成自己的 .md 文件。每学一种写法，就打开预览看看效果。用到 AI、网站发布或 Pandoc 时，再装需要的工具，并检查实际生成的文件。

章节导航

1. Markdown 的学习价值：什么时候用 Markdown，它能帮我们省下哪些麻烦。
2. Markdown 的流行原因：纯文本、跨平台和 Git 协作，为什么适合长期维护文档。
3. Markdown 与 AI 协作：把任务和修改范围说清楚，也看懂 AI 给出的结果。
4. Markdown 核心语法：边写边预览，完成一份 README.md。
5. Markdown 扩展语法：给网站开发计划加上表格、任务列表和流程图。
6. Markdown 语法差异：分清 CommonMark、GFM 和工具扩展，迁移后检查显示效果。
7. Markdown 工具选型：按编辑、协作和发布的需要搭配工具。
8. Markdown 格式转换：把同一份内容转成不同格式，再核对交付结果。

详细目录

1. Markdown 的学习价值
   1.1 富文本与文档结构
   1.2 文档复用与处理
   1.3 应用场景
   1.4 适用边界
   1.5 结构优先
   1.6 本章小结

2. Markdown 的流行原因
   2.1 纯文本
   2.2 语法简洁
   2.3 内容与样式分离
   2.4 跨平台
   2.5 Git 协作
   2.6 长期维护
   2.7 本章小结

3. Markdown 与 AI 协作
   3.1 AI 输入的结构
   3.2 AI 输出与内容复用
   3.3 提示词组织
   3.4 人机协作与修改边界
   3.5 自动化与 Agent 协作
   3.6 适用边界与工作流程
   3.7 本章小结

4. Markdown 核心语法
   4.1 标题
   4.2 段落与换行
   4.3 强调
   4.4 列表
   4.5 链接
   4.6 图片
   4.7 引用
   4.8 代码
   4.9 分隔线
   4.10 综合示例
   4.11 写作规范
   4.12 小结

5. Markdown 扩展语法
   5.1 扩展边界
   5.2 表格
   5.3 任务列表
   5.4 删除线
   5.5 数学公式
   5.6 Mermaid
   5.7 HTML
   5.8 兼容性
   5.9 网站开发计划
   5.10 选用原则
   5.11 小结

6. Markdown 语法差异
   6.1 差异来源
   6.2 CommonMark
   6.3 GFM
   6.4 工具扩展
   6.5 兼容性核验
   6.6 迁移策略
   6.7 本章小结

7. Markdown 工具选型
   7.1 支持层级
   7.2 开发工具
   7.3 写作与知识库
   7.4 GitHub
   7.5 VitePress
   7.6 AI 工具
   7.7 工具对照
   7.8 工具组合
   7.9 小结

8. Markdown 格式转换
   8.1 Markdown 内容源
   8.2 常见格式
   8.3 Pandoc 命令
   8.4 转换质量
   8.5 多格式交付
   8.6 小结