# VitePress 与 Htmlpress 对比
> 基于 Vite + Vue 的 Markdown 文档与构建纯 HTML 页面的单一二进制文件。
[VitePress](https://vitepress.dev) 是 Vue 官方的文档框架，基于 Vite 构建。它以 Markdown 为先，自带一个极简的默认主题，大多数 Vue 生态的文档（Vue 本身、Vite、Pinia 等）都由它驱动。
## 概览
| 维度 | Htmlpress | VitePress |
| -------- | ------------------------------------ | --------------------- |
| 语言 / 运行时 | Rust（单一二进制文件，无运行时） | TypeScript / Node 18+ |
| UI 框架 | 无（纯 HTML + CSS，`htmlpress-*` Web 组件） | Vue 3 |
| 构建工具 | htmlpress 二进制文件 | Vite（自定义构建流水线） |
| 内容格式 | HTML 和 Markdown 页面 | 支持 Vue 模板的 Markdown |
| 许可证 | MIT，自托管 | MIT，自托管 |
| 输出模式 | 预渲染静态页面 | 预渲染静态页面（SSG） |
## 架构
htmlpress 是一个 Rust 二进制文件，可从 npm（`gethtmlpress`）、PyPI 或 crates.io 安装。它用一个布局包裹每个 HTML 页面，并配上导航和主题；没有打包器、没有 UI 框架，也没有插件 API。每个内置文件——布局、样式、脚本以及每个组件——都可以被覆盖：在 `.htmlpress/` 下的相同路径放一个文件即可替换它。
VitePress 用自己的 SSG 流水线封装 Vite，并渲染 Vue。它的运行时是 `vue-router` 加上一个内置的默认主题。
在 htmlpress 这边，内容布局不受约束：它按 glob 扫描（`htmlpress.yaml` 中的 `include`/`exclude`，默认扫描所有 `.html` 文件），页面的 URL 取决于它在 glob 基础目录下的文件路径，因此 `docs/**/*.html` 会把 `docs/guide.html` 发布在 `/guide/`。不要求存在 `docs/` 文件夹。导航由文件夹结构和每个页面的 `` 构建；文件夹的 `index.html` 为其分组命名。VitePress 要求所有内容都放在单一的源根目录下（默认为 `docs/`，可通过 `srcDir` 配置），路由由文件路径推导而来。
## 内容层面
VitePress 接受内置 Vue 模板支持的 Markdown——你可以在 `.md` 文件中使用 Vue 组件和 `