核心用法
markdown-to-html 是一个纯 Python 标准库实现的 Markdown 转 HTML 工具，无需安装任何第三方依赖。支持从文件或标准输入读取内容，输出自包含的 HTML 文件，CSS 样式全部内嵌，可离线使用。
显著优点
1. 零依赖部署：仅依赖 Python 标准库，消除依赖冲突和供应链风险
2. 双主题系统：内置 Light（GitHub 风格）和 Dark 模式，配色专业
3. 完全独立：生成的 HTML 文件内嵌全部 CSS，无需外部资源即可正常显示
4. 响应式设计：自动适配桌面和移动端屏幕
5. 管道友好：支持 stdin/stdout，便于集成到自动化工作流
6. 完整 Markdown 支持：涵盖标题、粗斜体、删除线、链接、图片、代码块、引用、列表、表格等常用元素
潜在缺点与局限性
- 非标准解析：自研解析器可能不完全符合 CommonMark 规范，复杂嵌套结构或扩展语法（如任务列表、数学公式）可能不支持
- 无实时预览：作为命令行工具，缺乏可视化编辑界面
- 主题扩展性有限：仅两种内置主题，自定义需修改源码
- 代码高亮简单：仅支持语言标记，无完整语法高亮引擎
适合人群
- 技术写作者需要快速生成可分享文档
- 开发者构建 CI/CD 文档生成管道
- 邮件营销人员制作自包含 HTML 简报
- 需要离线文档展示的场景
常规风险
- 输入未过滤的 Markdown 可能包含恶意链接或脚本（虽工具本身不执行 JS，但下游使用需注意）
- 自研解析器存在解析差异风险，建议关键文档生成后人工校验
- 无沙箱机制，恶意 Markdown 文件本身可作为攻击载体（社会工程学层面）