HTML Document Generation

HTML 文档生成

基于 Pandoc + Richee 设计系统将 Markdown 转换为专业 HTML 报告
6 模板覆盖法律行业全场景：报告/意见/简报/函件/法定文书/法定表格

文件结构

html-document-generation/
├── SKILL.md                          # 本文件
└── scripts/
    ├── md2html.py                    # 转换入口（pandoc + 模板 + Lua 过滤器）
    ├── markdown-to-html.lua          # Lua 过滤器聚合
    ├── disable-ordered-list-numbering.lua   # 有序列表文本序号
    ├── image-title-to-caption.lua            # 图片题注
    ├── shared.css               # 共享 CSS（设计令牌 + 全部组件类）
    ├── template-report.html      # 全面报告
    ├── template-opinion.html     # 意见书/备忘录
    ├── template-brief.html       # 简报/快讯
    ├── template-letter.html      # 律师函/催告函
    ├── template-pleading.html   # 法定文书（起诉状/申请书）
    └── template-form.html       # 法定表格（官方表格填充）

目录

1. 技术栈
2. 模板选型
3. 创建 HTML 文档
4. Richee 设计系统
5. Lua 过滤器
6. Markdown 编写规范
7. 输出规范
8. Do / Don't

1. 技术栈

2. 模板选型

6 个模板共享 shared.css（同一套设计令牌和组件类），只是页面骨架不同。

3. 创建 HTML 文档

一行命令

# 全面报告（默认）
python scripts/md2html.py report.md -o output.html --toc --title "供应商风险评估报告"

# 法律意见书
python scripts/md2html.py opinion.md --template opinion --title "法律意见书" \
  --addressee "XX科技有限公司" --firm "XX律师事务所" --lawyer "张三" --disclaimer

# 简报/快讯
python scripts/md2html.py brief.md --template brief --title "《数据安全法》修订要点" \
  --date "2026-07-28" --disclaimer

# 律师函
python scripts/md2html.py letter.md --template letter --title "关于XX合同违约的律师函" \
  --addressee "XX贸易有限公司" --firm "XX律师事务所" --date "2026-07-28"

# 民事起诉状
python scripts/md2html.py pleading.md --template pleading --title "民事起诉状" \
  --court "杭州市中级人民法院" --signer "张三" --date "2026-07-28"

# 企业登记申请表
python scripts/md2html.py form.md --template form --title "企业登记申请表" \
  --signer "李四" --date "2026-07-28" --form-no "DJ-2026-001"

参数说明

通用参数

report 专用

opinion/letter 专用

brief 专用

pleading 专用

form 专用

4. Richee 设计系统

配色纪律：黑白灰承载 90% 信息；绿色仅用于强调；红/琥珀/绿/蓝只用于标签与风险等级。

设计令牌

组件映射（Markdown 内嵌 HTML 用法）

基础内容（标题/段落/表格/列表）用 Markdown 语法。特殊组件在 Markdown 中内嵌 HTML 片段。

opinion/letter 专用类

pleading/form 专用类

响应式与打印

5. Lua 过滤器

6. Markdown 编写规范

标题编号

# 文档标题（不加序号）
## 一、一级标题            ← 中文数字 + 、
### （一）二级标题          ← 中文数字 + 括号
#### 1. 三级标题            ← 阿拉伯数字 + .
##### （1）四级标题          ← 阿拉伯数字 + 括号

序号由 Markdown 内容控制，不在模板里设自动编号，避免双份序号。

其他

• 优先使用 Markdown 而非内嵌 HTML
• 仅在复杂表格（colspan）、特殊组件时使用 HTML 片段
• 正文不得使用 emoji，用 [已核验]、[注意]、[高]、[中]、[低] 等文字标签

7. 输出规范

通用

• 正式交付物必须包含 AI 免责声明（--disclaimer）
• 禁止"保证胜诉""绝无风险""完全合规""一定合法"等绝对化法律结论
• 风险、状态、优先级不得只靠颜色表达，必须同时有文字标签
• 依据标签限定为：[已核] [待核] [用规] [事实] [推定] [用户提供] [公开来源]；不得自创或混用
• 文件名不得含 emoji；下载件采用可识别的主题和日期命名

HTML 专属

• 独立分发的 HTML 必须用 --standalone 内联所有 CSS/图片，不依赖外部资源
• CSS 不得含 </style> 闭合标签字面量，避免样式块提前终止
• 页面必须支持窄屏阅读，表格允许横向滚动，布局不得溢出容器

8. Do / Don't