用途:把撰写好的 Markdown 转成单个可邮件发送、托管或打印的 HTML 文档,适合报告、白皮书、系列出版物,以及无需 LaTeX 或 Pandoc 工具链生成 PDF 的场景。
主要能力:自动生成目录;对图表和表格编号并支持按编号引用;脚注;内置主题被自动内联;带打印样式表,输出无运行时依赖、无外部资源。转换器始终先转义再渲染,不支持原生 HTML 透传,故可处理不受信任的贡献内容;交叉引用门禁会检查未解析引用和未定义脚注。
使用方式:三个 CLI 工具共享退出码约定,0 表示干净,2 表示门禁失败,1 表示工具自身错误。典型命令: python3 markdown-html/md-document/scripts/crossref_auditor.py --input markdown-html/md-document/assets/sample_document.md --format text python3 markdown-html/md-document/scripts/md_to_html.py --input markdown-html/md-document/assets/sample_document.md --out build/report.html --toc-depth 2 --format text 打印 PDF 时先用 print_profile.py 从页面配置生成打印 CSS,再与主题合并后用 --css 转换,最后在浏览器中打印为 PDF,页边距设为默认。
适用场景:单文件交付的报告或白皮书、图表需编号并在正文中引用、需要统一外观的文档系列、对注入安全有要求的内容转换、发布前排查断裂交叉引用。
限制:md_render.py 是被导入的库而非独立命令;不支持原生 HTML;图注不能替代替代文本;打印样式需在转换前确定;门禁通过不代表排版质量合格,仍需逐页校对实际输出。费用与平台信息暂未提供。