主题
LiteParse 可以直接把文档渲染成 Markdown,从空间版面里重建标题、表格、列表、图片与链接。这非常适合把文档喂给 LLM 与 RAG 流程 —— 在这些场景里,干净、结构化的文本比精确的视觉还原更重要。
Markdown 是与 text、json 并列的一等输出格式。
CLI
终端窗口
# Render a document to Markdown
lit parse document.pdf --format markdown -o output.md
# Print Markdown to stdout
lit parse document.pdf --format markdown图像
默认情况下,位图会按阅读顺序输出为 Markdown 占位符()。用 --image-mode 控制这一行为:
| 模式 | 行为 |
|---|---|
placeholder(默认) | 按阅读顺序输出  引用 |
off | 完全不输出图片 |
embed | 输出同样的引用,并抽取图片字节 |
--image-mode 只控制 markdown 里图片引用的出现方式,它本身不会解码任何像素。要真正拿到图片字节,请用 --extract-images(见抽取选项):
终端窗口
# Strip images
lit parse document.pdf --format markdown --image-mode off
# Extract embedded images to disk and reference them from the markdown
lit parse document.pdf --format markdown --extract-images --image-output-dir ./images--image-output-dir 需要配合 --extract-images 使用。为了向后兼容,--image-mode embed 也会顺带开启抽取,所以旧写法 --image-mode embed --image-output-dir ./images 依然可用。
链接
超链接批注默认渲染成 [text](url)。传入 --no-links 则改为只输出纯文本的锚文字:
终端窗口
lit parse document.pdf --format markdown --no-links页眉与页脚
默认的 markdown 输出会剥离滚动页眉与页脚(页码、每页重复的文档标题),因为在做检索切片时它们会打断正文。传入 --keep-headers-footers 可以保留它们:
终端窗口
lit parse document.pdf --format markdown --keep-headers-footers库
渲染出的 Markdown 通过 result.text 返回。
- TypeScript
- Python
- Rust
import { LiteParse } from "@llamaindex/liteparse";
const parser = new LiteParse({
outputFormat: "markdown", // "json" | "text" | "markdown"
imageMode: "placeholder", // "placeholder" | "off" | "embed" (default: "placeholder")
extractLinks: true, // render [text](url) link syntax (default: true)
});
const result = await parser.parse("document.pdf");
console.log(result.text); // rendered Markdownfrom liteparse import LiteParse
parser = LiteParse(
output_format="markdown", # "json" | "text" | "markdown"
image_mode="placeholder", # "placeholder" | "off" | "embed"
extract_links=True, # render [text](url) link syntax (default: True)
)
result = parser.parse("document.pdf")
print(result.text) # rendered Markdownuse liteparse::config::{ImageMode, LiteParseConfig, OutputFormat};
use liteparse::LiteParse;
let config = LiteParseConfig {
output_format: OutputFormat::Markdown,
image_mode: ImageMode::Placeholder,
extract_links: true,
..Default::default()
};
let result = LiteParse::new(config).parse("document.pdf").await?;
println!("{}", result.text); // rendered Markdown质量说明
Markdown 重建的质量随文档复杂度波动。对常见文档 LiteParse 表现很好,能处理正文、标题、简单到中等复杂的表格以及列表。它完全在本地运行,用基于规则的启发式方法,不依赖任何模型。对于最难的文档(密集或多层表格、复杂多栏版面、图表、扫描件),LlamaParse 仍是最准确的选择。