Markdown2word MCP

MCP文档知识

提供方 413232903

文档知识 未标注 无需鉴权 社区 / 第三方

md2doc-plus是一款基于Java和Apache POI的轻量级工具,能够将Markdown文档转换为格式化的Word文档,支持文本、表格和图表等多种内容元素。

一句话选型结论

按资料字段整理

Markdown2word MCP 属于文档知识类 MCP 服务器,传输方式未标注,无需鉴权,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类文档知识 传输方式未标注 鉴权无需鉴权 部署方式未标注
GitHub 星标 2 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

文档知识
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

文档转换Java本地部署Markdown处理Word生成Java工具ECharts集成

安装与配置

未标注 无需鉴权
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
文档检索问答

在你的文档库里按问题找答案。

知识库读写

把新资料写进知识库,随用随取。

内容整理

把零散资料归纳成结构化笔记。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注无需鉴权,装好就能连。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在文档知识场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Markdown2word MCP当前 未标注 未标注 未标注 无 2026-05-17
dify 未标注 stdio · 本地进程 本地部署 有 2026-04-11
open-webui 未标注 stdio · 本地进程 本地部署 有 2026-04-11
JeecgBoot 未标注 stdio · 本地进程 本地部署 有 2026-04-11
Cherry Studio 未标注 未标注 未标注 无 2026-05-17
mempalace 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

文档知识
字段来自项目仓库与公开索引,中文说明由本站标注
提供方413232903上游标注的维护方 413232903
分类文档知识本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式无需鉴权远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

7.0 KB
来自项目仓库与上游目录的原文,未做删改

Markdown 转 Word 文档工具 (md2doc-plus)

项目源于我们开发的一款基于大模型的报告生成工具。由于需要将Markdown格式的内容导出为Word文档,而市面上缺乏合适的现成工具。

项目简介

md2doc-plus 是一个基于 Java 17 和 Apache POI 的轻量级 Markdown 转 Word 文档工具。它可以将 Markdown 格式的文档转换为格式化的 Word (.docx) 文档,支持文本、表格和图表等多种内容元素。

核心功能

  1. 动态word模板生成

系统能够根据 Markdown 内容结构动态生成 Word 模板,为后续内容填充预留占位符。

  1. Markdown 各级标题与段落文本支持

完整支持 Markdown 的六级标题(H1-H6)以及普通段落文本的转换。系统会自动识别标题级别,并应用相应的格式化样式,包括字体大小、加粗等属性。

  1. Markdown 表格转换

能够准确解析并转换 Markdown 表格语法,将表格内容转换为 Word 中的表格对象,保持原有的行列结构和数据内容。

  1. ECharts图表集成

支持将 Markdown 中的 ECharts 图表配置代码块转换为 Word 中的图表对象,包括自动识别 ECharts 代码块、解析 ECharts 配置并提取图表数据、在 Word 文档中生成对应的图表对象、支持多种图表类型(柱状图、折线图、饼图等);

  1. 章节标题自动添加序号、标题格式

具备自动化标题编号功能,能够根据标题层级自动为章节标题添加序号(如 1.1、1.2、2.1 等),并应用标准的标题样式。这使得生成的 Word 文档可以直接用于创建目录,极大地提升了文档的专业性和可用性。

技术架构与实现思路

核心组件

  1. Markdown 解析器
    - 使用正则表达式匹配各种 Markdown 元素
    - MarkdownToWordConverter 作为主转换器,协调各组件工作

  2. 模板引擎
    - DynamicWordDocumentCreator 动态创建 Word 模板
    - 根据 Markdown 内容结构生成占位符

  3. 内容处理器
    - MarkdownTableParser 专门处理表格解析
    - EChartsToWordConverter 处理图表转换

  4. 文档生成器
    - PoiWordGenerator 基于 Apache POI 实现 Word 文档生成
    - 替换模板中的占位符并填充实际内容

工作流程

  1. 读取 Markdown 文件内容
  2. 解析 Markdown 内容,识别各种元素(标题、段落、表格、图表等)
  3. 根据内容结构动态创建 Word 模板文件
  4. 将解析后的内容数据填充到模板中
  5. 生成最终的 Word 文档

使用方法

基本使用```java

// 转换 Markdown 文件到 Word 文档
MarkdownToWordConverter.convertMarkdownFileToWord(
"input.md",
"output.docx"
);


### 测试示例

参考 Test.java 文件:```java
public static void main(String[] args) throws Exception {
MarkdownToWordConverter markdownToWordConverter = new MarkdownToWordConverter();
markdownToWordConverter.convertMarkdownFileToWord("./markdown/未命名.md",
"./word/未命名_output.docx");
}

