Markdown to Word Converter

将Markdown文档转换为Word文档的VS Code扩展。

🆕 最新更新 v0.1.14：支持 [TOC] 标记、专业三页文档结构、智能封面页生成！
📋 查看完整更新日志

作者

杨英：抖音：木易君，抖音号：YI_11_13

创作不易，给个关注。爱护你我他。生态靠大家。没钱恰饭了，只能用精神食粮麻醉自己了。

已婚男士，私聊只谈技术，不谈其他（我老婆让我加的 Orz）。

功能

将Markdown文件转换为Word文档
将Markdown文件转换为HTML文档
批量转换Markdown文件
支持自定义配置（字体、颜色、页面大小等）
支持中文路径和文件名
支持命令行直接转换

使用方法

在VS Code中使用

在VS Code中打开一个Markdown文件
右键单击编辑器或文件资源管理器中的文件
选择"生成Word文档"或"配置world文档"
转换完成后，会自动打开生成的Word文档

通过命令行使用

现在支持直接通过命令行参数转换Markdown文件，无需额外确认：

# Windows
code --extensions-dir <扩展目录> <Markdown文件路径>

# macOS
code --extensions-dir <扩展目录> <Markdown文件路径>

# 示例
code --extensions-dir ~/.vscode/extensions "/Users/yingyang/Documents/project/mdworld/AIWorld/资料规则/规则.md"

命令行使用注意事项：

支持包含中文字符的路径
支持包含空格的路径（需要使用引号包围）
转换完成后会自动打开生成的Word文档

配置选项

在VS Code设置中可以配置以下选项：

markdown-to-word.defaultFontFamily: 默认字体
markdown-to-word.defaultFontSize: 默认字号
markdown-to-word.defaultLineSpacing: 默认行间距
markdown-to-word.includeToc: 是否包含目录
markdown-to-word.keepHtml: 是否保留中间HTML文件

功能特点

🚀 一键转换：右键点击 Markdown 文件即可转换为 Word 文档
🎨 精美排版：支持自定义字体、颜色、段落样式等
📊 表格支持：完美呈现 Markdown 表格，并应用表格样式
💻 代码高亮：保留代码块格式和语法高亮
📷 图片处理：自动将图片嵌入到 Word 文档中
📋 智能目录：支持 [TOC] 标记，目录可插入到指定位置
🔄 批量转换：支持转换整个目录下的 Markdown 文件
🌐 HTML转换：支持将Markdown转换为HTML文档

目录功能说明

本插件支持智能目录生成和专业的文档结构：

📄 专业三页文档结构

插件默认生成符合专业文档标准的三页结构：

第一页：封面页 - 自动提取文档标题和开头内容作为封面
第二页：目录页 - 自动生成的完整目录，独占页面
第三页开始：正文 - 文档的主要内容

🎯 目录位置控制

固定位置目录：在配置中启用 generate_toc: true 时，目录会默认生成在第二页
灵活位置目录：在Markdown文档中使用 [TOC] 标记，目录将在该标记位置生成

⚙️ 封面页配置

封面页内容完全基于您的文档实际内容：

document:
  generate_cover: true              # 是否生成封面页
  generate_cover_without_toc: false # 无目录时是否仍生成封面
  # 封面内容自动从文档中提取：
  # - 标题：使用文档的第一个标题
  # - 简介：如果文档开头有描述性内容

封面页特点：

✅ 使用文档的实际标题
✅ 提取文档开头的描述性内容
✅ 不会添加用户未提供的信息（版本号、作者等）
✅ 保持简洁、专业的外观

使用示例：

# 项目技术文档

这是文档介绍。

[TOC]

## 第一章
内容...

## 第二章  
内容...

生成效果：

📄 第1页：封面（标题、版本、作者、日期）
📋 第2页：目录（所有章节的完整列表）
📖 第3页起：正文内容

目录会自动收集文档中的所有标题，并根据配置的深度显示相应级别的标题。在生成的Word文档中，可以右键点击目录区域选择"更新域"来获得准确的页码。

特点优势

纯JavaScript实现：无需安装Python或任何外部依赖
轻量级：安装后即可使用，无需额外配置
高性能：使用Node.js原生模块，转换速度更快
更好的兼容性：适用于所有平台，无需担心Python环境问题

常见问题

Q: 转换后的文档中文字乱码怎么办？
A: 请确保您的系统安装了插件配置中指定的字体，或修改配置中的字体设置。
Q: 如何自定义文档样式？
A: 可以通过VS Code设置中的"Markdown to Word"部分进行基本配置，或使用"编辑配置"命令进行高级配置。
Q: 支持哪些Markdown语法？
A: 支持标准Markdown语法，包括标题、列表、表格、代码块、图片等，以及部分扩展语法。

问题反馈

如果您在使用过程中遇到任何问题，或有任何功能建议，请到GitHub仓库提交Issue或通过抖音、小红书联系作者。 https://github.com/YaYII/md_To_Html_To_World/issues。

Markdown to Word

markdown-to-word