Skip to main content

Convert documents to Markdown with MinerU API and GPT-4o-mini

Workflow preview

Workflow preview
100%
Convert documents to Markdown with MinerU API and GPT-4o-mini preview
Open on n8n.io

Important notice

This workflow is provided as-is. Please review and test before using in production.

1. Workflow Overview

How it works This workflow automates the conversion of various document formats (such as PDF, Word, and PPT) into Markdown. It connects to the MinerU API service, which leverages OCR, formula, and ...

Best for

  • Document Extraction automation workflows
  • Multimodal AI automation workflows
  • intermediate n8n builders looking for reusable templates

Tools used

n8n-nodes-base.if, n8n-nodes-base.set, @n8n/n8n-nodes-langchain.mcpclienttool, @n8n/n8n-nodes-langchain.lmchatopenai, @n8n/n8n-nodes-langchain.agent, @n8n/n8n-nodes-langchain.chattrigger, n8n-nodes-base.readwritefile

Source and attribution

This workflow is cataloged by N8N Workflows and links back to its original n8n.io source page by AdrianWang.

Original n8n.io source

1.1 Workflow description

Title
Convert documents to Markdown with MinerU API and GPT-4o-mini
Workflow name
Convert documents to Markdown with MinerU API and GPT-4o-mini

How it works

  • This workflow automates the conversion of various document formats (such as PDF, Word, and PPT) into Markdown. It connects to the MinerU API service, which leverages OCR, formula, and table recognition to produce high-quality output. Users can initiate the process by simply uploading a document through an n8n chat interface.

Set up steps

  • Ensure you have a local n8n instance running.
  • Set up and run the MinerU MCP (MinerU Computing Platform) server locally.
  • Import this workflow into your n8n instance.
  • Configure your AI model credentials (e.g., for OpenAI, add your API Key and Base URL).
  • Click the "Write Files from Disk" node and edit the file path to your desired local save location.
  • Click the "MCP Client" node and input your MinerU MCP server address (e.g., http://localhost:8000/sse).
  • Click the "Open Chat" button to upload a file, send a message, and test the workflow.

1.2 Logical Blocks

This catalog entry is organized from the workflow JSON. The node-level section below shows the executable blocks available for review before importing the template.

2. Block-by-Block Analysis

Block 1 - If 还没遍历结束

Type / Role
n8n-nodes-base.if - if
Config choices
Version 2.2

Block 2 - 初始化files

Type / Role
n8n-nodes-base.set - set
Config choices
Version 3.4

Block 3 - MCP Client

Type / Role
@n8n/n8n-nodes-langchain.mcpClientTool - mcpClientTool
Config choices
Version 1

Block 4 - OpenAI Chat Model

Type / Role
@n8n/n8n-nodes-langchain.lmChatOpenAi - lmChatOpenAi
Config choices
Version 1.2

Block 5 - AI Agent

Type / Role
@n8n/n8n-nodes-langchain.agent - agent
Config choices
Version 1.9

Block 6 - When chat message received

Type / Role
@n8n/n8n-nodes-langchain.chatTrigger - chatTrigger
Config choices
Version 1.1

Block 7 - 添加文件路径到

Type / Role
n8n-nodes-base.set - set
Config choices
Version 3.4

Block 8 - 文件保存到本地

Type / Role
n8n-nodes-base.readWriteFile - readWriteFile
Config choices
Version 1

3. Summary Table

Workflow Convert documents to Markdown with MinerU API and GPT-4o-mini
Complexity intermediate
Nodes 8
Categories Document Extraction, Multimodal AI
Author AdrianWang
Published 09 Jun 2025

4. Reproducing the Workflow from Scratch

  1. 1. Download the workflow JSON

    Use the JSON export at /data/workflows/4808/4808.json as the source template for this automation.

  2. 2. Import the template into n8n

    Open n8n, import the downloaded JSON, and review each node before activating the workflow.

  3. 3. Configure credentials and variables

    Replace placeholder credentials, API keys, webhook URLs, account IDs, and environment-specific values with your own settings.

  4. 4. Test with sample data

    Run the workflow manually or in a staging workspace, inspect node output, and confirm downstream systems receive the expected data.

  5. 5. Activate and monitor

    Enable the workflow only after testing, then monitor executions, errors, and rate limits during the first production runs.

5. General Notes & Resources

Review imported nodes carefully before activation. This catalog entry is intended to help you inspect the workflow structure, understand required services, and find related templates faster.

Node names, credentials, schedules, webhook paths, and external service limits may need adjustment for your workspace.

Frequently asked questions

What does Convert documents to Markdown with MinerU API and GPT-4o-mini do?

How it works This workflow automates the conversion of various document formats (such as PDF, Word, and PPT) into Markdown. It connects to the MinerU API service, which leverages OCR, formula, and ...

What do I need before importing this workflow?

Review the workflow JSON, configure any required credentials in n8n, and test the automation in a safe workspace before using it in production.

Can I customize this workflow?

Yes. Use the block-by-block analysis and the downloadable JSON to inspect each node, then adjust credentials, prompts, schedules, filters, or destinations for your Document Extraction, Multimodal AI use case.