.md · text/markdown

Markdown: Markdown 与 GitHub Flavored Markdown

Markdown (CommonMark / GFM) 使用极简纯文本符号表示标题、列表、链接、围栏代码块与表格,对人类阅读和 LLM 理解同样友好。

快速解答: Markdown (CommonMark / GFM) 使用极简纯文本符号表示标题、列表、链接、围栏代码块与表格,对人类阅读和 LLM 理解同样友好。 AI/RAG 知识库、技术文档、README 说明、Obsidian 双链笔记库以及轻量级写作。

结构类型标记语言
人类可读性高
支持嵌套支持
LLM Token 效率高
文件扩展名.md
MIME 类型text/markdown
适用场景AI/RAG 知识库、技术文档、README 说明、Obsidian 双链笔记库以及轻量级写作。

核心优势

  • 保留完整语义标题与表格结构,且比 HTML 节省约 70% Token
  • 已成为 RAG 文档切分、大模型提示词与工程文档的事实标准
  • 可无损转换为净化 HTML、排版 PDF 或纯净纯文本

局限与权衡

  • 原生不包含分页控制、CSS 精确布局或打印样式规范
  • 不同方言(CommonMark、GFM、Obsidian)对表格和扩展语法处理有别
  • 直接复制到 Word 或邮件中时,裸露的 ** 和 ## 符号会显得杂乱

参考资料

本地转换与清理 Markdown

相关工程指南

Markdown 常见问题

为什么 Markdown 是 RAG 与大模型管线的首选格式?

Markdown 保留了 # 标题层级、列表与表格边界,能让向量切分更精准,同时避开了冗长 HTML/XML 标签带来的上下文 Token 浪费。

如何把 ChatGPT 或 Claude 的回复粘贴到 Word 且不带星号?

可使用 Markdown 转 HTML 并点击“复制富文本”,或用“去除 AI Markdown”工具干净剥离格式符号。

GFM 在基础 CommonMark 上扩展了哪些常用语法?

GitHub Flavored Markdown 新增了管道表格、任务复选框 (- [x])、删除线 (~~text~~) 及自动链接识别。