超炫之家

文档

doc

# 一、文档转换

# 1.1 MD转DOCX

# 工具：Pandoc

# 一、工具简介

Pandoc 是一款免费开源、跨平台、轻量高效的命令行文档格式转换工具，被称为文档转换领域的“瑞士军刀”，由 Haskell 语言开发，无广告、无水印、无文件大小限制，支持百余种文档格式双向互转。

核心适配日常办公场景，完美兼容MD、DOCX、PDF、HTML、LaTeX、EPUB 等主流格式，转换稳定性强，可精准保留标题、表格、列表、公式、图片、排版样式，是学术写作、文档批量转换、自动化办公的标准工具。

工具优势：本地离线转换、不泄露文档隐私、支持自定义转换参数、适配 Windows/Mac/Linux 全平台、占用资源极低；仅支持命令行操作，无图形界面，上手简单、命令通用。

# 二、官方下载地址
  1. 总安装页：https://www.pandoc.org/installing.html (opens new window)
  2. 最新版直达（GitHub）：https://github.com/jgm/pandoc/releases/latest (opens new window)

Windows下载对应文件，往下翻找到Assets，下载：

pandoc-xxx-windows-x86_64.msi
1

（64 位系统，绝大多数电脑都是这个）

# 三、安装步骤
  1. 双击 .msi 安装包，全程默认路径安装（不要改中文路径）。
  2. 安装程序自动写入系统环境变量 PATH，不用手动配置。
  3. 安装完成 。
# 四、安装校验

  1. Win+R 输入 cmd 打开命令提示符

  2. 输入命令：

    pandoc --version
    1

    出现版本号 = 安装正常；提示不是内部命令 = 安装失败 / 没重启电脑

# 五、使用

  1. 将 md 文件放到纯英文无空格路径（例如桌面 test.md）

  2. 打开 md 所在文件夹，地址栏输入cmd回车，打开当前目录终端

  3. 执行转换命令

    pandoc -s test.md -o test.docx
    1

    test替换为实际文件名。

    运行无报错就会在同目录生成 docx 文件。

# 1.2 DOCX转MD

# 工具：Pandoc

已安装 Pandoc 可直接使用极简命令，快速转换：

pandoc -s test.docx -o test.md
1

# 工具：word2md-main

# 一、工具简介

word2md-main 是开源本地转换工具，基于 Python 开发，精准还原 Word 标题、表格、列表、图片、样式等格式，无文件上传、不泄露隐私。

# 二、前置环境

需提前安装 Python3.8 及以上版本

  1. 下载地址：https://www.python.org/downloads/ (opens new window)

  2. 安装必须勾选：Add Python to PATH

  3. 终端校验：

    python --version
    1
# 三、工具下载

开源地址：https://github.com/benliao/word2md (opens new window)

  1. 点击 Code → Download ZIP 下载压缩包

  2. 解压至 纯英文无空格路径

  3. 进入解压后的根目录，地址栏输入 cmd 打开终端

# 四、安装依赖
# 官方源
pip install -r requirements.txt

# 清华镜像加速（推荐）
pip install -r requirements.txt -i https://pypi.tuna.tsinghua.edu.cn/simple
1
2
3
4
5
# 五、文件配置

  1. 在项目根目录新建 input 文件夹

  2. 将需要转换的 .docx 文件放入 input 文件夹（无中文、无空格文件名）

# 六、转换命令
# 批量转换 input 内所有文档
python word2md.py

# 单个文件精准转换
python word2md.py --file input/demo.docx

# 转换并提取文档图片
python word2md.py --extract-img
1
2
3
4
5
6
7
8
# 七、结果输出

转换完成后，MD 文件与图片资源自动保存至项目 output 文件夹

Email