CMS Live Preview | Obsidian 本地 CMS 文章预览插件

资源简介

CMS Live Preview 是一个 local-first 的 Obsidian 桌面端插件，面向“文章写在 Vault 里、页面由本地代码项目渲染”的内容团队与开发者。它不会另造一个简化预览器，而是把当前 MDX 文件映射到真实网站的本地路由，让你直接检查最终会呈现给读者的页面。

本页提供 CMS Live Preview 开源项目 v0.1.0 的官方 Release 下载入口。点击下载按钮后，会先显示随意打赏弹窗；确认后跳转至 GitHub Release 页面，再由你选择下载 ZIP 安装包或其 SHA-256 校验文件。正文不展示文件直链。

核心能力

在真实网站渲染器中预览文章

• 识别已支持的 MDX 内容目录，并映射到对应的本地网站路由
• 在 Obsidian 工作区标签页或系统浏览器中打开真实页面
• 保存当前文章后可按设置刷新预览，便于校对内容、样式与路由

把本地服务状态集中到一个面板

• 检查预览地址与健康检查接口是否可用
• 将 Start、Stop、Refresh、Open、Settings 与进程日志放在同一个界面
• 只有在你明确点击 Start 后才会执行配置好的开发命令，不会自动启动本地服务

为本地内容工作流保留边界

• 不包含遥测、账号体系、分析 SDK 或云端同步
• 配置保存在 Vault 本地的 data.json，不应提交到公开仓库
• 当站点不能嵌入时，可退回系统浏览器查看真实路由

当前支持范围

v0.1.0 目前聚焦两个明确的项目约定：Glowise 与 Bible Note 的文章目录及本地预览路由。它不是通用 CMS，也不是移动端 Obsidian 插件；如果你的项目目录、开发命令或健康检查接口不同，需要在现有适配器基础上自行扩展。

使用前请准备：

• Obsidian Desktop 1.6.0 或更高版本
• 至少一个已在本机检出的受支持网站项目
• 指向本地服务的预览 URL，例如 http://127.0.0.1:3218
• 绝对路径形式的 pnpm 或 npm 可执行文件，避免桌面应用继承不到终端的 PATH

安装与使用

1. 点击本页“下载”按钮；完成随意打赏后会打开项目的官方 GitHub Release 页面。
2. 下载 cms-live-preview-0.1.0.zip，并按需要保留同页的 SHA-256 校验文件。
3. 在 Vault 中创建 .obsidian/plugins/cms-live-preview/，将 ZIP 内容直接解压到该目录；目录顶层应包含 manifest.json、main.js 与 styles.css。
4. 在 Obsidian 的“社区插件”设置中启用 CMS Live Preview；若没有立即出现，可重启 Obsidian 或执行 Reload app without saving。
5. 打开受支持的 MDX 文章，使用侧栏、命令面板或眼睛图标打开预览；服务未启动时，再由你主动点击 Start。

适用人群

• 用 Obsidian 管理 MDX、但需要在真实站点中审阅文章的内容团队
• 同时维护本地博客、知识库或多语言内容路由的开发者
• 希望将“内容编辑、站点预览、健康检查、进程日志”收敛在同一工作流中的个人创作者

开源与安全说明

该项目以 MIT License 发布。它只连接你在设置中指定的本地预览地址，并只在你明确请求后使用预配置的开发命令。请勿把 token、密码、生产环境地址或私有路径写入插件设置或公开 Issue；安装前也不要直接复用示例配置中的占位路径。