文档站演示→使用手册 →

格式与占位符演示

使用手册 · 2026-09-28

壳里可用的占位符

文档壳支持:{{TITLE}}、{{CONTENT}}、{{SIDEBAR}}、{{TOC}}、{{PREV}}、{{NEXT}}、
{{UPDATED_AT}}、{{COLLECTION}}、{{SITE_NAME}}、{{SITE_URL}}、{{SITE_DESC}}、{{NAV}}、{{FOOTER}},
以及条件块 {{#IF_SIDEBAR}}…{{/IF_SIDEBAR}}。

本节本身就是回归测试:正确的顺序是「先清掉壳里未识别的占位符,再注入正文」。
如果顺序反了,上面那些 {{XXX}} 字面量会被当作占位符一起吃掉 —— 你会在这一页看到明显缺字。

同理,模板字符串里的 ${name} 也不该被误当作占位符。

代码块

export function hello(name) {
    return `hi ${name}`;
}
npm run check      # 纯函数离线单测
npm run dev        # wrangler dev --remote,连生产 D1/R2

表格与引用

引用块、表格、嵌套列表都会走 marked 的 GFM 扩展。

元素 说明
表格 GFM 管道语法
任务列表 见下
  • 已完成项
  • 待办项

三级标题会进页内目录

锚点示例一

正文里的锚点链接应该保留:跳到锚点示例二。

锚点示例二

到这里,本页的 {{TOC}} 应该已经包含上面两个三级标题(用「右侧页内目录」那套壳时可见)。