HTML 文档示例:表格与目录
这是一篇以 .html 格式编写的知识库文章。它的正文是第一方可信 HTML,
不经过 Markdown 解析,直接作为文章主体渲染。目录仍然会从二级标题自动生成。
为什么需要 HTML 文档
有些内容用 Markdown 表达很别扭,比如复杂的表格、自定义的排版结构。直接写 HTML 更可控,也方便从其它系统导出后原样落地。
功能对比表
下面是一个标准 HTML 表格,用来证明表格渲染正常:
| 能力 | Markdown | HTML 文档 |
|---|---|---|
| 代码高亮 | 支持 | 需自带标记 |
| 复杂表格 | 受限 | 完全自由 |
| 自动目录 | 支持 | 支持 |
小结
Markdown 适合大多数文章,HTML 适合需要精细排版的少数场景。两者共用同一套目录与样式。