`
- **HTML 表格**(``)→ 直接透传,包裹在 `.table-wrap` 中
- **代码块**(` ``` `)→ 深色底 ``
- **原生条形图**(` ```chart ` 代码块)→ 纯 HTML/CSS 条形图(无 JS、可导出 PDF/长图、跟随色板)。格式:`title:` / `unit:` / `max:` / `series: A, B`(分组)/ `highlight: 名称` / `note:` / `source:`,数据行 `标签 | 值`(分组时 `标签 | 值1 | 值2`)。非数字值显示“无数据”。
- **表格增强**:分隔行 `--:` 控制对齐,纯数字列自动右对齐 + 等宽数字;`**数值**` 加粗即强调;表格下紧跟一行 `表:…` / `来源:…` 作为表注
- **把截图换成原生表格/图表**:文章里的参数表、跑分图如果数字清晰,应转录成 Markdown 表格 + ```chart。只转录看得清的数字,看不清的写“?”(渲染为“无数据”)或保留原图,绝不估读、绝不编造;表注写明转录自哪张图
- **图片**(``)→ `` + `
` + 可选 caption
- **blockquote**(`> text`)→ 带样式的引用块
- **有序/无序列表**(`1.` / `-`)→ 标准列表
- **脚注**:正文写 `[^1]`,任意位置写 `[^1]: 说明`,渲染成上标编号和文末列表(有 `## 脚注` / `## Footnotes` 节就放进去,没有就新建一节);脚注节自动缩小字体和间距
## Gotchas
1. **不要大幅删减用户内容**。升格是在原文行上做组件替换,不是删改重写。
2. **不要过度添加分割线**。瑞士风是卡片语言——用背景色/间距分隔,不用线条。section 之间零线。
3. **单语文档不要设 `meta.lang`**。lang 用于双语文档的语言过滤,全英文/全中文文档设为 `null`,否则会跳过所有非目标语言段落。
4. **highlight 的 line 必须精确对应加粗行**。如果偏了一行,原文段落会同时出现升格组件和原始段落。
5. **embed 的 SVG 必须纯内联**,不能引用外部文件。viewBox 宽度建议 600-720。颜色不要写死:线条和文字用 `currentColor`(跟正文色走),强调用 `style="fill:var(--accent)"` / `stroke:var(--accent)`,浅色底块用 `var(--paper-2)`,线用 `var(--line)`,这样切主题(含深色午夜墨)时图也跟着变。手机上图会保持可读的最小宽度并横向滚动
6. **hero_image 只能用照片/视频帧**(现场照、视频截图、建筑/几何摄影),**绝不用表格、图表、榜单、文字截图**做头图。不确定时写 `"hero_image": "auto"` 或省略:渲染器会从正文图片里挑第一张文件名/图注不像图表的照片(优先“视频截图/照片/全景”),并自动拒绝文件名或图注含 chart/table/bench/index/图表/表格/评测/基准/指数 的候选。
7. **annotations.json 写完后先数行号**。常见错误是行号算错导致标注打在空行或错误段落上。
8. **大编号和标题必须在同一行**(Swiss 模式)。渲染器已处理,但如果手写 HTML 要注意用 flex baseline 而不是分两行。
9. **highlight 卡片内的加粗文字**会自动继承白色(深色背景上),不会出现黑字消失的问题。