2026-08-21 20:15:41
Markdown语法教程
本教程按「基础知识介绍 + 举例」的方式编写。举例部分分为「写法」和「渲染效果」： 写法用代码块展示源码，防止被编译 ；渲染效果展示编译后的样子，方便对照学习。 一、标题与段落 1. 六个级别的标题 的数量决定标题层级，从一级到六级 ： 你的标题 为一级标题； 你的标题 为二级标题，以此类推，最多支持六级。 例如（写法）： 渲染效果：略 2. 段落与换行 普通回车不会换行 ：上一段和下一段之间必须空一行，才会被渲染成两个独立段落。 想在同一段内强制换行 ，在行尾加两个空格，或者直接使用 标签。 例如（写法，行尾两个空格）： 渲染效果： 这是第一行，行尾加了两个空格 这是第二行，仍在同一段内 例如（写法， 标签）： 渲染效果： 这是第一行 这是第二行 例如（写法，空行分段）： 渲染效果： 这是第一个段落。 这是第二个段落。 二、文本强调 1. 粗体 用两个星号或两个下划线包裹文字 ： 文字 或 文字 。 写法： 这是粗体 ，渲染效果： 这是粗体 。 2. 斜体 用一个星号或一个下划线包裹文字 ： 文字 或 文字 。 写法： 这是斜体 ，渲染效果： 这是斜体 。 3. 粗斜体 用三个星号包裹文字 ： 文字 。 写法： 这是粗斜体 ，渲染效果： 这是粗斜体 。 4. 删除线 用两个波浪号包裹文字 ： 文字 。 写法： 这是删除线 ，渲染效果： 这是删除线 。 三、列表 1. 无序列表 行首用 、 或 + 加一个空格 ，即可创建无序列表。 例如（写法）： 渲染效果： 苹果 香蕉 橙子 2. 有序列表 行首用「数字 + 点 + 空格」 ： 1. 内容 ，数字会自动递增。 例如（写法）： 渲染效果： 1. 第一步 2. 第二步 3. 第三步 3. 嵌套列表 子项在父项下缩进两个或四个空格 ，即可实现嵌套。 例如（写法）： 渲染效果： 前端 HTML CSS Flexbox Grid 后端 4. 任务列表 用 表示未完成， x 表示已完成 。 例如（写法）： 渲染效果： x 学习标题语法 x 学习列表语法 学习表格语法 四、引用 1. 基本引用 行首加 加一个空格 ，即可创建引用块。 具体例子：写读书笔记时，引用书中的一段话—— 例如（写法）： 渲染效果： 读书不是为了雄辩和驳斥，也不是为了轻信和盲从，而是为了权衡和思考。 —— 弗朗西斯·培根 再如：在项目文档中插入一条注意事项—— 例如（写法）： 渲染效果： 注意：上线前必须完成数据库备份，否则无法回滚。 2. 嵌套引用 连续使用多个 即可嵌套 ，常用于「对话层层引用」或「在引用中补充说明」。注意：内层引用前要用单独的 空一行，结构才清晰。 具体例子：记录一次技术讨论，小李引用小张的发言—— 例如（写法）： 渲染效果： 小张：这个接口建议用异步实现。 小李：同意，同步会阻塞主线程。 结论：采用异步方案，下周一前提交代码。 五、代码 1. 行内代码 用单个反引号包裹 ： 代码 。 例如（写法）： 渲染效果： 在 Python 中用 print "Hello" 输出内容。 2. 代码块 用三个反引号包裹多行代码，并在开头标注语言名 ，即可实现语法高亮。 例如（写法，外层四个反引号是为了展示内层三个反引号，写作时只需三个）： python def greet name : return f"你好，{name}！" print greet "Markdown" 渲染效果： 常用语言标注： | 标注 | 对应语言 | | : : | : : | | c | C 语言 | | cpp / c++ | C++ | | csharp / cs | C | | python / py | Python | | javascript / js | JavaScript | | typescript / ts | TypeScript | | java | Java | | go | Go | | rust | Rust | | bash / sh / shell | Shell 脚本 | | sql | SQL 数据库 | | html / css | 网页标记 / 样式 | | json / yaml | 数据与配置格式 | | text / txt | 纯文本（无高亮） | 六、链接与图片 1. 链接 写法为 链接文字 网址 ，网址后可以加空格和标题（鼠标悬停时显示）。 写法： GitHub https://github.com ，渲染效果： GitHub https://github.com 。 写法： 带标题的链接 https://github.com "访问 GitHub" ，渲染效果： 带标题的链接 https://github.com "访问 GitHub" 。 2. 图片 比链接多一个感叹号 ： ! 替代文字 图片地址 ，方括号里写图片加载失败时显示的替代文字。 例如（写法）： 渲染效果： ! 示例图片 https://bu.dusays.com/2026/08/20/6a867d08f1815.jpg 七、表格 1. 基本表格 用 | 分隔单元格，第二行用 分隔表头与表体 。 例如（写法）： 渲染效果： | 语法 | 作用 | | | | | | 标题 | | | 粗体 | 2. 对齐方式 冒号控制对齐 ： : 左对齐、 : : 居中、 : 右对齐。 例如（写法）： 渲染效果： | 左对齐 | 居中 | 右对齐 | | : | : : | : | | 内容A | 内容B | 内容C | 八、分隔线 三个或以上的 、 或 单独占一行 ，即可创建分隔线。 例如（写法）： 渲染效果： 九、转义与 HTML 兜底 1. 转义 在特殊符号前加反斜杠 \ ，即可让符号原样显示，如 \ 、 \ 、 \ 。 写法： \ 这不是斜体\ ，渲染效果：\ 这不是斜体\ 。 2. HTML 兜底 Markdown 支持直接嵌入 HTML ，排版不够用时可以用 HTML 标签兜底。 例如（写法）： 渲染效果： Ctrl + S 保存文件 十、总结 | 类别 | 关键符号 | | : | : | | 标题 | | | 强调 | 、 、 | | 列表 | 、 1. 、 | | 引用 | | | 代码 | 反引号 | | 链接 / 图片 | 文字 网址 、 ! 文字 地址 | | 表格 | \| 和 | | 分隔线 | | 十一、Obsidian 特有写法 Obsidian 兼容标准 Markdown，并扩展了以下常用语法。Mermaid、公式等为 Obsidian 内置能力，无需额外插件。 以下「渲染效果」为 Obsidian 中的显示样式模拟与实际存在差异。 1. 双链（笔记间链接） 用双中括号包裹笔记名 ： 笔记名 ，点击即可跳转到对应笔记，且自动生成反向链接（Obsidian 的核心特性）。 例如（写法）： 渲染效果（Obsidian 中为紫色可点击链接）： 读书笔记 （点击跳转，自动生成反向链接） 我的读书笔记 （显示自定义文字） 读书笔记 › 第二章 （定位到指定标题） 2. 嵌入与附件 在双链前加感叹号即可嵌入 ：笔记、标题、图片、PDF 都能直接嵌进当前页面。 例如（写法）： 渲染效果（Obsidian 中直接显示内容，图片会就地预览）： 封面图.png （图片直接显示在此处） 3. 标签 行内写 标签 ，支持层级 ： 学习 、 项目/前端 。 例如（写法）： 渲染效果（Obsidian 中显示为紫色标签）：略 4. 属性（Frontmatter） 文档开头用一对 包裹元数据 ，定义标签、别名、日期等，Obsidian 属性面板可直接编辑。 例如（写法）： 渲染效果（Obsidian 以属性面板展示，可直接编辑）： title 我的笔记 tags 学习 aliases 别名A、别名B created 2026 08 20 5. 提示框（Callout） 引用块配合 !类型 ，类型前必须有感叹号，后面可自定义标题。 例如（写法）： 渲染效果（Obsidian 中为彩色提示框）： 小提示 记得每天备份！ 警告 该操作不可撤销！ 常用类型： note 、 info 、 tip 、 success 、 question 、 warning 、 danger 、 quote 。 6. 图表与公式 代码块标注 mermaid 可画流程图、时序图、甘特图等 ； 数学公式用 $ （行内）或 $$ （块级）包裹 。 例如（写法）： mermaid graph LR A 开始 B{判断} B |是| C 完成 B |否| A 渲染效果（Obsidian 中显示为流程图）： 开始 → {判断} → 完成 ↳ 否 → 回到 开始 例如（写法）： 渲染效果： 行内公式：E = mc 2 （按数学公式样式显示） 块级公式：∫₀¹ x² dx = ⅓ （独立成块显示） 7. 其他实用扩展 高亮： ==重要内容== → 渲染效果： 重要内容 注释： %%这里是注释%% → 渲染效果：阅读模式下完全不可见（仅编辑时显示） 脚注：正文写 文字 ^1 ，文末写 ^1 : 脚注内容 → 渲染效果：文字 1 1 脚注内容 兼容性提示：双链、标签、Callout 等是 Obsidian 专属语法，粘贴到 GitHub、微信公众号等平台不会按预期渲染，投稿前需转换。
