还在为 LaTeX 公式渲染头疼?想在 Python 项目里轻松展示数学公式,却被各种依赖折磨得没脾气?今天给大家安利一个宝藏库——PillowLaTeX,轻量、易上手、纯 Python 实现,让公式渲染从此变得简单!
🌟 为什么选择 PillowLaTeX?
作为开发者,处理数学公式时是不是经常遇到这些问题:
- 想自定义公式样式(颜色、字体),却找不到简单的方法?
PillowLaTeX 完美解决了这些痛点: ✅ 纯 Python 实现:基于 Pillow 和 fonttools,无需额外安装 LaTeX 环境 ✅ 轻量快速:小而美的设计,渲染速度远超重量级工具 ✅ 高度可定制:支持自定义字体、颜色,还能调整上标下标位置 ✅ 功能全面:支持 40+函数、10+环境、300+关键词替换,覆盖绝大多数公式场景
🚀 3 分钟快速上手
第一步:安装
用 pip 一键安装,毫无压力:
pip install pillowmd
第二步:一行代码渲染公式
几行代码就能把 LaTeX 表达式转成图片,小白也能秒会:
import pillowlatex as plax
# 定义LaTeX表达式
latex = r"sin^2(x\times\pi) + \frac{a}{b} = \sqrt{c}"
# 解析并渲染
img = plax.RenderLaTeX(plax.GetLaTeXObjs(latex), color=(255, 0, 0)) # 红色公式
# 显示或保存图片
img.show()
# 直接显示
# img.img.save("formula.png") # 保存为PIL图像
自定义字体(可选)
如果需要特殊字体,支持混合字体配置,还能微调偏移:
from pillowlatex import MixFont, settings
font = MixFont(
settings.FONT_PATH.parent / "STIXTwoMath-Regular.ttf", # 主字体
second_fonts=[settings.FONT_PATH.parent / "yahei.ttf"], # 备用字体
size=50,
font_y_correct={"yahei.ttf": +15} # 字体偏移修正
)
# 用自定义字体渲染
img = plax.RenderLaTeX(plax.GetLaTeXObjs(latex), color=(0, 0, 255), font=font)
🎯 这些场景它都能搞定
无论是简单的数学公式,还是复杂的矩阵、分段函数,PillowLaTeX 都能轻松应对:
- 基础函数:分数(
frac)、根号(sqrt)、导数(dot/ddot) - 高级环境:矩阵(
matrix)、对齐公式(align*)、分段函数(cases) -
符号支持:希腊字母(αβγ...)、箭头(→←⇒)、集合符号(∈∪∩)
- 特殊效果:上标下标、重叠符号(
widehat/overline)、花括号(overbrace)
举个例子,渲染一个分段函数:
f(x) = \begin{cases}
x & \text{if } x \geq 0 \\
-x & \text{if } x < 0
\end{cases}
用 PillowLaTeX 只需几行代码,就能得到清晰的图片!
📌 注意事项
虽然功能强大,但目前有些内容暂不支持(如\mathbf、\mathbb、字体大小命令等),不过日常使用完全足够。项目还在持续迭代,后续会支持更多特性~
如果需要切割渲染(比如实现换行),PillowLaTeX 也能将表达式拆分成多个 Image,方便手动拼接,灵活性拉满!
👉 如何获取?
- 项目地址:https://github.com/Monody-S/pillowlatex
-
文档说明:README 里有详细的支持列表和使用示例,遇到问题可以看这里
如果你经常和数学公式打交道,或者需要在 Python 项目中展示公式,PillowLaTeX 绝对值得一试!轻量、高效、零依赖,让公式渲染不再成为开发路上的绊脚石~
快去试试吧,记得给项目点个 Star 支持作者!✨