Python实现将Markdown一键打印为A4专业文档

更新时间：2026年01月13日 08:47:54 作者：weixin_46244623

这篇文章主要为大家详细介绍了如何使用Python实现将Markdown一键打印为A4专业文档,文中的示例代码讲解详细,感兴趣的小伙伴可以了解下

摘要

只需一个 Python 脚本，3 秒完成：从任意 md.md 文件一键生成 A4 打印完美适配的 PDF，支持中文、表格、代码块防截断，自动添加 带分隔线的页眉页脚 + 动态页码，无需手动调格式、写 HTML、调 CSS。 适合技术文档、教程、报告、培训资料，直接打印分发，专业感拉满！ 零依赖配置，运行即得，告别 Word 排版痛苦，解放生产力！

一、功能概览

本脚本实现 从 Markdown 文件一键生成专业级 A4 打印友好 PDF，具备以下完整功能：

功能	实现方式
中文支持	使用 Microsoft YaHei + SimSun 字体
表格美观	边框、表头灰底、自动分页
代码块防截断	page-break-inside: avoid
页眉（带下划线）	自定义 header.html
页脚（带上划线 + 动态页码）	自定义 footer.html + JavaScript
自动生成临时文件	tempfile.mkdtemp()
一键运行	无需手动创建 HTML 文件

二、使用方法（3步搞定）

1. 准备文件结构

项目文件夹/

├── md.md ← 你的 Markdown 文档
├── md_to_a4_pdf.py ← 本脚本

2. 安装依赖

pip install markdown pdfkit

3. 安装 wkhtmltopdf

安装后 修改脚本第 15 行路径：

wkhtmltopdf_path = r"C:\Program Files\wkhtmltopdf\bin\wkhtmltopdf.exe"

4. 运行脚本

python md_to_a4_pdf.py

三、运行效果

四、源代码

# -*- coding: utf-8 -*-
"""
A4 打印友好版 PDF 一键生成脚本（完整版）
功能：
1. 从 md.md 自动生成 PDF
2. 支持中文字体、表格、代码块
3. 带页眉（标题 + 下划线）、页脚（页码 + 上划线）
4. 自动适应 A4 页面，不裁切尾部
5. 自动生成 header.html 和 footer.html
"""

import os
import markdown
import pdfkit
import tempfile

# -------------------------------
# 配置参数（请修改这里）
# -------------------------------
source_md_file = "md.md"                    # 源 Markdown 文件
output_pdf_file = "output_a4.pdf"           # 输出 PDF 文件名
wkhtmltopdf_path = r"C:\Program Files\wkhtmltopdf\bin\wkhtmltopdf.exe"  # 修改为你的路径

# 页眉页脚内容
header_title = "Hive的安装和配置"           # 页眉标题
footer_text = "第 [page] 页 / 共 [topage] 页"  # 页脚页码（wkhtmltopdf 自动替换）

# -------------------------------
# 检查 wkhtmltopdf
# -------------------------------
if not os.path.exists(wkhtmltopdf_path):
    print(f"错误：未找到 wkhtmltopdf 可执行文件！")
    print(f"请确认路径正确：{wkhtmltopdf_path}")
    print("下载地址：https://wkhtmltopdf.org/downloads.html")
    exit(1)

# -------------------------------
# 检查 Markdown 文件
# -------------------------------
if not os.path.exists(source_md_file):
    print(f"错误：找不到源 Markdown 文件：{source_md_file}")
    print("请确保 md.md 与脚本在同一目录")
    exit(1)

# -------------------------------
# 读取 Markdown 并转 HTML
# -------------------------------
print("正在读取 Markdown 文件...")
with open(source_md_file, "r", encoding="utf-8") as f:
    md_text = f.read()

html_content = markdown.markdown(
    md_text,
    extensions=["tables", "fenced_code", "nl2br", "toc"]
)

# -------------------------------
# 临时目录：自动生成 header.html 和 footer.html
# -------------------------------
temp_dir = tempfile.mkdtemp(prefix="pdf_gen_")
header_path = os.path.join(temp_dir, "header.html")
footer_path = os.path.join(temp_dir, "footer.html")

# 生成 header.html（带下划线）
header_html = f"""<!DOCTYPE html>
<html><head><meta charset="utf-8"><style>
    body {{ margin:0; padding:0; font-family:"Microsoft YaHei","SimSun",sans-serif; font-size:10pt; }}
    .c {{ text-align:center; padding:5px 0; }}
    .line {{ border-bottom:1px solid #999; margin-top:4px; }}
</style></head><body>
<div class="c">{header_title}</div>
<div class="line"></div>
</body></html>"""

# 生成 footer.html（带上划线）
# 生成 footer.html（带 JS 动态页码）
footer_html = """<!DOCTYPE html>
<html><head><meta charset="utf-8"><style>
    body {margin:0;padding:0;font-family:"Microsoft YaHei","SimSun",sans-serif;font-size:10pt;text-align:center;}
    .line {border-top:1px solid #999;margin:4px 0;}
</style>
<script>
    function subst() { 
        var vars = {}; 
        location.search.substring(1).split("&").forEach(function(p){
            var pair = p.split("="); vars[pair[0]] = decodeURIComponent(pair[1]);
        }); 
        return vars; 
    }
    document.addEventListener('DOMContentLoaded', function(){
        var v = subst(); 
        var el = document.getElementById('pageInfo');
        if(el) el.innerHTML = '第 ' + v.page + ' 页 / 共 ' + v.topage + ' 页';
    });
</script>
</head><body>
<div class="line"></div>
<div id="pageInfo" style="padding:5px 0;"></div>
</body></html>"""

with open(header_path, "w", encoding="utf-8") as f:
    f.write(header_html)
