Obsidian 语法全览

这篇文章既是说明文档，也是渲染测试。你在 Obsidian 里怎么写，这里就怎么显示。 #示例

基础格式#

粗体、斜体、粗斜体、删除线、高亮文本、行内代码，以及 下划线、Ctrl + K、H₂O、E = mc²。

高亮里也可以嵌套格式：这是 加粗的 高亮。行内注释 也会被移除。

中文标点紧挨着格式符号也没问题：加粗（带括号）紧跟文字、斜体“引号”、删除（线）都能正确渲染。

单个换行会被保留（Obsidian 默认行为），
就像这一行。

普通引用块。
—— 某位智者

双向链接#

• 链接到其它笔记：卡片盒笔记法
• 使用别名：Zettelkasten
• 链接到标题：卡片盒笔记法 › 核心原则
• 链接到块：卡片盒笔记法 › ^atomic
• 链接到本文的标题：数学公式
• 通过别名找到笔记：写作指南
• 还没写的笔记会显示为虚线：一篇还不存在的笔记
• 普通 Markdown 链接也能指向笔记：理解事件循环
• 外部链接：Anthropic

嵌入#

嵌入整篇笔记的某个章节#

卡片盒笔记法 › 核心原则

嵌入一个块#

卡片盒笔记法 › ^atomic

嵌入图片（支持尺寸）#

标准 Markdown 图片同样支持尺寸与图注：

Callouts#

列表与任务#

1. 有序列表
2. 第二项
   • 嵌套无序列表
   • 另一项
     1. 更深一层

• 未完成
• 已完成
• 进行中
• 已取消
• 已推迟
• 已排期
• 有疑问
• 重要
• 星标
• 引用
• 信息
• 灵感
• 书签
• 优点
• 缺点

表格#

代码#

代码块首行的参数与 Obsidian 插件 Codeblock Customizer 一致：file: 标题、ln: 行号、hl: 行高亮、hlt: 文本高亮、info: / warn: / error: 等自定义颜色、fold 默认折叠。

export function greet(name: string): string {
  const time = new Date().getHours();
  const word = time < 12 ? '早上好' : '你好';
  return `${word}，${name}！`;
}

def fib(n: int) -> int:
    a, b = 0, 1
    for _ in range(n):
        a, b = b, a + b
    return a

async function fetchWithRetry(url, times = 3) {
  for (let i = 0; i < times; i++) {
    try {
      return await fetch(url);
    } catch (err) {
      console.warn(`第 ${i + 1} 次请求失败`, err);
    }
  }
  throw new Error('重试次数已用完');
}

- const theme = 'light';
+ const theme = prefersDark ? 'dark' : 'light';

数学公式#

行内公式 $e^{i\pi} + 1 = 0$，以及块级公式：

Mermaid 图表#

flowchart LR
    A[在 Obsidian 写作] --> B{git push}
    B --> C[GitHub Actions 构建]
    C --> D[(静态站点)]
    D --> E[读者]

sequenceDiagram
    participant 读者
    participant 博客
    读者->>博客: 打开文章
    博客-->>读者: 渲染好的 HTML
    读者->>博客: 搜索“事件循环”
    博客-->>读者: 全文匹配结果

脚注#

这里有一个普通脚注¹，还有一个行内脚注²。

标签#

行内标签： #obsidian #写作/技巧 #博客 。标签前需要有空格（与 Obsidian 规则一致），嵌套标签会同时计入父标签。

块引用#

这一段有一个块 ID，可以被其它笔记精确引用。

嵌入搜索结果#

HTML 与其它#

上面这些就是全部了。去 写作与发布指南 看看如何开始写作吧。