Markdown 转换器

一个简单易用的在线 Markdown 文件转换工具，可以将包含 Markdown 文件的 ZIP 压缩包转换为 PDF、Word 和 HTML 格式。

功能特性

• 支持上传包含 .md 文件的 ZIP 压缩包
• 自动提取并合并 ZIP 中的所有 Markdown 文件
• 支持转换为三种格式：PDF、Word (.docx)、HTML
• 支持处理 ZIP 中的图片资源
• 提供直观的用户界面和下载链接
• 自动清理临时文件

技术栈

• 前端：HTML5、CSS3、JavaScript
• 后端：Node.js、Express
• 核心库：
  • markdown-it：Markdown 解析
  • html-pdf：HTML 转 PDF
  • docx：生成 Word 文档
  • jszip：ZIP 文件处理
  • multer：文件上传

安装步骤

确保您已安装 Node.js（推荐 v12.0 或更高版本），然后按照以下步骤操作：

1. 克隆或下载本项目到本地

2. 打开命令行，进入项目目录

3. 安装依赖包

   npm install

4. 启动服务器

   npm start

5. 打开浏览器，访问 http://localhost:3000

使用方法

1. 在网页界面上点击 "选择 ZIP 文件" 按钮
2. 选择包含 Markdown 文件的 ZIP 压缩包
3. 点击 "上传并转换" 按钮
4. 等待转换完成（转换时间取决于文件大小）
5. 转换完成后，点击提供的下载链接获取转换后的文件

注意事项

• 确保 ZIP 文件中包含至少一个 .md 格式的文件
• 图片资源可以直接放在 ZIP 根目录或任何子目录中
• 转换后的文件将保存在 output 目录中，并带有时间戳前缀
• 系统会自动清理上传的临时文件
• 对于大文件，转换可能需要较长时间，请耐心等待

常见问题

Q: 为什么我的图片没有显示在转换后的文件中？

A: 请确保图片引用路径与 ZIP 文件中的实际路径匹配，系统会尝试自动识别各种路径模式。

Q: 转换失败怎么办？

A: 请检查错误信息，确保 ZIP 文件格式正确且包含 Markdown 文件，然后重试。

Q: 可以上传单个 Markdown 文件吗？

A: 目前系统仅支持 ZIP 格式上传，如果只有单个 Markdown 文件，请将其放入 ZIP 压缩包中。

License

MIT