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 | 状态,例如 draft、active、evergreen |
标签
#语法
#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] 主题
> 这篇笔记要解决什么问题?
## 背景
## 关键内容
## 示例
## 相关链接
- [[]]
维护规则
- 新语法先写最小可用示例。
- 遇到真实使用场景,再补一句“适合用来做什么”。
- 同类语法放在同一小节,避免越记越散。
- 重要概念尽量加
[[双链]],让笔记之间能长出关系。