（1866期）Markdown to HTML – 零依赖 Markdown 转 HTML 单文件

零依赖 Markdown 转 HTML 单文件 纯 Python 标准库实现的 Markdown 转 HTML 工具，零依赖、双主题、单文件输出，适合邮件简报与技术文档。 使用说明 核心用法 markdown-to-html 是一个基于纯 Python 标准库构建的 Markdown 渲染器，无需安装任何第三方依赖即可将 .md 文件转换为独立、可离线的 HTML 文档。用户通过命令行指定输入文件（或标准输入流）、输出路径、主题（light/dark）及页面标题，即可生成内嵌 CSS 的单一 HTML 文件，方便邮件发送、文档归档或静态站点生成。 显著优点 零依赖部署：仅使用 Python 标准库，消除版本冲突与供应链风险，可在受限环境（如企业内网、容器最小镜像）直接运行。 自包含输出：CSS 全部内联，单文件即可在任意浏览器打开，无需外链资源，适合作为邮件附件或离线文档。 双主题系统：内置 GitHub 风格浅色主题与护眼的深色主题，切换成本低，满足多场景阅读需求。 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）下可能未完全达标，关键业务需人工复核。 原始说明 Convert Markdown text to beautifully styled, self-contained HTML with embedded CSS. Perfect for newsletters, documentation, reports, and email templates.