Markdown

Markdown 是一种轻量级标记语言，使用简洁的语法来格式化文本。相比 HTML，Markdown 更专注于内容本身，语法简单易学，适合用于笔记、文档、博客等场景。

提示

Markdown 的核心是"内容与格式分离"：用纯文本的轻量标记表达结构，渲染交给工具，写作者只专注内容。

语法体系

文本格式 是正文排版的核心骨架：标题用井号定层级、文字属性（加粗、斜体、高亮、上下标）做强调、引用与列表组织内容、分隔线切分段落——写任何文档都离不开这些基础语法。

表格与代码 是技术文档的两大主力：表格用 | 分列承载结构化对比数据，代码块用围栏标注语言获得语法高亮，行内代码引用命令与变量名。

链接与图片 负责内容之间的引用：外部超链接指向资源、内部跳转在文档内导航、自动链接直接书写 URL、图片嵌入可视化内容——让文档从"一篇文章"变成"一张网"。

适用场景

场景	推荐用法	原因
技术文档	标题 + 代码块 + 表格	结构清晰，便于阅读
博客文章	标题 + 列表 + 图片	排版简洁，专注内容
README 文件	标题 + 列表 + 代码块 + 链接	GitHub/GitLab 原生支持
笔记系统	标题 + 列表 + 双链	Obsidian/Logseq 等工具支持

FAQ

Q: Markdown 和 HTML 有什么区别？ A: Markdown 是轻量级标记语言，语法简洁（# 标题、**加粗**），专注于内容本身；HTML 是完整的网页标记语言，标签丰富但冗长。Markdown 适合写文档和笔记，HTML 适合构建网页。Markdown 可以嵌入 HTML 标签（如下划线 <u>），但反过来不行。

Q: Typora 和 VS Code 写 Markdown 有什么区别？ A: Typora 是所见即所得编辑器，写完立即看到渲染效果，适合专注写作；VS Code 需要安装 Markdown Preview 插件，分屏预览，适合写代码时顺带写文档。Typora 付费，VS Code 免费。

Q: 代码块的语言标签有什么用？ A: 语言标签（如 ```java、```python）告诉渲染器使用哪种语法高亮规则。没有语言标签的代码块不会高亮，可读性差。Obsidian、GitHub、Typora 等工具都支持语法高亮。

跳出 Markdown 本身看：Mermaid 用同样的"文本即图表"思路把图表变成可版本管理的代码；Git 让 Markdown 文档的每次变更都可追踪；效率工具 家族共享同一理念——用纯文本表达，用工具渲染。