这篇内容是什么
下面给出 1 条“在线工具生成型 AI 提示词(Prompts)”,用于让 AI 直接产出一个可运行/可构建/可部署的在线工具:Markdown 与 HTML 的互转、批量转换与链接校验工作台。它面向内容运营、开发者、技术写作者与产品团队,在“文档迁移/发布前检查/批量处理”场景里能快速落地一个可用的 Web 工具。
覆盖场景
将旧系统导出的 Markdown 批量转换为 HTML;把历史 HTML 批量回转为 Markdown 方便版本管理;发布前一键扫描站内外链接是否失效;在同一个页面里预览渲染结果并导出结果包。
功能清单(目标工具应实现)
1)单文件互转:Markdown→HTML、HTML→Markdown;2)批量互转:上传 ZIP(或多文件拖拽),输出 ZIP;3)渲染预览:安全渲染 Markdown/HTML,并提供“复制结果”;4)链接校验:对转换前后的文档提取链接,支持并发校验、超时、重试与报告导出;5)可配置:是否保留 HTML 注释、是否开启 GFM 扩展、是否启用 HTML 白名单清理;6)日志与错误提示:对失败文件给出可定位的错误原因。
Prompt(复制到 AI 直接生成完整项目)
你是资深全栈工程师与产品经理。请为我生成一个“Markdown/HTML 批量互转与链接校验工作台”的完整可运行项目代码,要求如下:
【一、交付物(必须全部输出)】
1) 完整源码(前端+后端或全栈同仓),按文件树逐个给出关键文件内容;
2) 清晰的项目文件结构树(tree 形式);
3) 本地运行命令(含 Node 版本建议、依赖安装、启动命令);
4) 构建与部署说明:至少提供 Dockerfile + docker-compose.yml,并说明如何在 Linux 服务器上部署;
5) 测试用例或 QA checklist:包含核心路径、边界条件与异常场景;
6) 许可证与第三方依赖说明(列出使用的主要库及用途)。
【二、产品与交互要求】
- 页面包含 4 个主要区域:输入区(Markdown/HTML)、输出区、预览区、链接校验区;
- 支持粘贴文本与上传文件(.md/.markdown/.html/.htm),并支持上传 ZIP 做批量转换;
- 批量转换:解压 ZIP 后递归处理;输出 ZIP 内保留原目录结构;
- 结果命名规则:.md 转 .html,.html 转 .md;同时输出一个 conversion-report.json(含每个文件的状态、耗时、错误);
- 链接校验:从输入与输出中提取 http/https 链接,去重后并发 HEAD/GET 校验(对不支持 HEAD 的回退 GET),支持并发数与超时设置;
- 安全:渲染预览时必须做 XSS 防护(HTML 需要白名单清理或 sandbox iframe);
- 性能:大文件与批量文件要做流式处理/分块处理的设计说明;
【三、技术栈约束】
- 前端:Vite + React + Type (或 Next.js 亦可,但请说明原因);
- 后端:Node.js + Express(或 Fastify),提供 /api/convert 与 /api/check- s;
- 转换库:Markdown→HTML 可用 markdown-it(可带 GFM 插件),HTML→Markdown 可用 turndown;
- ZIP:使用 JSZip 或类似库;
- 链接校验:使用 undici/fetch 并实现并发控制(例如 p-limit);
- 代码规范:提供 eslint 配置(精简也可)与基础错误处理。
【四、必须包含的页面文案与提示】
- 明确提示“不会生成图片/渲染图/海报/插画”,本工具只做格式转换、预览与校验;
- 给出 2 组示例输入(Markdown 与 HTML),用户可一键填充示例;
【五、输出格式要求】
- 先输出:项目简介(1 段)、功能列表(条目)、文件树;
- 再按文件逐一输出代码(每个文件用清晰的文件名标题标识);
- 最后输出:运行命令、部署说明、测试/QA checklist、已知限制与后续可选增强。
开始生成。
验收清单(用于自检)
项目能在本地一键启动;单文件互转可用;批量 ZIP 转换后目录结构不丢;预览区无脚本注入风险;链接校验能输出可下载报告;Docker 方式能跑通并提供端口与环境变量说明;QA checklist 覆盖大文件、非法编码、空文件、超时链接、重定向与 4xx/5xx。
常见坑与处理建议
HTML→Markdown 的规则需要可配置(例如保留表格/代码块);Markdown 渲染需支持常见扩展但避免注入;链接校验要考虑重定向、HTTPS 证书错误、超时与速率限制;批量处理要注意内存占用与并发控制;报告输出要包含失败原因便于定位。