为什么mineru解析pdf生成的markdown文档中，标题丢失了层级信息，所有的标题层级都是2级

[shijieheping678-hue]

[dosubot[bot]]

Hi @shijieheping678-hue! I'm Dosu and I’m helping the MinerU team.

这是 MinerU 的一个已知限制。默认情况下，MinerU 的各个后端（pipeline、VLM）在没有 LLM 辅助的情况下，无法区分标题的层级，会将所有检测到的标题统一输出为同一级别（通常是 ##）[1]。

解决方案：启用 LLM 辅助标题优化

在 mineru.json 配置中开启 llm_aided_title 功能，可以识别最多 4 级标题层级。需要配置有效的 LLM API key 和服务信息（支持 Ollama 等外部 LLM 服务）[1]。

3.0.0 版本改进

如果你使用的是 3.0.0 或更新版本，已经有自动的层级分配逻辑：DOC_TITLE 类型的块会被分配为 1 级标题，PARAGRAPH_TITLE 类型的块会被分配为 2 级标题 [2]。但如果需要更细粒度的层级区分（如 h1-h4），仍然建议启用 LLM 辅助功能。

你目前使用的是哪个版本的 MinerU？如果是较新版本仍然出现全部为二级标题的情况，可能需要检查 LLM 辅助配置。

To reply, just mention @dosu.

---

Docs are dead. Just use Dosu.