Md Web

🌐 Markdown 一键转网页分享

将 Markdown 文件上传至 S3 存储并生成可分享的网页链接,避免长文本刷屏对话。

收藏
5.1k
安装
1.1k
版本
1.0.7
CLS 安全扫描中
预计需要 3 分钟...

使用说明

核心用法

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 默认域名存在速率限制,高流量场景应绑定自定义域名

Md Web 内容

docsify-server文件夹
assets文件夹
手动下载zip · 78.4 kB
countable.min.jstext/javascript
请选择文件