appendix · 附录

语法速查卡

标准 Markdown、Obsidian 扩展语法、Dataview 查询模板、Templater 常用函数,一张卡记住所有写法。

语法速查卡

语法是笔记的字母表。Obsidian 以 CommonMark 为底座,又在其上铺了一层自家扩展,再叠加 Dataview、Templater 这类插件的查询与模板语法,构成一套相当丰富的写作工具链。下面这张卡,把四类语法压成一页,写的时候随时翻。

一、标准 Markdown

写法效果
# 标题 / ## 二级 / ### 三级一/二/三级标题
**加粗**加粗
*斜体*斜体
~~删除线~~删除线
[文字](https://obsidian.md)外部链接
![图片](cover.png)嵌入图片
`行内代码`行内代码
```代码块```多行代码块
> 引用引用块
- 项目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/DESCGROUP 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 那两节——它们会在你需要的那个瞬间,显得格外好用。