用途:这是 TanStack Markdown 的生产环境检查清单,用于在部署博客、文档站点或用户内容渲染器之前逐项审计渲染管线,建立在 render-markdown 技能之上。
主要能力与检查项包括:
- 信任边界检查:将每个 Markdown 来源分类为可信或不可信,分离入口点,对不可信内容禁用可信回调;allowHtml 输出原始节点,不是消毒步骤,不可信输入须经 sanitize。
- 高亮检查:高亮回调只能返回转义后的 code 内容,不能返回完整的 pre/code 树;高亮器输出在任何渲染器中都不再二次转义,因此必须自行转义。
- 兼容性检查:用实际内容语料运行测试(如 MARKDOWN_CORPUS_DIRS=... pnpm run test:corpus、pnpm run corpus:audit:tanstack),并验证相同输入与选项产生确定性的 AST 与 HTML。
- 性能与缓存检查:使用最终解析选项解析一次并缓存 MarkdownDocument,缓存键带版本;执行 pnpm run size 与包体积测试。
- 发布检查:运行 pnpm run verify,覆盖测试、类型检查、构建、文档校验、体积与基准等。
使用方式:按清单逐节执行,配合相关技能 render-markdown、docs-features、custom-extensions、react-rendering 与 octane-rendering 使用。
限制:该包实现的是已文档化的文档/博客语法配置,并非完整 CommonMark、GFM、MDX 或任意插件行为;不接受不可信 HTML,也不替代应用层的链接、图片与最终 HTML 策略。价格、收费与平台信息暂未提供。