核心用法
markdown-to-html 是一个基于纯 Python 标准库构建的 Markdown 渲染器，无需安装任何第三方依赖即可将 .md 文件转换为独立、可离线的 HTML 文档。用户通过命令行指定输入文件（或标准输入流）、输出路径、主题（light/dark）及页面标题，即可生成内嵌 CSS 的单一 HTML 文件，方便邮件发送、文档归档或静态站点生成。
显著优点
1. 零依赖部署：仅使用 Python 标准库，消除版本冲突与供应链风险，可在受限环境（如企业内网、容器最小镜像）直接运行。
2. 自包含输出：CSS 全部内联，单文件即可在任意浏览器打开，无需外链资源，适合作为邮件附件或离线文档。
3. 双主题系统：内置 GitHub 风格浅色主题与护眼的深色主题，切换成本低，满足多场景阅读需求。
4. Unix 管道友好：支持 - 参数读取 stdin，可无缝嵌入 Shell 流水线，配合 cat、curl、git log 等工具实现自动化文档生成。
潜在缺点与局限性
- 功能边界：不支持复杂 Markdown 扩展（如数学公式、流程图、脚注、目录自动生成），仅覆盖 CommonMark 核心子集。
- 渲染性能：纯正则与字符串替换实现，面对超大规模文档（>10MB）时性能不及基于 C 扩展的渲染库（如
cmark、pulldown-cmark）。 - 主题定制：仅提供 light/dark 两套硬编码样式，无法通过外部 CSS 文件自定义，品牌一致性受限。
- 图片资源：输出 HTML 仅引用原始图片 URL，不会自动内联 Base64，离线场景下需额外处理。
适合人群
- 技术写作者与开发者：快速将 README、CHANGELOG 转为可分享的 HTML 邮件或静态页面。
- 运维与 DevOps 工程师：在 CI/CD 流水线中零依赖地生成构建报告、发布说明。
- 企业内部工具链：在无法安装 PyPI 包的封闭环境中完成 Markdown 可视化。
常规风险
- XSS 注入：若 Markdown 源包含恶意
<script>或事件处理器（如<img src=x onerror=...>），纯字符串替换式渲染可能原样输出，需确保输入源可信或前置 HTML 转义。 - 资源泄露：通过图片外链可实现 DNS 预解析或 IP 追踪，处理敏感文档时应审查图片 URL。
- 主题硬编码：深色主题对比度在部分无障碍场景（WCAG）下可能未完全达标，关键业务需人工复核。