part-3 · Markdown 与笔记语法

数学公式与图表

LaTeX 行内与块级公式、Mermaid 流程图/时序图/甘特图/饼图/ER 图,外加节点链接笔记

数学公式与图表

笔记不只是文字。当你想表达一个递推关系、画一张状态机,或者推导一道积分题时,纯文字就显得吃力。Obsidian 内置 MathJax 与 Mermaid,让你用几行代码就能写出印刷级的公式和图表——不必装任何插件。

LaTeX 公式:行内与块级

行内公式用一对 $ 包裹:

欧拉公式 $e^{i\pi} + 1 = 0$ 是数学里最美的等式之一。

块级公式用一对 $$,独占一行并居中显示:

$$
\int_{-\infty}^{\infty} e^{-x^2}\,dx = \sqrt{\pi}
$$

常用公式示例

分式与上下标:

$$
\frac{a}{b}, \quad x^2, \quad x_{n+1}
$$

求和与连乘:

$$
\sum_{n=1}^{\infty} \frac{1}{n^2} = \frac{\pi^2}{6}, \quad
\prod_{i=1}^{n} i = n!
$$

积分:

$$
\int_0^1 x^2\,dx = \frac{1}{3}
$$

矩阵(vmatrix 取行列式,bmatrix 取方括号):

$$
\begin{vmatrix}a & b \\ c & d\end{vmatrix} = ad - bc
$$

更详细的语法可参考 MathJax 官方教程。Obsidian 支持的扩展包列表见 help.obsidian.md 的公式章节。

Mermaid 图表

Mermaid 是”用代码画图”的工具,Obsidian 原生支持。把代码放进 mermaid 代码块即可。

流程图

```mermaid
graph TD
    A[开始] --> B{是否完成?}
    B -->|是| C[发布]
    B -->|否| D[继续写]
    D --> B
```

时序图

```mermaid
sequenceDiagram
    participant 用户
    participant 系统
    用户->>系统: 登录请求
    系统-->>用户: 返回令牌
```

甘特图

```mermaid
gantt
    title 教程写作计划
    dateFormat YYYY-MM-DD
    section 第一部分
    写入门篇 :a1, 2026-06-01, 7d
    section 第二部分
    写工作流 :a2, after a1, 7d
```

饼图

```mermaid
pie
    title 时间分配
    "写作" : 40
    "阅读" : 30
    "发呆" : 30
```

ER 图

```mermaid
erDiagram
    笔记 ||--o{ 标签 : 拥有
    笔记 ||--o{ 链接 : 指向
```

更多图类型(类图、状态图、时间线等)参考 Mermaid 官方文档。动手前可以在 Mermaid Live Editor 里调好再贴回来。

让节点链接到 Obsidian 笔记

这是 Mermaid 在 Obsidian 里的隐藏彩蛋。给节点附加 internal-link 类,它就变成可点击的内部链接:

```mermaid
graph TD
    A[三体] --> B[三体二部曲]
    class A,B internal-link;
```

点击节点即跳到对应笔记。节点多时,可以批量赋类:

```mermaid
graph TD
    A[Biology] --> B[Chemistry]
    class A,B,C,D,E,F,G,H,I,J,K,L,M,N,O,P,Q,R,S,T,U,V,W,X,Y,Z internal-link;
```

每个字母节点的文字就成了链接文字。含特殊字符的笔记名要加引号:class "⨳ 特殊" internal-linkA["⨳ 特殊"]

注意:图里的内部链接不会出现在关系图谱中,它们只服务当前笔记内的跳转。

Excalidraw:手绘风的伏笔

公式严谨、Mermaid 工整,但有时候你只想画一个潦草的草图,把脑中那个还不成形的想法随手记下来。Excalidraw 插件提供了手绘风格的白板,能嵌入笔记、能链接到笔记、能与 Mermaid 互转,是科研和产品规划的高频工具。我们留到第五部分插件专题细讲。


公式让思考精确,图表让结构可见。下一篇是本部分的最后一篇,聊聊那些被你拖进 Vault 的图片、PDF、音频该怎么管。