渲染指南
预览里的排版全部在本机完成:解析在 Rust 侧完成,着色与公式排版在应用内部按需加载,都不联网,也不采集任何数据。
代码围栏
围栏写了语言,就按该语言着色:
```rust
fn main() { println!("hello"); }
```
- 内置约 50 种语法(Rust、Python、JavaScript / TypeScript、Go、Java、C / C++、C#、PHP、Ruby、SQL、Shell、PowerShell、Dockerfile、YAML、TOML、JSON、INI、Diff、Markdown、LaTeX…),且按需加载:没有代码围栏的文档不会为它付出体积。
- 没随包的语言保持纯文本——不报错、不加徽章、状态栏也不提。别名(
js、ts、yml、c++、sh…)与 Prism 官方一致。 - 围栏写的是图表语言(
mermaid/dot/graphviz/d2)时,这块内容会变成图表卡片,见图表指南。
数学公式
行内 $…$ 与独立成段的 $$…$$ 由 KaTeX 排版,化学式(\ce{})也在内:
| 写法 | 结果 |
|---|---|
$a^2 + b^2 = c^2$ |
行内公式 |
$$ 独占一段 |
居中的公式块 |
$$ 与文字同段 |
按行内排版——居中块夹在句子里会把那句话拆断 |
数学默认是关闭的,在「设置 → 数学公式」里打开。默认关闭的理由很具体:打开之后 $ 就不再是普通字符,而 Revenue rose from $13B to $24B. 应该继续是一句讲钱的话。关闭状态下 $…$ 原样显示。写坏的公式留在原处,带 KaTeX 自己的错误标记,原因在悬停提示里。
脚注
[^1] 在正文里成为编号引用,所有脚注收拢为文末一个区块,每条都带 ↩ 跳回引用它的位置——同一个脚注被引用多次,就有多条回跳(↩、↩2…)。
- 编号按引用出现的顺序,与定义书写的位置无关。
- 没有任何引用指到的定义不会打印;没有定义的引用退回字面
[^1],而不是留一个死链。
表格与任务清单
GFM 表格按内容收窄(列多或内容宽时横向滚动,不会把页面撑破),表头底色与隔行底色跟随主题,对齐方式由 :--- / :---: / ---: 决定。任务清单的复选框不带项目符号,且是只读的——勾选状态回到源码视图里改 [x]。