纯 Python 标准库实现的 Markdown 转 HTML 工具，零依赖、双主题、单文件输出，适合邮件简报与技术文档。
说明：
## 核心用法
`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 源包含恶意 “ 或事件处理器（如 ``），纯字符串替换式渲染可能原样输出，需确保输入源可信或前置 HTML 转义。
– **资源泄露**：通过图片外链可实现 DNS 预解析或 IP 追踪，处理敏感文档时应审查图片 URL。
– **主题硬编码**：深色主题对比度在部分无障碍场景（WCAG）下可能未完全达标，关键业务需人工复核。
会员专属
