Obsidian Markdown 基础（四）

4.Markdown 基础

推荐阅读：1.Markdown

Markdown 是 Obsidian 的底层书写语言，用纯文本符号表达格式，让你专注于内容而非排版。

一、标题（#）

  • 16 个 # 对应 H1H6
  • Obsidian 扩展作用：大纲面板自动生成目录；可通过 [[笔记名#标题]] 直接链接到某个标题位置
  • 建议：正文从二级标题开始，一级标题留给笔记大标题

二、文本格式化

样式 语法 渲染效果（示例）
粗体 ​**粗体** 粗体
斜体 ​*斜体* 斜体
粗斜体 ​***粗斜体*** 粗斜体
删除线 ​~~删除线~~ 删除线
高亮 ​==高亮== ==高亮==（Obsidian 扩展）

三、引用与 Callout

  • 普通引用：> 引用内容，可嵌套其他 Markdown 语法

  • Callout 提示框（Obsidian 扩展）：

    > [!note] 提示标题
> 提示内容

> [!warning] 注意
> 警告内容

> [!tip] 技巧
> 小贴士

    支持多种类型：note​、warning​、tip​、important​、caution 等。

四、列表与任务清单

1.无序列表

- 项目1
    - 子项目（缩进）
* 项目2
+ 项目3

2.有序列表

1. 第一项
2. 第二项
    1. 子项（缩进）

3.任务清单（最常用）

- [ ] 未完成任务
- [x] 已完成任务

在 Obsidian 中可直接点击复选框切换状态。

五、代码与代码块

  • 行内代码：`code` → code
  • 代码块：```语言 … ```，支持语法高亮（Python、JS、Go 等数十种）

六、表格

| 左对齐 | 居中对齐 | 右对齐 |
|:------|:-------:|------:|
| 内容   |   内容  |   内容 |

不支持合并单元格，复杂表格可用 HTML <table>。

七、图片与链接

1.超链接

[显示文本](https://example.com "可选标题")

2.图片

![替代文本](图片URL)

# Obsidian 扩展：控制显示宽度（px）
![架构图|300](attachments/arch.png)

支持直接粘贴图片到 Obsidian，自动复制到附件文件夹并插入引用。

3.Obsidian 专属：内部链接

[[笔记名]]              # 链接到另一篇笔记
[[笔记名#标题]]          # 链接到笔记内的某个标题
[[笔记名|别名]]          # 显示为自定义别名

八、分隔线

三个或更多 --- ​独占一行。

注意：文档最顶部的 ---​ … --- 是 YAML Front Matter，不是分隔线。

九、YAML Front Matter（元数据）

写在笔记最顶部，用两组 --- 包裹，定义笔记属性：


title: "Obsidian 学习笔记"
tags: [obsidian, markdown, 笔记工具]
aliases: [Obsidian入门, 第二大脑教程]
created: 2026-05-21
status: 进行中

常用字段：

字段 类型 说明
​tags 字符串/数组 标签，如 Code/Python
​aliases 字符串/数组 别名，其他笔记可通过别名链接
​created 日期 创建日期
​updated 日期 更新日期
​status 字符串 草稿/进行中/已完成

核心价值：配合 Dataview 插件实现笔记的数据库式查询。

语法速查表

元素 语法 记忆
标题 ​# H1​ … ###### H6 井号 + 空格
粗体 ​**文字** 双星号
斜体 ​*文字* 单星号
删除线 ​~~文字~~ 双波浪线
高亮 ​==文字== 双等号
行内代码 `code` 反引号
代码块 ```语言 三反引号
引用 ​> 文字 大于号 + 空格
无序列表 ​- 项目 减号 + 空格
任务清单 ​- [ ] 任务 减号 + 空格 + 方括号
链接 ​[文字](url) 方括号 + 圆括号
图片 ​![替代](url) 感叹号 + 链接
内部链接 ​[[笔记名]] 双方括号
表格 ​|列1|列2| 竖线分隔
分隔线 ​--- 三个减号独占一行

一句话总结：掌握标题、列表、代码块、链接/图片、任务清单这 5 类语法，即可顺畅使用 Obsidian；高亮、Callout、YAML Front Matter 和 [[]] 内部链接是 Obsidian 的增强特性，配合 Dataview 插件可发挥最大威力。

‍