PDF3MD：高效转换PDF与Markdown的利器，提升文档处理效率，支持批量操作与实时进度跟踪。
核心内容：
1. PDF3MD的核心功能：PDF转Markdown、Markdown转Word、多文件上传
2. 用户友好的设计：拖拽式界面、实时进度跟踪、响应式UI
3. 应用场景与安装指南：文档编辑、批量处理、Docker安装步骤

简介

一句话概括：这是一个能把PDF文档干净利落转成Markdown的现代化Web应用。不光如此，它还顺手支持Markdown转Word，并且允许你一次性上传多个文件——对于那些天天跟文档打交道的技术编辑、博客写手来说，这简直就是效率神器。

当然了，说它是“工具”可能有点委屈它。看看它都干了什么：保留了文档的标题、列表、代码块这些结构元素，转换后基本不用再手动调格式；拖拽上传、实时进度跟踪这些常规操作也一个不落。界面响应式设计，手机、平板、电脑都能用，没那么多花里胡哨的，就是实打实解决问题。

主要特点

1. PDF 转 Markdown
   ：核心功能，转换后文档的结构完整性保持得不错，不会出现乱码或格式丢失。

2. Markdown 转 Word (DOCX)
   ：借助Pandoc引擎，把Markdown文本导出为标准的Word文档，适合需要交稿或排版协作的场景。

3. 多文件上传
   ：支持同时处理多个PDF文件，节省重复操作的时间。

4. 拖拽式界面
   ：直接拖文件到浏览器窗口就能上传，比点来点去的文件选择器顺手多了。

5. 实时进度跟踪
   ：转换过程中有状态更新，你能看到每个文件走到哪一步，心里有底。

6. 现代响应式用户界面
   ：UI设计清爽，在不同屏幕尺寸下都能正常操作，没什么学习成本。

应用场景

• 文档转换
  ：技术文档、API手册、项目README，这些场景下PDF转Markdown几乎是刚需。PDF3MD能让你少很多手工复制粘贴的苦力活。

• 内容编辑
  ：先在Markdown里写好内容，格式调整好了再一键导出DOCX给合作伙伴或客户，流程非常顺。

• 批量处理
  ：教育机构的教学材料、出版社的稿件，动辄几十份PDF，用这个工具一次搞定，效率翻倍。

本质上，PDF3MD就是简化了你从“拿到PDF”到“可编辑的Markdown”之间的繁琐步骤。如果你经常卡在文档格式转换这个环节，它会是个很好的帮手。

安装

在群晖上通过 Docker 部署，步骤很常规。这里直接给docker-compose配置，方便一键拉起。

注意：本文写作时，latest版本对应的是 sha-229610b；后续更新请以实际标签为准。

把下面的内容保存为 docker-compose.yml 文件：

services:
  backend:
    image: learnedmachine/pdf3md-backend:latest
    container_name: pdf3md-backend
    restart: unless-stopped
    ports:
      - "6201:6201"
    volumes:
      - ./data:/app/temp
    environment:
      - PYTHONUNBUFFERED=1
      - FLASK_ENV=production
      - TZ=Asia/Shanghai
    healthcheck:
      test: ["CMD", "curl", "-f", "http://localhost:6201/"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 40s

frontend:
    image: learnedmachine/pdf3md-frontend:latest
    container_name: pdf3md-frontend
    restart: unless-stopped
    ports:
      - "6202:3000"
    environment: {}
    depends_on:
      - backend
    healthcheck:
      test: ["CMD", "wget", "--no-verbose", "--tries=1", "--spider", "http://localhost:3000/"]
      interval: 30s
      timeout: 10s
      retries: 3
      start_period: 40s

然后执行：

# 新建文件夹 pdf3md 和子目录
mkdir -p /volume1/docker/pdf3md/data

# 进入 pdf3md 目录
cd /volume1/docker/pdf3md

# 将 docker-compose.yml 放入当前目录

# 一键启动
docker-compose up -d

运行

在浏览器里输入 http://群晖IP:6202，主界面就出来了。简洁直观，没什么多余的干扰。

PDF 转 MD

老苏拿本文在Obsidian里转成PDF格式作为测试素材。

把PDF丢进PDF3MD，转换速度相当快——基本就是几秒钟的事。虽然不能说100%完美复原（比如某些特殊排版可能会有点偏移），但整体效果已经大差不差，可读性没问题。

这里要提醒一句：别拿扫描版PDF去试，因为目前还不支持OCR功能。只有文字版PDF才能正常转换。

MD 转 Word

把Markdown文本粘贴到文本框里，点击转换。相比PDF转MD，这一步会慢一些——毕竟调用了Pandoc在后端做格式生成。

但效果值得等待。字体、段落、标题层级都保留下来了，输出后的Word文档可以直接拿去用，基本不需要二次调整。