mdBook 原生功能

本页用于确认当前 Homepage 只使用 mdBook 原生能力，不依赖第三方插件。

Note

admonition 已由 mdBook 原生 Markdown 支持启用。

Tip

搜索、打印、主题切换、章节折叠、键盘快捷键和 Rust playground 均由 mdBook HTML renderer 提供。

原生配置

HTML renderer

生成可搜索、可打印、可切换主题的静态页面。

Markdown renderer

同步生成经过内置 preprocessors 处理后的 Markdown 输出，便于后续归档或复用。

links preprocessor

处理 include、rustdoc_include 和 playground 等内置模板。

index preprocessor

将章节中的 README.md 作为目录索引页面处理。

包含外部片段

当前发布链路：mdBook source -> static HTML/Markdown output -> nginx container -> Nginx Proxy Manager -> HTTPS domain。

Rust playground

fn main() {
let homepage = "www.quaternijkon.online";
println!("mdBook homepage: {homepage}");
}

fn main() {
let upstream = "127.0.0.1:3003";
println!("homepage upstream: {upstream}");
}

rustdoc_include

fn main() {
    let renderer = "mdBook native renderer";
    println!("{renderer}");
}

数学公式

启用 MathJax 后可以渲染行内公式 \(a^2 + b^2 = c^2\)，也可以渲染块级公式：

\[ E = mc^2 \]

标准 Markdown 扩展

• 任务列表
• 脚注¹
• 定义列表
• admonition

1. 这是 mdBook 原生 Markdown 渲染支持的脚注示例。 ↩