Mdv (mdview-cli) 今日发布

Mdv 是一款命令行 Markdown 预览工具，安装后只需一条命令即可将本地 Markdown 文件渲染为带样式的 HTML 页面并在浏览器中打开。它支持标题、表格、代码块和 Mermaid 图表的标准渲染，适用于开发者在编写文档、接口说明或技术方案时快速查看效果。

该工具提供两种预览模式：分享模式和本地模式。分享模式将文件上传至 mdview.io 生成临时链接，匿名预览有效期为 30 天，文件大小上限为 2MB，适合将文档预览分享给同事或协作者。本地模式则将文件内容直接编码进 URL，所有渲染在浏览器端完成，不经过任何服务器，适合处理包含敏感信息的草稿文档。

对于持续维护的文档，Mdv 支持同步模式。配置免费 CLI 令牌后，每次执行同步命令，文档即发布至私有稳定 URL，文件发生修改时同步命令可自动更新该地址并重新渲染。该模式还会自动检测并修复损坏的 Mermaid 图表，将修复内容写回源文件，同时保留原始文件的带时间戳备份。如果文档中的图表无法自动修复，命令会返回非零状态码而不修改本地文件。开发者可在任意时刻将私有文档公开发布，或直接导出为 PDF。

Mdv 适用于技术写作者、后端工程师和文档维护者。与其将 Markdown 粘贴至在线预览页面，不如在终端中直接执行 mdv 命令完成渲染、分享和导出，适合在 API 文档、架构说明、变更日志等场景中使用。