首页 / 渲染指南

渲染指南

更新于 2026-10-08

预览里的排版全部在本机完成:解析在 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]。