从 Markdown 到文档站点
用 dumi 写组件文档，最让人觉得"神奇"的体验之一是：在 docs/ 目录下放一个 guide.md，启动 dumi dev，浏览器里就出现了一个 /guide 页面，还带侧边栏导航。不需要配路由，不需要写页面组件，甚至不需要改任何配置。
前端架构, dumi +2
/**
* 我不知道的 dumi
* 共 2 篇文章
*/
export const series = {
name : "我不知道的 dumi" ,
count : 2 ,
guide : "我不知道的 dumi — 系列导读与阅读路径" ,
description : "《我不知道的 dumi》系列导读、阅读路径与文章索引。" ,
};
文章数量： 2 篇
根据不同背景选择入口：
如果想了解 dumi 的整体架构： 按编号 01 → 02 顺序阅读
如果在搭建组件库文档： 重点看 01（SSG 流程与路由）
如果需要跨框架组件展示： 重点看 02（跨框架渲染）
| # | 文章 | 核心内容 |
|---|---|---|
| 01 | 从 Markdown 到文档站点：SSG 流程与约定式路由 | Umi 关系、约定式路由、unified 管线、代码块编译、esbuild/Mako 构建 |
| 02 | 跨框架组件渲染：React 组件如何跑在 Vue 文档里 | Web Components 桥接、Shadow DOM/iframe 隔离、postMessage 通信 |