文章目录
问题描述 解决方案 引入更多扩展 引入数学包 网页转PDF 封装 额外
text
1
<a href="#_315">代码行号</a> <a href="#_384">进度条</a> <a href="#_513">参考文献</a> <a href="#_532">显示效果</a> 问题描述
将MarkDown转PDF
本文比较麻烦，还可以尝试 Pandoc
解决方案
使用 Typora 结合 wkhtmltopdf 使用 markdown 库 和 pdfkit 库
- 安装 mdutils
text
1
2
3
pip install markdown
pip install pdfkit
- 安装 wkhtmltopdf
添加到环境变量 Path 中（可使用绝对路径）
- 代码
test.md 参考：
text
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
import pdfkit
from markdown import markdown
input_filename = 'test.md'
output_filename = 'test.pdf'
with open(input_filename, encoding='utf-8') as f:
text = f.read()
html = markdown(text, output_format='html') # MarkDown转HTML
pdfkit.from_string(html, output_filename, options={'encoding': 'utf-8'}) # HTML转PDF
# wkhtmltopdf = r'C:\Program Files\wkhtmltopdf\bin\wkhtmltopdf.exe' # 指定wkhtmltopdf
# configuration = pdfkit.configuration(wkhtmltopdf=wkhtmltopdf)
# pdfkit.from_string(html, output_filename, configuration=configuration, options={'encoding': 'utf-8'}) # HTML转PDF
若没有配置环境变量，使用注释里的代码
- 效果
不支持标注 不支持表格 不支持LaTeX 不支持代码块 不支持流程图、序列图、甘特图
引入更多扩展
test.md
text
1
2
3
4
5
6
|项目|价格|数量|
|---|---|---|
|计算机|$1600|5|
|手机|$12|12|
|管线|$1|234|
无法正确渲染
引入扩展 tables
text
1
2
3
4
5
6
7
8
9
10
11
import pdfkit
from markdown import markdown
text = '''|项目|价格|数量|
|---|---|---|
|计算机|$1600|5|
|手机|$12|12|
|管线|$1|234|'''
html = markdown(text, output_format='html', extensions=['tables']) # MarkDown转HTML
pdfkit.from_string(html, 'test.pdf', options={'encoding': 'utf-8'}) # HTML转PDF
详细阅读：Available Extensions
引入数学包
HTML 引入 KaTeX markdown库启用mdx_math
安装
text
1
2
pip install python-markdown-math
text
1
2
3
4
5
6
7
8
9
10
11
import pdfkit
from markdown import markdown
input_filename = 'test.md'
output_filename = 'test.pdf'
html = '<!DOCTYPE html><body><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
详细阅读：第三方扩展
网页转PDF
生成HTML代码效果不完美，可以使用作业部落的导出HTML功能，再转PDF
text
1
2
3
4
import pdfkit
pdfkit.from_file('test.html', 'test.pdf', options={'encoding': 'utf-8'}) # HTML转PDF
封装
安装库
text
1
2
3
4
pip install python-markdown-math
pip install pygments
pip install pymdown-extensions
下载CSS
github-markdown.css 改名为 markdown.css codehilite.css 生成命令 pygmentize -S default -f html -a .highlight > codehilite.css linenum.css
text
1
2
3
4
[data-linenos]:before {
content: attr(data-linenos);
}
tasklist.css
text
1
2
3
4
5
6
7
8
9
.markdown-body .task-list-item {
list-style-type: none !important;
}
.markdown-body .task-list-item input[type="checkbox"] {
margin: 0 4px 0.25em -20px;
vertical-align: middle;
}
代码
text
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
import os
import pdfkit
from markdown import markdown
from pymdownx import superfences
def markdown2pdf(input, output='test.pdf', encoding='utf-8', savehtml=False):
html = '''
<!DOCTYPE html>
<head>
<meta charset="UTF-8">
<meta name="viewport" content="width=device-width, initial-scale=1, minimal-ui">
<title>{}</title>
<script src="https://unpkg.com/mermaid@8.7.0/dist/mermaid.min.js"></script>
<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>
</head>
<body>
<article class="markdown-body">
{}
</article>
</body>
</html>
'''
with open(input, encoding=encoding) as f:
text = f.read()
extensions = [
'toc', # 目录，[toc]
'extra', # 缩写词、属性列表、释义列表、围栏式代码块、脚注、在HTML的Markdown、表格
]
third_party_extensions = [
'mdx_math', # KaTeX数学公式，$E=mc^2$和$$E=mc^2$$
'markdown_checklist.extension', # checklist，- [ ]和- [x]
'pymdownx.magiclink', # 自动转超链接，
'pymdownx.caret', # 上标下标，
'pymdownx.superfences', # 多种块功能允许嵌套，各种图表
'pymdownx.betterem', # 改善强调的处理(粗体和斜体)
'pymdownx.mark', # 亮色突出文本
'pymdownx.highlight', # 高亮显示代码
'pymdownx.tasklist', # 任务列表
'pymdownx.tilde', # 删除线
]
extensions.extend(third_party_extensions)
extension_configs = {
'mdx_math': {
'enable_dollar_delimiter': True # 允许单个$
},
'pymdownx.superfences': {
"custom_fences": [
{
'name': 'mermaid', # 开启流程图等图
'class': 'mermaid',
'format': superfences.fence_div_format
}
]
},
'pymdownx.highlight': {
'linenums': True, # 显示行号
'linenums_style': 'pymdownx-inline' # 代码和行号分开
},
'pymdownx.tasklist': {
'clickable_checkbox': True, # 任务列表可点击
}
} # 扩展配置
title = '.'.join(os.path.basename(input).split('.')[:-1])
text = markdown(text, output_format='html', extensions=extensions,
extension_configs=extension_configs) # MarkDown转HTML
html = html.format(title, text)
print(html)
if savehtml:
with open(input.replace('.md', '.html'), 'w', encoding=encoding) as f:
f.write(html)
pdfkit.from_string(html, output, options={'encoding': 'utf-8'}) # HTML转PDF
if __name__ == '__main__':
markdown2pdf('test.md', 'test.pdf', savehtml=True)
print('完成')
效果看文末
PS：
缺什么找对应扩展即可，若无可自行编写。 原理为MarkDown转HTML转PDF，pdfkit效果并不好，所以效果也有限。 可使用 Adobe Acrobat Pro 转换，但流程图等转换依旧不完美。
额外
这部分非通用MarkDown
代码行号
linenum.md
text
1
2
3
```python
if __name__ == '__main__':
print('Hello World!')
python
1
2
3
import math
print(math.pi) # 圆周率
text
1
2
3
4
5
linenum.css
[data-linenos]:before {
content: attr(data-linenos);
}
text
1
2
3
4
5
linenum.py
from markdown import markdown
filename = 'linenum.md'
html = '''