依赖技术栈

  • Java 17
  • Apache POI 5.2.2 (Word 文档处理)
  • Jackson 2.12.4 (JSON 解析)
  • Lombok 1.18.30 (简化 Java 代码)
  • Maven 3.8.1 (项目构建)

案例效果

原始markdown文件:

转换后的word文档:

存在的问题

~~1. word章节标题样式缺失,无法自动生成目录;(已解决)~~

~~2. 图表样式缺失,图表显示不全,需手动调整;(已解决)~~

~~3. 标题序号缺失、标题格式缺失,不能自动列出目录;(已解决)~~

更新记录

  • 2025-11-08:MCP 工具现在会返回可直接下载的 Word 链接,不再需要手动解码 Base64;新增配置 md2doc.download-base-url 用于控制外部访问地址;增加 md2doc.temp-file-retention-days 配置,用于控制临时目录中文件的保留天数(默认 10 天),系统会在每天凌晨自动清理过期文件。
  • 2025-11-08:MCP 返回结果新增 files 字段,自动携带 Word 下载链接,适配 Dify 等需要文件列表的工作流平台。
  • 2025-11-09:修复网络图片在 Word 中丢失的问题,统一按照图片原格式写入;增强 Markdown 内联语法和列表渲染,**粗体**、__粗体__、_斜体_、行内代码及 Markdown 列表可正确呈现;放宽表格解析并调整 Word 表格宽度和单元格边距,改善阅读体验。
  • 2025-11-18:MCP 工具返回格式优化,直接返回文件下载 URL 字符串,简化调用方式。

路由冲突排查与优化

在将多个 MCP 服务统一映射到一个公网域名时,最常见的故障是网关层转发的路径与服务端真正监听的路径不一致。本项目的 MCP SSE 端点默认写死为 /dataReport/md2doc,当网关 (Nginx、API Gateway 等) 再包一层前缀(例如 /ai-tools/dataReport/md2doc)或已有别的服务占用了 /dataReport/md2doc 时,后端收到的请求路径就会变成别的值,从而返回 404 或被错误的服务处理。

排查步骤:
- 确认 md2doc-service/src/main/resources/application.yml 中 spring.ai.mcp.server.sse-endpoint 的值,目前默认为 /dataReport/md2doc。
- 在网关上执行 curl -i https://your-domain/实际访问路径,查看响应头里的 X-Upstream-Response / Via 等信息,确认真正命中的服务。
- 查看网关配置中对应的 location / routes,确认是否做了 rewrite 或拼接了额外前缀。

推荐解决思路:
- 方式一:在网关层做路径改写。 例如 Nginx:nginx location /ai-tools/dataReport/md2doc/ { proxy_set_header Host $host; proxy_set_header X-Real-IP $remote_addr; proxy_pass http://md2doc_backend/dataReport/md2doc/; }
proxy_pass 写成以 /dataReport/md2doc/ 结尾,可自动把 /ai-tools/dataReport/md2doc/ 前缀裁掉,后端仍然收到 /dataReport/md2doc。
- 方式二:修改服务端端点。 如果网关无法改动,可在 application.yml 里把 sse-endpoint 改成其它不冲突的路径(如 /dataReport/md2doc),同时同步更新所有 MCP 客户端配置。
- 方式三:为不同服务使用不同二级域名(如 md2doc-mcp.example.com),彻底避免路径冲突。

落地建议:
- 先在测试环境验证改写或端点调整是否正常握手 (使用 curl -N -H "Accept: text/event-stream" 测试 SSE)。
- 调整后及时更新部署文档与客户端配置文件,避免团队成员继续使用旧地址。

开发小结与改进建议

  • 本次改动把临时文件目录复用为下载目录,避免重复写入文件,整体性能稳定。
  • 下载链接依赖于运行环境的基础 URL,建议在部署时按实际域名或 IP 设置 md2doc.download-base-url,防止默认的 http://localhost:8080 影响外网访问。
  • 临时文件已加入定时清理机制,若需要更长的保留时间,可调整 md2doc.temp-file-retention-days。
  • Markdown 转换链路新增图片格式自适应与列表、表格优化,生成的 Word 文档样式更接近原始排版;后续可考虑加入更多 Markdown 扩展语法(如任务列表、引用)以提升兼容度。

常见问题

5 问
答案由本站依据条目字段整理,不引用上游原文
Markdown2word MCP 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

Markdown2word MCP 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

Markdown2word MCP 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Markdown2word MCP 需要 API Key 吗?

资料标注为无需认证,装好就能连;如果实际调用时报鉴权错误,按官方文档补上凭据。

Markdown2word MCP 能提供哪些能力?

资料显示能力标签包括 文档转换、Java、文档处理。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。