MD (Markdown) 语法详细教程 obsidian 社区转载

从“纯文本”到“结构化笔记”的底层逻辑补全

很多技术学习者在使用 Obsidian 时，仅仅把它当作一个支持富文本的记事本。这种使用方式不仅没有发挥出双向链接和图谱的优势，反而因为格式混乱导致知识库难以维护。本课程旨在填补“Markdown 基础语法”与“知识库高效管理”之间的能力缺口。它不教你如何美化样式，而是专注于如何通过语法构建清晰的文档层级，这是进行知识管理和二次创作的基石。

你需要补齐的核心能力

本课程将重点解决以下三个能力缺口：

• 层级构建能力：熟练掌握标题（H1-H6）与列表（有序/无序/任务列表）的嵌套逻辑，避免笔记变成“文字墙”。
• 内容标记能力：精准区分强调、引用、删除线等语义标记，提升信息的可读性和表达精准度。
• 链接与引用能力：掌握行内代码与代码块的语法，以及如何通过 Markdown 语法规范地引用外部文档或内部笔记。

配套练习建议

看完课程后，请务必通过以下练习验证掌握程度：

• 语法重构：找一篇自己以前写过的纯文本笔记，尝试将其转换为结构清晰的 Markdown 格式。
• 链接实验：在 Obsidian 中新建一篇笔记，使用 Markdown 语法引用另一篇笔记，并测试跳转效果。
• 列表实战：使用任务列表语法（- [ ]）创建一个待办事项清单，体验 Obsidian 对任务状态的支持。

看完应能回答的问题

通过学习，你应该能够自信地回答：

• 如何使用 Markdown 语法快速生成文档大纲（目录）？
• 在 Obsidian 中，如何通过语法标记代码片段并保证其格式不被破坏？
• 为什么说 Markdown 是一种“结构化而非格式化”的标记语言？