Obsidian 语法记载

这篇笔记用来保存 Obsidian 里最常用、也最容易忘的 Markdown 写法。以后遇到新的格式、插件语法或好用的写作模板,可以继续往这里追加。

[!tip] 使用原则 普通结构先用 Markdown,知识之间的关系用 [[双链]],需要强调的提醒用 callout,长期可复用的信息放进属性区。

基础结构

# 一级标题
## 二级标题
### 三级标题

普通段落直接书写。

**加粗**
*斜体*
==高亮==
~~删除线~~

列表与任务

- 无序列表
- 继续一项
  - 子项目

1. 有序列表
2. 第二项

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

适合用来记录步骤、清单、待办和复盘事项。

内部链接

[[笔记名称]]
[[笔记名称|显示文字]]
[[笔记名称#标题]]
[[#当前笔记里的标题]]

常见用法:

  • 关联另一篇笔记:[[SDA_BLOG_项目复盘与常用指令]]
  • 给同一概念建立别名:[[Obsidian 语法记载|语法速查]]
  • 跳转到某个小节:[[Obsidian 语法记载#Callout 提醒块]]

嵌入内容

![[另一篇笔记]]
![[图片.png]]
![[图片.png|300]]
![[文档.pdf#page=2]]

嵌入适合把已有材料直接放进当前笔记里,尤其适合项目复盘、截图证据、参考资料汇总。

Callout 提醒块

> [!note]
> 普通说明。

> [!tip] 小技巧
> 可以写一个自定义标题。

> [!warning]
> 这里放风险、限制或容易踩坑的地方。

> [!faq]- 默认折叠
> 折叠内容适合放不常看的解释。

常用类型:

类型用途
note普通说明
tip技巧
info补充信息
warning注意事项
question问题
todo待办
example示例
quote引用

属性区

属性区写在文件开头,用三条短横线包住。

---
title: 笔记标题
date: 2026-05-27
tags:
  - obsidian
  - markdown
aliases:
  - 别名
status: draft
---

建议常用属性:

属性说明
title笔记标题
date创建或记录日期
tags标签,方便检索
aliases别名,方便双链识别
status状态,例如 draftactiveevergreen

标签

#语法
#obsidian/markdown
#项目/复盘

标签适合分类,双链适合连接概念。不要把所有关系都塞进标签里,否则后期会很难整理。

代码块

```powershell
Get-ChildItem
```

```javascript
console.log("Hello Obsidian");
```

记录命令、配置、报错和代码片段时,用代码块最清楚。

表格

| 名称 | 用途 |
| --- | --- |
| 双链 | 连接笔记 |
| 标签 | 分类检索 |
| Callout | 强调提示 |

表格适合放对照、清单、参数和速查项。

脚注

这里有一个脚注[^1]。

[^1]: 脚注内容写在文末或段落后。

适合在文章里补充解释,又不打断正文节奏。

数学公式

行内公式:$a^2 + b^2 = c^2$

块级公式:
$$
E = mc^2
$$

Mermaid 图

```mermaid
graph TD
  A[输入] --> B[整理]
  B --> C[输出笔记]
```

适合记录流程、关系图和系统结构。

隐藏注释

正文会显示,%%这里不会在阅读视图显示%%。

%%
这一整段都是隐藏注释。
%%

隐藏注释适合放写作提醒、暂存想法、未决定内容。

我的记录模板

---
title: 
date: 2026-05-27
tags:
  - 
aliases:
  - 
status: draft
---

# 标题

> [!note] 主题
> 这篇笔记要解决什么问题?

## 背景

## 关键内容

## 示例

## 相关链接

- [[]]

维护规则

  • 新语法先写最小可用示例。
  • 遇到真实使用场景,再补一句“适合用来做什么”。
  • 同类语法放在同一小节,避免越记越散。
  • 重要概念尽量加 [[双链]],让笔记之间能长出关系。