---
title: liepress — Markdown to PDF/SVG/PNG Converter
---
# liepress
**liepress** 是一个基于 Rust 的 Markdown 文档转换工具，支持 CSS 样式定制，输出 PDF、SVG、PNG 格式。
- 作者：zzzdong
- 仓库：<https://github.com/zzzdong/liepress>
- 许可：MIT OR Apache-2.0
---
## 安装
```bash
cargo install liepress
```
或从源码构建：
```bash
git clone https://github.com/zzzdong/liepress
cd liepress
cargo build --release
```
---
## 快速开始
准备一个 Markdown 文件 `doc.md`：
```markdown
# Hello, liepress!
这是一段 **加粗** 和 *斜体* 文本。
```
然后运行：
```bash
liepress doc.md -o doc.pdf
```
liepress 会根据 Markdown 内容和 CSS 样式生成文档。
---
## 文本样式
普通段落文本。**加粗文本**，*斜体文本*，***加粗斜体***，~~删除线文本~~。
行内 `code` 和行内代码块 `let x = 1;`。
这是 <span style="color: red;">红色 span 文字</span>，<span style="font-weight: bold;">加粗 span</span>，<span style="font-size: 16pt;">放大字号 span</span>，<span style="text-decoration: line-through;">span 删除线</span>。
---
## 链接与图片
[liepress 仓库](https://github.com/zzzdong/liepress)
带标题的链接：[GitHub](https://github.com/zzzdong/liepress "liepress 项目主页")
> 注意：liepress 仅支持本地图片文件，不支持远程 URL。
> 将图片放在 Markdown 同级或子目录中引用即可。
---
## 引用块
> liepress 支持多层嵌套引用块。
>
> > 引用内可以包含 **格式化文本**、`代码` 和 [链接](https://example.com)。
> >
> > > 三层嵌套引用也支持。
---
## 列表
无序列表：
- PDF 输出
- SVG 输出
- PNG 输出
- 基于 vello_cpu 渲染
- 支持 DPI 配置
有序列表：
1. 解析 Markdown 为 AST
2. 应用 CSS 样式解析
3. 布局引擎生成文档树
4. 渲染后端输出目标格式
任务列表：
- [x] Markdown 解析
- [x] PDF 输出
- [x] SVG 输出
- [x] PNG 输出
- [ ] 在线演示页面
---
## 代码块
无语言标识的代码块：
```
echo "Hello, liepress!"
```
Rust 代码块：
```rust
use liepress::ConvertOptions;
fn main() {
let md = "# Hello\nThis is **liepress**.";
let options = ConvertOptions::default()
.with_page_config((210.0, 297.0))
.with_font_family("serif");
let doc = liepress::convert(md, &options).unwrap();
doc.save_pdf("output.pdf").unwrap();
}
```
Python 代码块：
```python
from liepress import Converter # 假设的 Python 绑定
converter = Converter()
converter.load_css("style.css")
converter.convert("doc.md", "output.pdf")
```
---
## 表格
| PDF | krilla | ✅ 完成 | 高 |
| SVG | 手写 XML | ✅ 完成 | 中 |
| PNG | vello_cpu | ✅ 完成 | 低 |
| ~~HTML~~ | — | ❌ 取消 | — |
---
## 分隔线
---
## center 居中容器
<center>
# liepress
### 用 Markdown 生成文档
| 轻量 | 无需浏览器或 JS 运行时 |
| 快速 | Rust 编译，毫秒级渲染 |
| 可定制 | CSS 控制一切样式 |
</center>
---
## 内联 style 标签样式
<style>
.highlight {
background-color: #ffffcc;
padding: 2pt 4pt;
border-radius: 2pt;
}
.warning {
color: #cc0000;
font-weight: bold;
}
.tagline {
color: #4a90d9;
font-style: italic;
font-size: 14pt;
}
</style>
自定义样式测试：<span class="highlight">高亮文本</span>，<span class="warning">警告文本</span>，<span class="tagline">styled tagline</span>。
---
## 混合排版示例
# 1. 架构概述
> 本章介绍 liepress 的核心架构设计。
## 1.1 三阶段渲染管线
liepress 采用 **三阶段架构**，将文档处理分为独立的步骤：
| 解析 | Markdown + CSS | MDAST | 将 Markdown 解析为语法树 |
| 布局 | MDAST + Style | 布局文档 | 计算每个元素的位置和尺寸 |
| 渲染 | 布局文档 | PDF/SVG/PNG | 将布局结果绘制为最终输出 |
### 1.1.1 关键设计决策
```rust
// liepress 核心类型示意
pub enum OutputFormat {
Pdf,
Svg,
Png,
}
pub struct ConvertOptions {
pub page_width: f32,
pub page_height: f32,
pub font_family: String,
pub custom_css: Option<String>,
// ...
}
```
> **要点总结**：
>
> - 选择 Rust 语言以获得 **高性能** 和 **内存安全**
> - CSS 样式系统支持 **选择器权重计算** 和 **样式层叠**
> - 三种输出后端共享同一布局引擎
> - ~~Word 输出~~ 暂无计划
---
## 输出示例
以下是由 liepress 生成的 SVG 输出结构示意：
```svg
<svg width="595" height="842" xmlns="http://www.w3.org/2000/svg">
<text x="50" y="80" font-size="24" font-weight="bold">Hello</text>
<text x="50" y="120" font-size="10.5">This is liepress.</text>
</svg>
```
---
<center>
---
*liepress v0.1.0-beta — 用 Markdown 生成文档*
</center>