【Python实战】markdown转pdf（包含公式转换）

最新推荐文章于 2025-03-27 00:43:46 发布

指尖听戏

最新推荐文章于 2025-03-27 00:43:46 发布

阅读量7.9k

点赞数 9

分类专栏： Python 文章标签： python 开发语言后端

本文链接：https://blog.csdn.net/qq_38140292/article/details/121511178

版权

Python 专栏收录该内容

35 篇文章

订阅专栏

本文介绍了如何使用Pandoc工具将Markdown转换为PDF和DOCX格式，详细阐述了命令行操作步骤，并展示了转换效果。此外，还通过Python库 Typora、pdfkit、markdown、wkhtmltopdf 实现了Markdown到PDF的转换，特别是处理表格和数学公式的方法。同时，演示了使用pymdown-extensions创建带有进度条的Markdown转换。

摘要生成于 C知道，由 DeepSeek-R1 满血版支持，前往体验 >

一、Pandoc转换

1.1 问题

由于我们markdown编辑器比较特殊，一般情况下，我们不太好看，如果转换成pdf的话，我们就不需要可以的去安装各种编辑器才可以看了，所以我们有了md转pdf或者是docx的需求。

1.2 下载

官网地址：但是官网可能被限制了，无法打开，此时可以去我的资源库中去下载，免费的！！！

我的资源地址

安装后，本地查看版本，是否安装成功：

出现如上图表示安装成功。

1.3 md转docx

cd进入我们需要转换的文件目录下，输入：

pandoc xxx.md -s -o xxxx.docx

-s：生成恰当的文件头部和底部。
-o：指定输出的文件。

查看实际效果：

此时发现文件已经生成好.我们打开看下，

整体转换效果还是不错的。

1.4 md转pdf

pandoc xxx.md -o xxxx.pdf --pdf-engine=xelatex

二、python库实现

使用 Typora可以直接转换
结合 wkhtmltopdf 使用 markdown 库和 pdfkit 库

2.1 安装 wkhtmltopdf

wkhtmltopdf 下载地址

2.2 安装 mdutils

pip install markdown
pip install pdfkit

参考案例：

import pdfkit
from markdown import markdown

input = r"F:\csdn博客\pytorch\【Pytorch】pytorch安装.md"
output = r"【Pytorch】pytorch安装.pdf"

with open(input, encoding='utf-8') as f:
    text = f.read()

html = markdown(text, output_format='html')  # MarkDown转HTML


htmltopdf = r'D:\htmltopdf\wkhtmltopdf\bin\wkhtmltopdf.exe'
configuration = pdfkit.configuration(wkhtmltopdf=htmltopdf)
pdfkit.from_string(html, output_path=output, configuration=configuration, options={'encoding': 'utf-8'})  # HTML转PDF

但是我们此时存在一个问题，如果我们的md中有表格的话，如图：

那么转换之后会发现是乱的:

我们此时需要设定参数，修改为如下：

html = markdown(text, output_format='html',extensions=['tables'])

我们再看下效果：

2.3 引入数学公式

pip install python-markdown-math

import pdfkit
from markdown import markdown

input_filename = 'xxxx.md'
output_filename = 'xxxx.pdf'
html = '<!DOCTYPE html><body><link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/katex/dist/katex.min.css" crossorigin="anonymous"><script src="https://cdn.jsdelivr.net/npm/katex/dist/katex.min.js" crossorigin="anonymous"></script><script src="https://cdn.jsdelivr.net/npm/katex/dist/contrib/mathtex-script-type.min.js" defer></script>{}</body></html>'
text = '$$E=mc^2$$'
text = markdown(text, output_format='html', extensions=['mdx_math'])  # MarkDown转HTML
html = html.format(text)
pdfkit.from_string(html, output_filename, options={'encoding': 'utf-8'})  # HTML转PDF

2.4 网页转pdf

import pdfkit

pdfkit.from_file('xxx.html', 'xxxx.pdf', options={'encoding': 'utf-8'})  # HTML转PDF

2.5 进度条转换

pip install pymdown-extensions

progressbar.css

.progress-label {
  position: absolute;
  text-align: center;
  font-weight: 700;
  width: 100%;
  margin: 0;
  line-height: 1.2rem;
  white-space: nowrap;
  overflow: hidden;
}

.progress-bar {
  height: 1.2rem;
  float: left;
  background-color: #2979ff;
}

.progress {
  display: block;
  width: 100%;
  margin: 0.5rem 0;
  height: 1.2rem;
  background-color: #eeeeee;
  position: relative;
}

.progress.thin {
  margin-top: 0.9rem;
  height: 0.4rem;
}

.progress.thin .progress-label {
  margin-top: -0.4rem;
}

.progress.thin .progress-bar {
  height: 0.4rem;
}

.progress-100plus .progress-bar {
  background-color: #00e676;
}

.progress-80plus .progress-bar {
  background-color: #fbc02d;
}

.progress-60plus .progress-bar {
  background-color: #ff9100;
}

.progress-40plus .progress-bar {
  background-color: #ff5252;
}

.progress-20plus .progress-bar {
  background-color: #ff1744;
}

.progress-0plus .progress-bar {
  background-color: #f50057;
}

progressbar.py

from markdown import markdown

filename = 'progressbar.md'
html = '''
<!DOCTYPE html>
    <head>
        <meta charset="UTF-8">
        <meta name="viewport" content="width=device-width, initial-scale=1, minimal-ui">
        <title>progressbar</title>
        <link rel="stylesheet" href="progressbar.css">
    </head>
    <body>
        {}
    </body>
</html>
'''
encoding = 'utf-8'
with open(filename, encoding=encoding) as f:
    text = f.read()

extensions = [
    'markdown.extensions.attr_list',
    'pymdownx.progressbar'
]
text = markdown(text, output_format='html', extensions=extensions)  # MarkDown转HTML
html = html.format(text)
print(html)
with open(filename.replace('.md', '.html'), 'w', encoding=encoding) as f:
    f.write(html)
# pdfkit.from_string(html, output, options={'encoding': 'utf-8'})  # HTML转PDF
print('完成')

progressbar.md

[=0% "0%"]
[=5% "5%"]
[=25% "25%"]
[=45% "45%"]
[=65% "65%"]
[=85% "85%"]
[=100% "100%"]
[=85% "85%"]{: .candystripe}
[=100% "100%"]{: .candystripe .candystripe-animate}

[=0%]{: .thin}
[=5%]{: .thin}
[=25%]{: .thin}
[=45%]{: .thin}
[=65%]{: .thin}
[=85%]{: .thin}
[=100%]{: .thin}

我们看下最后的实际效果：

参考文章：https://blog.csdn.net/lly1122334/article/details/107936390?ops_request_misc=%257B%2522request%255Fid%2522%253A%2522163771667016780261986990%2522%252C%2522scm%2522%253A%252220140713.130102334…%2522%257D&request_id=163771667016780261986990&biz_id=0&utm_medium=distribute.pc_search_result.none-task-blog-2_allsobaiduend~default-2-107936390.first_rank_v2_pc_rank_v29&utm_term=python+md%E8%BD%ACpdf&spm=1018.2226.3001.4187