Skip to content

Transforms complex documents like PDFs and Office docs into LLM-ready markdown/JSON for your Agentic workflows.

docs: update demo links and remove legacy AMD guidance

myhlolifa95392f6b97
diff --git a/docs/en/demo/index.md b/docs/en/demo/index.md
deleted file mode 100644
index 5b736153..00000000
--- a/docs/en/demo/index.md
+++ /dev/null
@@ -1,8 +0,0 @@
----
-hide:
- - toc
----
-
-<div class="mineru-demo-page">
-<iframe class="mineru-demo-iframe" src="https://opendatalab-mineru.ms.show" title="MinerU online demo"></iframe>
-</div>
diff --git a/docs/en/quick_start/index.md b/docs/en/quick_start/index.md
index 0268cb76..fa682758 100644
--- a/docs/en/quick_start/index.md
+++ b/docs/en/quick_start/index.md
@@ -1,6 +1,6 @@
# Quick Start
-This guide targets **MinerU 4.x**, including 4.1 automatic device selection and API updates. Existing deployments should read the [4.1 migration guide](../reference/migration_4_1.md). Legacy AMD-specific software-stack and vendor-accelerator instructions remain scoped to `<4`; see the [legacy platform guides](../usage/compatibility.md).
+This guide targets **MinerU 4.x**, including 4.1 automatic device selection and API updates. Existing deployments should read the [4.1 migration guide](../reference/migration_4_1.md). Legacy vendor-accelerator instructions remain scoped to `<4`; see the [legacy platform guides](../usage/compatibility.md).
## Install MinerU
@@ -100,4 +100,4 @@ Confirm a 4.x version; a development checkout may report a prerelease. For NVIDI
- [Model downloads and configuration](../usage/model_source.md)
- [3.x → 4.0 migration](../reference/migration_4.md)
- [4.0.x → 4.1 migration](../reference/migration_4_1.md)
-- [Official application](https://mineru.net/) and [online demos](../demo/index.md)
+- [Official application](https://mineru.net/) and [online demos](https://huggingface.co/spaces/opendatalab/MinerU)
diff --git a/docs/en/reference/migration_4.md b/docs/en/reference/migration_4.md
index e18efe7f..8bfa81f0 100644
--- a/docs/en/reference/migration_4.md
+++ b/docs/en/reference/migration_4.md
@@ -1,6 +1,6 @@
# Migrating from 3.x to 4.0
-4.0 changes command entrypoints, dependency groups, configuration, and APIs. Validate in an isolated environment before migrating production callers. For 4.1, also apply its [HTTP and runtime migration steps](migration_4_1.md). [Legacy guides](../usage/compatibility.md) for AMD-specific software stacks and vendor accelerators remain scoped to `mineru<4`; see [Tiers and runtimes](../usage/tiers.md) for new 4.1 Windows/Linux ONNX support.
+4.0 changes command entrypoints, dependency groups, configuration, and APIs. Validate in an isolated environment before migrating production callers. For 4.1, also apply its [HTTP and runtime migration steps](migration_4_1.md). [Legacy guides](../usage/compatibility.md) for vendor accelerators remain scoped to `mineru<4`; see [Tiers and runtimes](../usage/tiers.md) for new 4.1 Windows/Linux ONNX support.
## Entrypoints and installation
diff --git a/docs/en/usage/compatibility.md b/docs/en/usage/compatibility.md
index cee736ef..6a7ff489 100644
--- a/docs/en/usage/compatibility.md
+++ b/docs/en/usage/compatibility.md
@@ -1,6 +1,6 @@
# Legacy Platform Adaptations (MinerU <4)
-The following 13 platforms retain their existing adaptations, **for MinerU <4 only**. Mainline 4.0 dependency, model, and command changes do not extend these platforms' compatibility coverage.
+The following 12 platforms retain their existing adaptations, **for MinerU <4 only**. Mainline 4.0 dependency, model, and command changes do not extend these platforms' compatibility coverage.
The nine dedicated Dockerfiles retain their original extras and use `>=3.4.0,<4`, for example:
@@ -25,7 +25,6 @@ The retained platform guides are in Chinese.
- [Kunlunxin](https://opendatalab.github.io/MinerU/zh/usage/acceleration_cards/Kunlunxin/)
- [Tecorigin](https://opendatalab.github.io/MinerU/zh/usage/acceleration_cards/Tecorigin/)
- [Biren](https://opendatalab.github.io/MinerU/zh/usage/acceleration_cards/Biren/)
-- [AMD](https://opendatalab.github.io/MinerU/zh/usage/acceleration_cards/AMD/)
- [VastAI](https://opendatalab.github.io/MinerU/zh/usage/acceleration_cards/VastAI/)
## Legacy commands and references
diff --git a/docs/en/usage/tiers.md b/docs/en/usage/tiers.md
index 6bcae6eb..bf591639 100644
--- a/docs/en/usage/tiers.md
+++ b/docs/en/usage/tiers.md
@@ -70,6 +70,6 @@ detect shares API startup recommendations and may perform applicable ONNX calibr
Native text parsing needs no inference models. Basic can run on CPU. Standard / Advanced speed and memory depend on the VLM engine, input size, and concurrency. Plan for at least 16 GB of system memory for higher-throughput local deployment. NVIDIA deployments also need an engine-supported GPU, driver, and sufficient free VRAM; 8 GB is only a planning starting point, not a guarantee for every workload.
-For Apple Silicon, at least 16 GB of unified memory and a direct macOS installation are recommended. The 4.1 Windows/Linux ONNX path supports compatible Intel, AMD, and NVIDIA GPUs; legacy AMD-specific software-stack and vendor-accelerator guides remain scoped to [MinerU <4](compatibility.md).
+For Apple Silicon, at least 16 GB of unified memory and a direct macOS installation are recommended. The 4.1 Windows/Linux ONNX path supports compatible Intel, AMD, and NVIDIA GPUs; legacy vendor-accelerator guides remain scoped to [MinerU <4](compatibility.md).
See [extension modules](../quick_start/extension_modules.md) for installation and [Model Source](model_source.md) for downloads and configuration.
diff --git a/docs/stylesheets/extra.css b/docs/stylesheets/extra.css
deleted file mode 100644
index e71a3a91..00000000
--- a/docs/stylesheets/extra.css
+++ /dev/null
@@ -1,40 +0,0 @@
-/* demo 页面嵌入 Gradio,需要隐藏右侧目录列并释放主内容宽度。 */
-.md-main__inner:has(.mineru-demo-page) {
- width: min(calc(100% - 3rem), 112rem);
- max-width: none;
- margin-inline: auto;
-}
-
-.md-main__inner:has(.mineru-demo-page) .md-sidebar--secondary {
- display: none;
-}
-
-.md-main__inner:has(.mineru-demo-page) .md-content {
- max-width: none;
-}
-
-.md-main__inner:has(.mineru-demo-page) .md-content__inner {
- margin-right: 0;
-}
-
-.mineru-demo-page {
- width: 100%;
-}
-
-.mineru-demo-iframe {
- display: block;
- width: 100%;
- height: clamp(1180px, calc(100vh + 16rem), 1360px);
- border: 0;
- overflow: auto;
-}
-
-@media screen and (max-width: 76.2344em) {
- .md-main__inner:has(.mineru-demo-page) {
- width: 100%;
- }
-
- .mineru-demo-iframe {
- height: clamp(640px, calc(100vh - 8rem), 960px);
- }
-}
diff --git a/docs/zh/demo/index.md b/docs/zh/demo/index.md
deleted file mode 100644
index aed951c7..00000000
--- a/docs/zh/demo/index.md
+++ /dev/null
@@ -1,8 +0,0 @@
----
-hide:
- - toc
----
-
-<div class="mineru-demo-page">
-<iframe class="mineru-demo-iframe" src="https://opendatalab-mineru.ms.show" title="MinerU 在线演示"></iframe>
-</div>
diff --git a/docs/zh/quick_start/index.md b/docs/zh/quick_start/index.md
index 6badbaed..be4e7cc5 100644
--- a/docs/zh/quick_start/index.md
+++ b/docs/zh/quick_start/index.md
@@ -1,6 +1,6 @@
# 快速入门
-本指南面向 MinerU **4.x**,包含 4.1 自动设备选择与 API 更新。已有部署请阅读 [4.1 迁移说明](../reference/migration_4_1.md)。AMD 专用软件栈和国产卡的旧适配教程仍适用于 `<4`,见[旧平台指南](../usage/compatibility.md)。
+本指南面向 MinerU **4.x**,包含 4.1 自动设备选择与 API 更新。已有部署请阅读 [4.1 迁移说明](../reference/migration_4_1.md)。国产卡的旧适配教程仍适用于 `<4`,见[旧平台指南](../usage/compatibility.md)。
## 安装 MinerU
@@ -100,4 +100,4 @@ mineru version --json
- [模型下载与配置](../usage/model_source.md)
- [3.x → 4.0 迁移](../reference/migration_4.md)
- [4.0.x → 4.1 迁移](../reference/migration_4_1.md)
-- [官网](https://mineru.net/)与[在线演示](../demo/index.md)
+- [官网](https://mineru.net/)与[在线演示](https://www.modelscope.cn/studios/OpenDataLab/MinerU)
diff --git a/docs/zh/reference/migration_4.md b/docs/zh/reference/migration_4.md
index 0f821fc6..82640791 100644
--- a/docs/zh/reference/migration_4.md
+++ b/docs/zh/reference/migration_4.md
@@ -1,6 +1,6 @@
# 从 3.x 迁移到 4.0
-4.0 调整了命令入口、依赖组合、配置和 API。先使用独立环境验证,再迁移生产调用。升级到 4.1 时,还需应用 [4.1 迁移说明](migration_4_1.md)中的 HTTP 协议和环境调整。AMD 专用软件栈及国产卡的[旧平台指南](../usage/compatibility.md)仍限制 `mineru<4`;4.1 新增的 Windows/Linux ONNX 设备支持见[档位与运行环境](../usage/tiers.md)。
+4.0 调整了命令入口、依赖组合、配置和 API。先使用独立环境验证,再迁移生产调用。升级到 4.1 时,还需应用 [4.1 迁移说明](migration_4_1.md)中的 HTTP 协议和环境调整。国产卡的[旧平台指南](../usage/compatibility.md)仍限制 `mineru<4`;4.1 新增的 Windows/Linux ONNX 设备支持见[档位与运行环境](../usage/tiers.md)。
## 入口与安装
diff --git a/docs/zh/usage/acceleration_cards/AMD.md b/docs/zh/usage/acceleration_cards/AMD.md
deleted file mode 100644
index 226920b1..00000000
--- a/docs/zh/usage/acceleration_cards/AMD.md
+++ /dev/null
@@ -1,6 +0,0 @@
-> [!NOTE]
-> **旧版适配,仅适用于 MinerU <4。** 本页保留原平台依赖、模型和命令;4.0 不沿用此适配保证。
-> 安装或升级时必须保留 `mineru<4`;已有固定版本、提交或厂商镜像继续按原方案使用,不要替换为 4.0 的安装命令。
-> 通用说明见[旧平台版本约束](../compatibility.md)。
-
-https://github.com/opendatalab/MinerU/discussions/3662
\ No newline at end of file
diff --git a/docs/zh/usage/compatibility.md b/docs/zh/usage/compatibility.md
index 101d3deb..5a509518 100644
--- a/docs/zh/usage/compatibility.md
+++ b/docs/zh/usage/compatibility.md
@@ -1,6 +1,6 @@
# 旧平台适配(MinerU <4)
-以下 13 个平台保留已有适配方案,**仅适用于 MinerU <4**。主线 4.0 的依赖、模型和命令变更不自动扩展这些平台的兼容范围。
+以下 12 个平台保留已有适配方案,**仅适用于 MinerU <4**。主线 4.0 的依赖、模型和命令变更不自动扩展这些平台的兼容范围。
9 个专用 Dockerfile 的 MinerU 依赖为原 extras 与 `>=3.4.0,<4`。例如:
@@ -23,7 +23,6 @@ python -m pip install "mineru[core]>=3.4.0,<4"
- [昆仑芯 / Kunlunxin](acceleration_cards/Kunlunxin.md)
- [太初元碁 / Tecorigin](acceleration_cards/Tecorigin.md)
- [壁仞 / Biren](acceleration_cards/Biren.md)
-- [AMD](acceleration_cards/AMD.md)
- [瀚博 / VastAI](acceleration_cards/VastAI.md)
## 旧版入口与资料
diff --git a/docs/zh/usage/index.md b/docs/zh/usage/index.md
index cb3d6c0d..5033faac 100644
--- a/docs/zh/usage/index.md
+++ b/docs/zh/usage/index.md
@@ -16,7 +16,7 @@
* [模型源配置](./model_source.md) - 模型源的详细配置说明
* [命令行工具](./cli_tools.md) - 命令行工具的详细参数说明
* [命令行进阶参数](./advanced_cli_parameters.md) - 一些适配命令行工具的进阶参数说明
-- [旧平台适配(MinerU <4)](compatibility.md) - AMD 与国产卡保留原适配
+- [旧平台适配(MinerU <4)](compatibility.md) - 国产卡保留原适配
- 插件与生态(保留原集成说明,不代表已支持 4.0 V1 API)
* [Cherry Studio](plugin/Cherry_Studio.md)
* [Sider](plugin/Sider.md)
diff --git a/docs/zh/usage/tiers.md b/docs/zh/usage/tiers.md
index c51b9dec..51f5b2ac 100644
--- a/docs/zh/usage/tiers.md
+++ b/docs/zh/usage/tiers.md
@@ -70,6 +70,6 @@ detect 与 API 自动启动共用推荐逻辑,可能执行适用的 ONNX 校
原生文本解析不需要推理模型。Basic 可在 CPU 运行;Standard / Advanced 的速度和内存占用取决于 VLM 引擎、输入规模和并发。高吞吐本地部署建议至少 16 GB 系统内存;NVIDIA 部署还需要所选引擎支持的显卡、驱动和足够可用显存,8 GB 仅作为规划起点,不是所有任务的保证。
-Apple Silicon 建议使用至少 16 GB 统一内存并直接在 macOS 安装。4.1 的 Windows/Linux ONNX 路径支持兼容的 Intel、AMD、NVIDIA GPU;既有 AMD 专用软件栈和国产卡的旧适配教程仍以 [MinerU <4](compatibility.md) 为适用范围。
+Apple Silicon 建议使用至少 16 GB 统一内存并直接在 macOS 安装。4.1 的 Windows/Linux ONNX 路径支持兼容的 Intel、AMD、NVIDIA GPU;国产卡的旧适配教程仍以 [MinerU <4](compatibility.md) 为适用范围。
安装组合见[扩展模块](../quick_start/extension_modules.md),下载与配置见[模型源](model_source.md)。
diff --git a/mkdocs.yml b/mkdocs.yml
index 75cf5f20..1a98a1fe 100644
--- a/mkdocs.yml
+++ b/mkdocs.yml
@@ -71,17 +71,18 @@ extra:
copyright: © 2024 - 2025 MinerU. All Rights Reserved.
-extra_css:
- - stylesheets/extra.css
-
+# 复用公共导航项,中文仅覆盖在线演示的目标地址。
nav:
- Home:
- - "MinerU": index.md
- - Quick Start:
+ - &nav_home
+ "MinerU": index.md
+ - &nav_quick_start
+ Quick Start:
- Quick Start: quick_start/index.md
- Extension Modules: quick_start/extension_modules.md
- Docker Deployment: quick_start/docker_deployment.md
- - Usage:
+ - &nav_usage
+ Usage:
- Usage: usage/index.md
- Quick Usage: usage/quick_usage.md
- Tiers and Runtimes: usage/tiers.md
@@ -93,42 +94,22 @@ nav:
- Model Source: usage/model_source.md
- CLI Tools: usage/cli_tools.md
- Advanced CLI Parameters: usage/advanced_cli_parameters.md
- - Reference:
+ - &nav_reference
+ Reference:
- Reference: reference/index.md
- Migration to 4.0: reference/migration_4.md
- Migration to 4.1: reference/migration_4_1.md
- Output File Format: reference/output_files.md
- Changelog: reference/changelog.md
- - FAQ:
+ - &nav_faq
+ FAQ:
- FAQ: faq/index.md
- - Demo:
- - Demo: demo/index.md
- - Quick Start:
- - Quick Start: quick_start/index.md
- - Extension Modules: quick_start/extension_modules.md
- - Docker Deployment: quick_start/docker_deployment.md
- - Usage:
- - Usage: usage/index.md
- - Quick Usage: usage/quick_usage.md
- - Tiers and Runtimes: usage/tiers.md
- - Python SDK: usage/sdk_api.md
- - V1 HTTP API: usage/http_api.md
- - Tasks API: usage/tasks.md
- - Synchronous File Parse: usage/file_parse.md
- - Legacy Platforms (MinerU <4): usage/compatibility.md
- - Model Source: usage/model_source.md
- - CLI Tools: usage/cli_tools.md
- - Advanced CLI Parameters: usage/advanced_cli_parameters.md
- - Reference:
- - Reference: reference/index.md
- - Migration to 4.0: reference/migration_4.md
- - Migration to 4.1: reference/migration_4_1.md
- - Output File Format: reference/output_files.md
- - Changelog: reference/changelog.md
- - FAQ:
- - FAQ: faq/index.md
- - Demo:
- - Demo: demo/index.md
+ - Demo: https://huggingface.co/spaces/opendatalab/MinerU
+ - *nav_quick_start
+ - *nav_usage
+ - *nav_reference
+ - *nav_faq
+ - Demo: https://huggingface.co/spaces/opendatalab/MinerU
plugins:
@@ -146,6 +127,19 @@ plugins:
- locale: zh
name: 中文
build: true
+ nav:
+ - Home:
+ - *nav_home
+ - *nav_quick_start
+ - *nav_usage
+ - *nav_reference
+ - *nav_faq
+ - Demo: https://www.modelscope.cn/studios/OpenDataLab/MinerU
+ - *nav_quick_start
+ - *nav_usage
+ - *nav_reference
+ - *nav_faq
+ - Demo: https://www.modelscope.cn/studios/OpenDataLab/MinerU
nav_translations:
Home: 主页
Quick Start: 快速入门