Skip to content

mdToDoc v1.0.0

Latest
Latest

Choose a tag to compare

View all tags
@github-actions github-actions released this 11 Apr 17:46
· 2 commits to master since this release
v1.0.0
648e2b1

mdToDoc V1.0.0 Release Notes

发布日期：2026-04-11

版本概览

V1.0.0 是 mdToDoc 的首个可发布版本。

这一版已经具备完整的 Markdown 转 Word 主链，既可以通过 CLI 使用，也可以通过 Windows 桌面 GUI 发起真实转换任务。

本版本包含的能力

1. Markdown 转 Word 主链可用

  • 支持 check 和 convert 两类 CLI 能力
  • 支持单文件转换
  • 支持目录批量转换
  • 支持 Mermaid 预处理后再进入 Pandoc 转换
  • 支持 Word COM 后处理

2. Windows 桌面 GUI 可用

当前 GUI 已支持：

  • 环境检查
  • 转换工作台
  • 批量进度
  • 历史记录
  • 设置
  • 帮助
  • 打开输出目录
  • 取消当前任务
  • 最近一次请求整批重试

3. 批量目录转换增强

  • 输出目录可按源目录结构生成 DOCX
  • 递归扫描时自动过滤 .tmp 目录
  • 文件状态和日志按任务进度逐项更新

4. 发布基础设施

  • 版本号统一为 1.0.0
  • 新增统一发布前测试脚本
  • 新增最小 CI 工作流
  • 新增 Windows 便携打包脚本
  • 新增 v* tag 自动创建 GitHub Release 的工作流

适用环境

  • Windows
  • Python 3.13+
  • Microsoft Word
  • Pandoc
  • Mermaid CLI

已验证内容

发布前已实际执行：

powershell -ExecutionPolicy Bypass -File .\scripts\test_release.ps1

结果：

  • 123 passed

并再次执行完整回归：

powershell -ExecutionPolicy Bypass -File .\scripts\build_release.ps1

结果：

  • 打包成功，生成 Windows GUI/CLI 产物

已知限制

  • 失败项精确重试尚未支持
  • 更细粒度的进度统计和耗时展示尚未支持
  • 当前版本提供 Windows 便携 zip 包，不提供安装器
  • GUI 视觉还可以继续打磨，但功能链已可用于真实验收

建议使用方式

CLI

环境检查：

python main.py check --template E:\md_doc\docTemplate\template.docx --config E:\md_doc\config\mapping.yaml

GUI 启动：

E:\md_doc\.venv\Scripts\python.exe -m src.md_to_doc.gui.app

下一步计划

  • 增加失败项精确重试
  • 继续做 GUI 视觉收口
Assets 3
Loading