with open(footer_path, "w", encoding="utf-8") as f:
    f.write(footer_html)

print(f"临时页眉页脚已生成：{temp_dir}")

# -------------------------------
# 完整 HTML 页面
# -------------------------------
full_html = f"""<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>{header_title}</title>
<style>
@page {{
    size: A4;
    margin: 27mm 18mm 27mm 18mm; /* 上右下左，为页眉页脚留空间 */
}}
body {{
    font-family: "Microsoft YaHei", "SimSun", "Arial", sans-serif;
    line-height: 1.7;
    margin: 0;
    color: #333;
}}
h1, h2, h3, h4 {{ color: #2c3e50; margin-top: 1.2em; page-break-after: avoid; }}
table {{ border-collapse: collapse; width: 100%; margin: 10px 0; page-break-inside: auto; }}
th, td {{ border: 1px solid #999; padding: 8px; text-align: left; }}
th {{ background-color: #f5f5f5; font-weight: bold; }}
pre, code {{
    background: #f8f8f8;
    border-radius: 4px;
    page-break-inside: avoid;
    font-family: Consolas, "Courier New", monospace;
}}
pre {{ padding: 12px; overflow: auto; }}
code {{ padding: 2px 6px; font-size: 90%; }}
p, ul, ol, blockquote {{ page-break-inside: avoid; }}
</style>
</head>
<body>
{html_content}
</body>
</html>"""

# -------------------------------
# PDF 配置
# -------------------------------
print("正在配置 PDF 生成参数...")
config = pdfkit.configuration(wkhtmltopdf=wkhtmltopdf_path)

options = {
    'page-size': 'A4',
    'margin-top': '27mm',
    'margin-bottom': '27mm',
    'margin-left': '18mm',
    'margin-right': '18mm',
    'zoom': '0.95',
    'encoding': 'UTF-8',
    'enable-local-file-access': None,

    # 自定义页眉页脚（带线）
    'header-html': header_path,
    'header-spacing': '5',

    'footer-html': footer_path,
    'footer-spacing': '5',
    # 必须添加以下三行
    'enable-javascript': None,
    'javascript-delay': '500',
    'no-stop-slow-scripts': None,
}

# -------------------------------
# 生成 PDF
# -------------------------------
print("正在生成 PDF，请稍候...")
try:
    pdfkit.from_string(
        full_html,
        output_pdf_file,
        configuration=config,
        options=options
    )
    print(f"PDF 生成成功！")
    print(f"文件：{os.path.abspath(output_pdf_file)}")
    print(f"页眉页脚临时文件可删除：{temp_dir}")
except Exception as e:
    print(f"PDF 生成失败：{e}")
    exit(1)

# -------------------------------
# 结束提示
# -------------------------------
print("\n" + "="*50)
print("所有任务完成！")
print("1. 打开 output_a4.pdf 即可查看打印效果")
print("2. 支持直接打印，A4 完美适配")
print("3. 页眉有下划线，页脚有上划线，专业美观")
print("="*50)

到此这篇关于Python实现将Markdown一键打印为A4专业文档的文章就介绍到这了,更多相关Python打印Markdown内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家！

您可能感兴趣的文章:

Python中的super().__init__()用法详解
我们在学习Python类的时候,总会碰见书上的类中有__init__()这样一个函数,这篇文章主要介绍了Python中的super().__init__()用法的相关资料,文中通过代码介绍的非常详细,需要的朋友可以参考下
2025-06-06
Python的SQLalchemy模块连接与操作MySQL的基础示例
SQLalchemy是Python世界中驱动MySQL的一款高人气模块,这里我们从入门开始来看一下Python的SQLalchemy模块连接与操作MySQL的基础示例:
2016-07-07
Python使用PyQt实现网页加载过程
这篇文章主要介绍了Python使用PyQt实现网页加载过程,具有很好的参考价值,希望对大家有所帮助,如有错误或未考虑完全的地方,望不吝赐教
2025-06-06
pytorch中如何设置随机种子
这篇文章主要介绍了pytorch中如何设置随机种子，具有很好的参考价值，希望对大家有所帮助。如有错误或未考虑完全的地方，望不吝赐教
2022-12-12
python数据分析之单因素分析线性拟合及地理编码
这篇文章主要介绍了python数据分析之单因素分析线性拟合及地理编码，文章围绕主题展开详细的内容介绍，具有一定的参考价值，需要的小伙伴可以参考一下
2022-06-06
Python面向对象的三大特性封装、继承、多态
这篇文章介绍了Python面向对象的三大特性封装、继承、多态，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2022-07-07
Python实现二叉树的最小深度的两种方法
这篇文章主要介绍了Python实现二叉树的最小深度的两种方法，文中通过示例代码介绍的非常详细，对大家的学习或者工作具有一定的参考学习价值，需要的朋友们下面随着小编来一起学习学习吧
2019-09-09
python if not in 多条件判断代码
学了一段时间python，发现有时遇到多条件判断的时候，觉得使用单纯的in的话比较麻烦，需要多个条件，今天又遇到一个，网上搜索了一下，也有同学和我遇到相同的问题，记录一下
2016-09-09
Python使用pickle模块储存对象操作示例
这篇文章主要介绍了Python使用pickle模块储存对象操作,结合实例形式分析了Python使用pickle模块针对文件读写与转换的相关操作技巧,需要的朋友可以参考下
2018-08-08
Python 内置logging 使用详细介绍
提供日志记录的接口和众多处理模块，供用户存储各种格式的日志，帮助调试程序或者记录程序运行过程中的输出信息，这篇文章主要介绍了Python 内置logging 使用讲解,需要的朋友可以参考下
2022-07-07