html格式转换实为html与其他格式（pdf/word/markdown/图片）的双向转换，需依目标格式和环境选择工具：pdfkit（python+wkhtmltopdf）适合高质量pdf；pandoc擅长文档格式互转但样式受限；html2canvas+jspdf可捕获js渲染结果但属截图方案；浏览器打印为零代码临时方案。

HTML 本身不是一种可“转换格式”的文件类型，它只是标记语言；所谓“HTML 文件格式转换”，实际指的是：把 HTML 当作输入，转成 PDF / Word / Markdown / 图片等；或反过来，把其他格式（如 Word、Markdown）转成 HTML。没有通用的 html_convert() 函数，得看目标格式和运行环境。

用 pdfkit 把 HTML 转 PDF（Python 场景）

这是最稳定、可控性高的本地方案，底层调用 wkhtmltopdf，支持 CSS 分页、页眉页脚。

常见错误现象：pdfkit.from_file() 报错 IOError: wkhtmltopdf reported an error，基本是路径没配对或中文乱码。

• 先装系统依赖：apt install wkhtmltopdf（Ubuntu）或去官网下 macOS/Windows 安装包
• Python 里指定二进制路径：config = pdfkit.configuration(wkhtmltopdf='/usr/local/bin/wkhtmltopdf')
• HTML 文件必须有完整 <meta charset="utf-8">，否则中文变方块
• 内联样式比外部 CSS 更可靠；@media print 规则会被识别，但 JS 渲染的内容默认不执行

浏览器 DevTools 导出为 PDF（零依赖临时方案）

适合快速预览或单页静态 HTML，不写代码，但结果不可编程控制。

使用场景：给客户发一份带样式的报告页，又不想搭服务。

anything-to-html

将调研报告、方案对比、数据分析、需求梳理、会议纪要、设计说明、代码评审、学习笔记等任务产物输出为可在浏览器直接打开的单文件 HTML，替代 Markdown 作为最终交付物。Markdown 在信息密度、视觉清晰度和可分享性上已跟不上 AI 产物的丰富度，HTML 能同时承载排版、表格、SVG 等。

下载

• Chrome / Edge 打开 HTML 文件 → F12 → Ctrl+P（打印）→ 选择“另存为 PDF”
• 注意关闭“背景图形”选项会导致 CSS background-color 不显示
• 页面含 iframe 或跨域资源时，PDF 中对应区域为空白

用 pandoc 在 HTML / Markdown / DOCX 之间互转

pandoc 是格式转换的瑞士军刀，但 HTML → DOCX 容易丢样式，DOCX → HTML 则结构更干净。

关键参数差异：

• pandoc input.html -o output.docx：基础转换，无样式保留
• 加 --css style.css 可注入样式，但仅影响段落级元素，表格/列表样式仍受限
• pandoc input.md -f markdown -t html5 --standalone -o out.html：生成含完整 的独立 HTML
• 遇到中文标题锚点乱码，加 --ascii 或确保源文件编码为 UTF-8 BOM（Windows 记事本常坑在这里）

前端直接用 html2canvas + jsPDF 截图转 PDF

适用于需要保留 JS 动态渲染结果（比如 ECharts 图表）的场景，但本质是“截图”，不是语义化转换。

容易踩的坑：

• html2canvas 默认忽略 transform 和 filter 样式，需手动设 useCORS: true 加载跨域图片
• 长页面截取要分页拼接，jsPDF 的 addPage() 和 setPage() 容易混淆顺序
• 字体 fallback 不生效：网页用 font-family: "PingFang SC", sans-serif，生成 PDF 里中文全成方框，得提前加载 WebFont 并 await font.ready

真正难的从来不是“怎么点一下转出来”，而是：要不要保留交互能力？是否允许外部资源加载？目标格式是否要被后续编辑？这些决定了你该选 pandoc 还是 pdfkit，还是干脆用 Puppeteer 做完整浏览器渲染。别一上来就搜“HTML 转换工具”，先问清楚输出物的真实用途。

前端入门到VUE实战笔记：立即使用
在学习笔记中，你将探索 前端 的入门与实战技巧！