实时预览
编译器将文件系统操作与核心逻辑分离。因此核心引擎可以完全在浏览器中运行,为实时编辑器与 CMS 预览提供支持,无需 Node.js 后端。
<img width=“720” class=“with-border” src=“/assets/previews/live-editor-preview.webp”>
打开 Live 编辑器Live 编辑器
内置的 Live 编辑器提供了一个高性能的分屏界面。在左侧面板撰写 Markdown,右侧实时同步渲染输出。
本地执行
在项目中本地启动 Live 编辑器:
npx @docmd/core live
静态分发
生成编辑器的独立静态版本。可将其托管在 Vercel 或 GitHub Pages 等平台上:
npx @docmd/core live --build-only
这会生成一个 dist/ 目录。其中包含 index.html 入口点和打包好的 docmd-live.js 引擎。
嵌入 @docmd/core
将浏览器兼容的 bundle 添加到第三方应用,以在客户端渲染 Markdown。
1. 资源集成
从您的资源或 CDN 中引入 CSS 与 JavaScript bundle:
<link rel="stylesheet" href="/assets/css/docmd-main.css">
<script src="/docmd-live.js"></script>
2. 同构 API
全局 docmd 对象暴露 compile 方法用于即时渲染。
const html = await docmd.compile(markdown, {
"title": "Dynamic Preview",
"theme": { "appearance": "dark" }
});
document.getElementById("preview-frame").srcdoc = html;
AI 反馈循环
Live 架构非常适合构建 AI 智能体沙盒 (AI-Agent Sandbox)。将智能体的建议更改传输到实时编译缓冲区,可在将更改提交到仓库之前直观地验证 AI 建议。