语法速查卡
标准 Markdown、Obsidian 扩展语法、Dataview 查询模板、Templater 常用函数,一张卡记住所有写法。
语法速查卡
语法是笔记的字母表。Obsidian 以 CommonMark 为底座,又在其上铺了一层自家扩展,再叠加 Dataview、Templater 这类插件的查询与模板语法,构成一套相当丰富的写作工具链。下面这张卡,把四类语法压成一页,写的时候随时翻。
一、标准 Markdown
| 写法 | 效果 |
|---|---|
# 标题 / ## 二级 / ### 三级 | 一/二/三级标题 |
**加粗** | 加粗 |
*斜体* | 斜体 |
~~删除线~~ | |
[文字](https://obsidian.md) | 外部链接 |
 | 嵌入图片 |
`行内代码` | 行内代码 |
```代码块``` | 多行代码块 |
> 引用 | 引用块 |
- 项目 或 1. 项目 | 无序 / 有序列表 |
--- | 水平分割线 |
| 表头 | 表头 | | 表格 |
二、Obsidian 扩展语法
| 写法 | 作用 |
|---|---|
[[笔记名]] | 双向链接(Wikilink) |
[[笔记名|显示文字]] | 带别名的双链 |
[[笔记名#标题]] | 链接到某标题块 |
[[笔记名^块ID]] | 链接到块引用 |
![[笔记名]] | 嵌入整篇笔记 |
![[图片.png]] | 嵌入图片(比 Markdown 原生更灵活) |
![[笔记名#标题]] | 嵌入某段标题下的内容 |
==高亮== | 黄底高亮 |
%%注释%% | 编辑可见、阅读隐藏的注释 |
[^1] … [^1]: 说明 | 脚注 |
#标签 | 行内标签 |
- [ ] / - [x] | 任务列表 |
$E=mc^2$ | 行内数学公式(LaTeX) |
$$...$$ | 块级公式 |
Callout(标注框) 是 Obsidian 的高频武器:
> [!note] 标题
> 这是一条提示。支持 note / tip / warning / danger / info / quote / abstract 等类型。
属性(Frontmatter) 写在笔记最顶部,用 YAML:
---
title: "我的笔记"
tags: [项目, 阅读]
status: 进行中
created: 2026-07-02
---
三、Dataview 查询模板
Dataview 让你像写 SQL 一样查自己的笔记库。三种视图各有侧重。
LIST——列清单:
```sql
LIST
FROM "日记"
WHERE status = "进行中"
SORT file.ctime DESC
```
TABLE——做台账:
```sql
TABLE status, created AS 创建时间
FROM #项目
WHERE status != "已完成"
SORT created DESC
```
TASK——抓任务:
```sql
TASK
FROM "日记"
WHERE !completed
GROUP BY file.link
```
CALENDAR——按月看活跃度:
```sql
CALENDAR file.ctime
FROM "日记"
```
常用筛选关键词:FROM "文件夹"、FROM #标签、WHERE 属性 = "值"、SORT 字段 ASC/DESC、GROUP BY 字段、LIMIT 10。
四、Templater 常用函数
Templater 用 <% ... %> 包裹函数,模板被调用时即时求值。
| 函数 | 作用 |
|---|---|
<% tp.date.now("YYYY-MM-DD") %> | 今天日期 |
<% tp.date.now("YYYY年MM月DD日", 0, "Asia/Shanghai") %> | 指定时区的中文日期 |
<% tp.date.weekday("YYYY-MM-DD", 0) %> | 本周第一天 |
<% tp.date.now("YYYY-MM-DD", -1) %> | 昨天日期(偏移 -1 天) |
<% tp.file.title %> | 当前文件名 |
<% tp.file.creation_date("YYYY-MM-DD HH:mm") %> | 文件创建时间 |
<% tp.file.move("子文件夹/" + tp.file.title) %> | 移动文件到指定目录 |
<% tp.frontmatter.status %> | 读取属性值 |
<% tp.system.prompt("请输入标题") %> | 弹窗输入 |
<% tp.system.suggester(["A","B"], ["a","b"]) %> | 下拉选择 |
<%* tR += "拼接字符串" %> | 执行 JS 并写入模板 |
Templater 的函数库极广,完整 API 见其文档仓库。日常用得最多的就是日期、文件名、属性这三件套——把它们写进日记模板,一篇带时间戳的笔记就能一键生成。
怎么用这张卡
不必全记。先掌握标准 Markdown 和 Obsidian 扩展(双链、嵌入、Callout、属性),这五样足以撑起 90% 的写作。当某天你想”自动列出所有未完成任务”或”模板里自动填上今天日期”,再回来翻 Dataview 和 Templater 那两节——它们会在你需要的那个瞬间,显得格外好用。