使用Python批量转换md为html
作者 by Doubt-Fact / 2024-07-10 / 默认分类 / 暂无评论
如果你手头有大量的Markdown文件需要转换为HTML，手动一个个转换显然是非常低效的。幸运的是，Python提供了强大的库和工具，可以帮助我们自动化这个过程。
以下是一个将指定目录下的Markdown文件转换为HTML文件的简单脚本，使用`markdown`库和`highlightjs`。
## markdown库
安装命令：
```bash
pip install markdown
```
使用清华源安装：
```bash
pip install markdown -i https://pypi.tuna.tsinghua.edu.cn/simple
```
**需要注意的是这个库的一些拓展需要我们手动开启**
例如，开启markdown拓展：
```python
markdown.markdown(text, extensions=['markdown.extensions.extra'])
```
更多信息可以参考：
[https://www.osgeo.cn/python-tutorial/text-markdown.html][1]
这里给出一个示例代码，开启了拓展模块
```python
import os
import markdown
def markdown_to_html(markdown_dir, html_dir):
if not os.path.exists(html_dir):
os.makedirs(html_dir)
# 扩展
extensions = ['markdown.extensions.extra']
for filename in os.listdir(markdown_dir):
if filename.endswith(".md"):
markdown_path = os.path.join(markdown_dir, filename)
html_path = os.path.join(html_dir, filename.replace(".md", ".html"))
try:
with open(markdown_path, 'r', encoding='utf-8') as md_file:
md_content = md_file.read()
# 使用扩展进行转换
html_content = markdown.markdown(md_content, extensions=extensions)
with open(html_path, 'w', encoding='utf-8') as html_file:
html_file.write(html_content)
print(f"Converted {markdown_path} to {html_path}")
except Exception as e:
print(f"Error converting {markdown_path}: {e}")
# 调用函数进行转换
markdown_directory = './
html_directory = './'
markdown_to_html(markdown_directory, html_directory)
```
但是，我们发现，这样操作之后并没有开启代码高亮的效果并没有被有效触发。但检查生成的html代码发现代码部分已经被转换为了`<pre><code>`内联的代码。
面对这种情况，我们可以引入`highlight.js`来解决。
## highlight.js
`highlight.js`是一个基于JavaScript的语法高亮工具，我们可以直接通过CDN引入（这里使用国内托管网站加速，同时引入了`highlightjs-line-numbers.js`用来显示行号）。
## 代码
```python
import os
import markdown
def markdown_to_html(markdown_dir, html_dir):
if not os.path.exists(html_dir):
os.makedirs(html_dir)
# 扩展
extensions = ['markdown.extensions.extra']
# 头部和尾部要插入的内容
head_content = """
<link href="https://cdn.bootcdn.net/ajax/libs/highlight.js/11.9.0/styles/github.min.css" rel="stylesheet">
<style>
.codehilite {
padding: 0;
}
/* for block of numbers */
.hljs-ln-numbers {
-webkit-touch-callout: none;
-webkit-user-select: none;
-khtml-user-select: none;
-moz-user-select: none;
-ms-user-select: none;
user-select: none;
text-align: center;
color: #ccc;
border-right: 1px solid #CCC;
vertical-align: top;
padding-right: 5px;
}
.hljs-ln-n {
width: 30px;
}
/* for block of code */
.hljs-ln .hljs-ln-code {
padding-left: 10px;
white-space: pre;
}
</style>
"""
body_content = """
<script src="https://cdn.bootcdn.net/ajax/libs/highlight.js/11.9.0/highlight.min.js"></script>
<script src="https://cdn.bootcdn.net/ajax/libs/highlightjs-line-numbers.js/2.8.0/highlightjs-line-numbers.min.js"></script>
<script>
hljs.initHighlightingOnLoad();
hljs.initLineNumbersOnLoad();
</script>
"""
for filename in os.listdir(markdown_dir):
if filename.endswith(".md"):
markdown_path = os.path.join(markdown_dir, filename)
html_path = os.path.join(html_dir, filename.replace(".md", ".html"))
try:
with open(markdown_path, 'r', encoding='utf-8') as md_file:
md_content = md_file.read()
# 转换
html_content = markdown.markdown(md_content, extensions=extensions)
title = filename.replace(".md", "")
# 添加头部和尾部内容
html_content = f"<html>\n<head>\n<title>{title}</title>{head_content}</head>\n{html_content}\n<body>{body_content}</body>\n</html>"
with open(html_path, 'w', encoding='utf-8') as html_file:
html_file.write(html_content)
print(f"Converted {markdown_path} to {html_path}")
except Exception as e:
print(f"Error converting {markdown_path}: {e}")
# 调用函数进行转换
markdown_directory = './'
html_directory = './'
markdown_to_html(markdown_directory, html_directory)
```
## 效果
![效果图][2]
[1]: https://www.osgeo.cn/python-tutorial/text-markdown.html
[2]: https://t.tutu.to/img/mAeQq
无
评论已关闭