README file from
GithubMinerU Converter
English | 简体中文
Quick start
- Apply for a MinerU API token at https://mineru.net/apiManage/apiManage (free tier available).
- In Obsidian → Settings → Community plugins → MinerU Converter, paste the token. Click Test connection.
- Right-click any PDF / Word / PPT / Excel / image → Convert to Markdown via MinerU.
- A
.mdfile appears next to the original.
PDFs longer than 200 pages are split and merged automatically — the output looks identical to a non-split conversion.
Demo

Documentation
- User guide — quick start, settings, oversized PDFs, the Python batch tool, plugin development
- Engineering notes — MinerU v4 API reference, rate limits, edge cases
- Changelog
- Issue tracker
Repository layout
| Path | What's in it |
|---|---|
plugin/ |
The Obsidian plugin (TypeScript → bundled main.js). Ready to install. |
code/ |
Python tools that pre-date the plugin (252-file batch converter). |
docs/ |
API notes, engineering write-ups, and the product plan. |