核心用法
md-web 是一个将 Markdown 转换为可分享网页的实用工具。用户配置 S3 兼容存储(Cloudflare R2/AWS S3 等)后,执行 node upload.js <本地文件> <远程名称> 即可上传。脚本自动部署 Docsify 渲染服务器,生成带时间戳的公开 URL,例如 https://example.r2.dev/index.html#/20260305-091500-api-docs。
显著优点
- 零依赖渲染:Docsify 资源完全本地打包,无外部 CDN 依赖,离线环境可用
- 自动化生命周期:支持配置自动过期(默认30天),避免存储堆积
- 跨平台支持:自动识别 Linux/macOS/Windows 临时目录路径
- 对话零侵入:长内容以链接形式交付,保持聊天上下文整洁
潜在缺点与局限性
- 公开访问风险:所有上传内容默认可公开访问,不适合敏感数据
- 首次配置门槛:需自行准备 S3 存储桶并配置5项必填参数(access_key, secret_key, endpoint, bucket, public_url)
- 权限要求严格:自动过期功能需要 Admin Read & Write 权限,普通 Object 权限仅支持手动清理
- Node.js 依赖:目标环境必须预装 Node.js 运行时
适合人群
- 技术文档撰写者、开发者需分享 API 文档或项目指南
- 需要向非技术人员展示格式化内容的场景
- 希望避免聊天窗口被长文本淹没的高效沟通用户
常规风险
- 误将机密信息上传至公共存储
- 凭证文件
~/.md-web/config.json若权限设置不当可能被同系统其他用户读取 - R2.dev 默认域名存在速率限制,高流量场景应绑定自定义域名