Notepad++ 无法直接导出 PDF,需借助外部工具:①用 Windows 自带“Microsoft Print to PDF”可快速生成基础PDF,但不支持行号与自定义排版;②配合Pandoc+XeLaTeX可生成含目录、语法高亮、中文支持的专业技术手册PDF。

Notepad++ 本身不能直接导出 PDF
Notepad++ 是纯文本编辑器,没有内置 PDF 导出功能。点菜单里的「文件 → 另存为」或「打印」,都找不到 PDF 选项——这不是你操作错了,是软件压根不支持。
想把代码转成带语法高亮、页眉页脚、可打印的 PDF 技术手册,必须借助外部工具或流程配合。核心思路是:先让代码“可视化”(加样式),再转成 PDF。
用 Notepad++ + Print to PDF(Windows 自带)快速生成基础 PDF
这是最快捷的临时方案,适合内部快速分享、无需复杂排版的场景。依赖 Windows 系统级的「Microsoft Print to PDF」虚拟打印机。
- 确保 Notepad++ 中已启用语法高亮(例如打开
.py文件后,语言菜单选「Python」) - 「文件 → 打印」→ 打印机选「Microsoft Print to PDF」→ 勾选「打印背景色和图像」(关键!否则高亮颜色丢失)
- 在打印对话框中可调页边距、缩放比例(建议设为「适应页面宽度」避免横向滚动)
- 点击「打印」,选择保存路径即可生成 PDF
⚠️ 注意:Print to PDF 不保留行号、不支持自定义字体大小分级、页眉固定为文件名+页码,不适合正式技术文档。
用 Notepad++ 配合 Pandoc 生成专业级代码手册 PDF
这是真正能产出可维护、可复用技术手册的方案。Pandoc 能把带语法高亮的 Markdown 或 HTML 当输入,输出结构清晰、带目录、页眉页脚的 PDF。
- 先在 Notepad++ 中用插件「NppExport」→ 「Copy all formats to clipboard」复制带样式的 HTML(含内联 CSS)
- 新建一个
doc.md文件,粘贴为 HTML 片段,或更推荐:用 Notepad++ 写 Markdown,用```python包裹代码块,再用 Pandoc 渲染 - 命令行执行:
pandoc doc.md -o manual.pdf --pdf-engine=xelatex --toc --highlight-style=pygments - 需要提前安装
xelatex(TeX Live)和pygments(用于代码高亮),否则会报错Could not find highlight style 'pygments'
这个流程生成的 PDF 支持目录、章节编号、等宽字体对齐、跨页代码块续行,才是真正意义上的技术手册底稿。
导出时容易丢样式或乱码的几个硬坑
不是所有「看起来导出了 PDF」就真能用。以下问题高频出现,且往往卡在最后一步:
- 中文乱码:Pandoc 默认用 PDFLaTeX,不支持 UTF-8 中文;必须换
--pdf-engine=xelatex并在 Markdown 开头加% !TEX root = manual.tex和相应 CJK 设置 - 高亮失效:Notepad++ 的 NppExport 导出 HTML 时,若主题是深色(如 Twilight),白色文字在 PDF 白底上不可见;导出前切到「Style Configurator」里改用浅色背景主题
- 长代码行被截断:Pandoc 默认不自动换行;加参数
--wrap=preserve或在 CSS 中给pre code加white-space: pre-wrap; - Notepad++ 插件「PDF Viewer」只是看 PDF,不能生成 PDF——别被名字误导
真正能闭环生成技术手册的,从来不是单点工具,而是 Notepad++ 做内容编辑 + 外部工具做格式转换。手动复制 HTML、写两行 Pandoc 命令、调一次 xelatex 配置,比找「一键 PDF 插件」靠谱得多。



















