将 Markdown 变成优雅的文档 由 Vite 和 Vue 驱动静态站点生成器 将 Markdown 变成优雅的文档
将 Markdown 变成优雅的文档,只需几分钟
一个静态站点生成器 (SSG),专为构建快速、以内容为中心的站点而设计。简而言之,VitePress 获取用 Markdown 编写的内容,对其应用主题,并生成可以轻松部署到任何地方的静态 HTML 页面。
专注内容 只需 Markdown 即可轻松创建美观的文档站点。
享受 Vite 无可比拟的体验 服务器即时启动,闪电般的热更新,还可以使用基于 Vite 生态的插件。
使用 Vue 自定义 直接在 Markdown 中使用 Vue 语法和组件,或者使用 Vue 组件构建自定义主题。
速度真的很快! 采用静态 HTML 实现快速的页面初次加载,使用客户端路由实现快速的页面切换导航。
使用场景 文档
附带一个专为技术文档设计的默认主题。你现在正在阅读的这个页面以及 Vite、Rollup、Pinia、VueUse、Vitest、D3、UnoCSS、Iconify 等文档都是基于这个主题的。 Vue.js 官方文档也是基于 VitePress 的。但是为了可以在不同的翻译文档之间切换,它自定义了自己的主题。
博客、档案和营销网站
支持完全的自定义主题,具有标准 Vite + Vue 应用程序的开发体验。基于 Vite 构建还意味着可以直接利用其生态系统中丰富的 Vite 插件。此外,VitePress 提供了灵活的 API 来加载数据 (本地或远程),也可以动态生成路由。只要可以在构建时确定数据,就可以使用它来构建几乎任何东西。 Vue.js 官方博客是一个简单的博客页面,它根据本地内容生成其索引页面。
技术选型 开发体验 旨在使用 Markdown 生成内容时提供出色的开发体验。
Vite 驱动 即时服务器启动,始终立即反映 (<100ms) 编辑变化,无需重新加载页面。内置 Markdown 扩展 frontmatter、表格、语法高亮……应有尽有。具体来说,VitePress 提供了许多用于处理代码块的高级功能,使其真正成为技术文档的理想选择。Vue 增强的 Markdown 每个 Markdown 页面都是 Vue 单文件组件,这要归功于 Vue 模板与 HTML 的 100% 语法兼容性。可以使用 Vue 模板语法或导入的 Vue 组件在静态内容中嵌入交互性。
链接: https://pan.baidu.com/s/1u1MMb5ub6rIqZNxwZLLj8Q
提取码下载: