快捷導(dǎo)航

Python實(shí)現(xiàn)將Markdown一鍵打印為A4專業(yè)文檔

更新時(shí)間：2026年01月13日 08:47:54 作者：weixin_46244623

這篇文章主要為大家詳細(xì)介紹了如何使用Python實(shí)現(xiàn)將Markdown一鍵打印為A4專業(yè)文檔,文中的示例代碼講解詳細(xì),感興趣的小伙伴可以了解下

摘要

只需一個(gè) Python 腳本，3 秒完成：從任意 md.md 文件一鍵生成 A4 打印完美適配的 PDF，支持中文、表格、代碼塊防截?cái)?，自?dòng)添加 帶分隔線的頁(yè)眉頁(yè)腳 + 動(dòng)態(tài)頁(yè)碼，無(wú)需手動(dòng)調(diào)格式、寫(xiě) HTML、調(diào) CSS。 適合技術(shù)文檔、教程、報(bào)告、培訓(xùn)資料，直接打印分發(fā)，專業(yè)感拉滿！ 零依賴配置，運(yùn)行即得，告別 Word 排版痛苦，解放生產(chǎn)力！

一、功能概覽

本腳本實(shí)現(xiàn) 從 Markdown 文件一鍵生成專業(yè)級(jí) A4 打印友好 PDF，具備以下完整功能：

功能	實(shí)現(xiàn)方式
中文支持	使用 Microsoft YaHei + SimSun 字體
表格美觀	邊框、表頭灰底、自動(dòng)分頁(yè)
代碼塊防截?cái)?/td>	page-break-inside: avoid
頁(yè)眉（帶下劃線）	自定義 header.html
頁(yè)腳（帶上劃線 + 動(dòng)態(tài)頁(yè)碼）	自定義 footer.html + JavaScript
自動(dòng)生成臨時(shí)文件	tempfile.mkdtemp()
一鍵運(yùn)行	無(wú)需手動(dòng)創(chuàng)建 HTML 文件

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

1. 準(zhǔn)備文件結(jié)構(gòu)

項(xiàng)目文件夾/

├── 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. 運(yùn)行腳本

python md_to_a4_pdf.py

三、運(yùn)行效果

四、源代碼

# -*- coding: utf-8 -*-
"""
A4 打印友好版 PDF 一鍵生成腳本（完整版）
功能：
1. 從 md.md 自動(dòng)生成 PDF
2. 支持中文字體、表格、代碼塊
3. 帶頁(yè)眉（標(biāo)題 + 下劃線）、頁(yè)腳（頁(yè)碼 + 上劃線）
4. 自動(dòng)適應(yīng) A4 頁(yè)面，不裁切尾部
5. 自動(dòng)生成 header.html 和 footer.html
"""

import os
import markdown
import pdfkit
import tempfile

# -------------------------------
# 配置參數(shù)（請(qǐng)修改這里）
# -------------------------------
source_md_file = "md.md"                    # 源 Markdown 文件
output_pdf_file = "output_a4.pdf"           # 輸出 PDF 文件名
wkhtmltopdf_path = r"C:\Program Files\wkhtmltopdf\bin\wkhtmltopdf.exe"  # 修改為你的路徑

# 頁(yè)眉頁(yè)腳內(nèi)容
header_title = "Hive的安裝和配置"           # 頁(yè)眉標(biāo)題
footer_text = "第 [page] 頁(yè) / 共 [topage] 頁(yè)"  # 頁(yè)腳頁(yè)碼（wkhtmltopdf 自動(dòng)替換）

# -------------------------------
# 檢查 wkhtmltopdf
# -------------------------------
if not os.path.exists(wkhtmltopdf_path):
    print(f"錯(cuò)誤：未找到 wkhtmltopdf 可執(zhí)行文件！")
    print(f"請(qǐng)確認(rèn)路徑正確：{wkhtmltopdf_path}")
    print("下載地址：https://wkhtmltopdf.org/downloads.html")
    exit(1)

# -------------------------------
# 檢查 Markdown 文件
# -------------------------------
if not os.path.exists(source_md_file):
    print(f"錯(cuò)誤：找不到源 Markdown 文件：{source_md_file}")
    print("請(qǐng)確保 md.md 與腳本在同一目錄")
    exit(1)

# -------------------------------
# 讀取 Markdown 并轉(zhuǎn) 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"]
)

# -------------------------------
# 臨時(shí)目錄：自動(dòng)生成 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 動(dòng)態(tài)頁(yè)碼）
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 + ' 頁(yè) / 共 ' + v.topage + ' 頁(yè)';
    });
</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"臨時(shí)頁(yè)眉頁(yè)腳已生成：{temp_dir}")

# -------------------------------
# 完整 HTML 頁(yè)面
# -------------------------------
full_html = f"""<!DOCTYPE html>
<html>
<head>
<meta charset="utf-8">
<title>{header_title}</title>
<style>
@page {{
    size: A4;
    margin: 27mm 18mm 27mm 18mm; /* 上右下左，為頁(yè)眉頁(yè)腳留空間 */
}}
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 生成參數(shù)...")
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,

    # 自定義頁(yè)眉頁(yè)腳（帶線）
    '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，請(qǐng)稍候...")
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"頁(yè)眉頁(yè)腳臨時(shí)文件可刪除：{temp_dir}")
except Exception as e:
    print(f"PDF 生成失?。簕e}")
    exit(1)

# -------------------------------
# 結(jié)束提示
# -------------------------------
print("\n" + "="*50)
print("所有任務(wù)完成！")
print("1. 打開(kāi) output_a4.pdf 即可查看打印效果")
print("2. 支持直接打印，A4 完美適配")
print("3. 頁(yè)眉有下劃線，頁(yè)腳有上劃線，專業(yè)美觀")
print("="*50)

到此這篇關(guān)于Python實(shí)現(xiàn)將Markdown一鍵打印為A4專業(yè)文檔的文章就介紹到這了,更多相關(guān)Python打印Markdown內(nèi)容請(qǐng)搜索腳本之家以前的文章或繼續(xù)瀏覽下面的相關(guān)文章希望大家以后多多支持腳本之家！

您可能感興趣的文章: