壳里可用的占位符
文档壳支持:{{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}} 应该已经包含上面两个三级标题(用「右侧页内目录」那套壳时可见)。