Skip to content
LiteParse 文档版本 跟随上游 源快照 18f8489e 更新于 2026-10-16

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_pN_K.png))。用 --image-mode 控制这一行为:

模式行为
placeholder(默认)按阅读顺序输出 ![](image_pN_K.png) 引用
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 Markdown
from 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 Markdown
use 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 仍是最准确的选择。

BytesRouter 是社区翻译站点,所有译文仅供参考,一切以官方英文原文为准。