CustomMarkdownImage
September 24, 2025 · View on GitHub
开始使用
使用pip install pillowmd
如何使用
先使用style = pillowmd.LoadMarkdownStyles(style路径),然后使用style.Render(markdown内容)即可快速渲染。若没有style,则可以pillowmd.MdToImage(内容)使用默认风格渲染
注:MdToImage是异步函数,若想使用默认风格进行同步渲染,请使用:
import pillowmd
style = pillowmd.MdStyle()
style.Render("# Is Markdown")
自定义style
见docs目录下的how_to……,里面有进一步指南,也可以进入Q群498427849
使用例
见tests目录
元素支持
markdown元素
| 元素 | 样例 | 是否支持 | 备注 |
|---|---|---|---|
| 标题 | # 标题 | ✅️ | 仅支持1~3级标题 |
| 引用 | > 123 | ✅️ | |
| 无序列表 | * 123 * 123 | ✅️ | |
| 有序列表 | 1. 123 2. 123 | ✅️ | |
| 行中代码 | 这是`行中代码` | ✅️ | 不支持高亮 |
| 行中表达式 | 这是$行中表达式$ | ✅️ | 支持latex,且支持latex拆分换行,详见pillowlatex |
| 表格 | |这是|表格| |-|-| |1|2| | ✅️ | 表格中仅支持普通文本,且不支持自定义对其方式。会自动换行 |
| 代码块 | ```python print("hello world") ``` | ✅️ | 不支持高亮 |
| 行间表达式 | && \frac{1}{2} && | ✅️ | 支持latex,且支持latex拆分换行,详见pillowlatex |
| HTML | <br> | ❎️ | 暂不支持 |
额外元素
| 元素 | 样例 | 备注 |
|---|---|---|
| 自定义颜色 | <color=#FF0000> | 强制更改颜色,填入#xxxxxx格式的颜色,填入None则为取消强制更改 |
| 快捷图片 | !sgm[图片名] !sgm[图片名|比例] !sgm[图片名|x比例,y比例] | 需要设置快捷图片路径,可在渲染时取消使用该元素 |
| 自定义元素 | !sgexter[元素名,参数……] !sgexter[card,"title","content",800,400,"图片.jpg"] | 可在渲染时取消使用该元素 |
渲染差异
当仅有一个\n时,也会换行
图片预览
元素预览
分页+侧边图渲染
新版本LaTeX支持
Style下载
其他
欢迎各位分享你自己的style风格,联系QQ614675349,或者直接在GitHub上提交PR
更新日志
0.7.0
新增行间latex支持,优化readme,现在引用一级的线会被渲染出来了
0.6.0
新增latex支持,详见pillowlatex
0.5.3
修复了表格渲染会错误的在前后加上行间距的问题 增加了表格的debug显示
分页+侧边图渲染
新版本LaTeX支持
