【懒人精灵】适合做在线技术文档的几个markdown框架

有许多人问懒人精灵有没有开发文档。

由于懒人精灵有多个版本，包括普通版和高级版，官方对文档这一块也不太重视，导致很多新手入门的时候并没有可靠的文档可以参考和学习。

官方有一个旧版的开发文档，里面的知识点已经跟不上懒人精灵高级版的新增功能。

而高级版目前并没有一个完整的开发文档。因此，在这里给懒人官方推荐几个适合做在线文档的开源模版，仅供参考。

VitePress

VitePress 是一个静态站点生成器 (SSG)，专为构建快速、以内容为中心的站点而设计。简而言之，VitePress 获取用 Markdown 编写的内容，对其应用主题，并生成可以轻松部署到任何地方的静态 HTML 页面。

作为 VuePress 的轻量级继承者，基于 Vue3 和 Vite 构建，主打极速构建和热更新，对 Vue 技术栈开发者友好。默认支持 Markdown 扩展功能，配置简洁，无需复杂操作就能搭建出美观的技术文档或极简博客，适合快速开发 Vue 相关的轻量化文档站点。

如何使用VitePress搭建技术博客？

案例：快点JS-IOS 免越狱自动化测试

VuePress

VuePress 是一个以 Markdown 为中心的静态网站生成器（Static Site Generator, SSG）。你可以使用 Markdown 来书写内容（如文档、博客等），然后 VuePress 会帮助你生成一个静态网站来展示它们。

VuePress 诞生的初衷是为了支持 Vue.js 及其子项目的文档需求，但是现在它已经在帮助大量用户构建他们的文档、博客和其他静态网站。

专为 Vue 生态设计的文档生成器，生态成熟，主题和插件丰富。支持 Markdown 语法扩展与自定义组件嵌入，生成的页面风格简洁统一，是 Vue 项目文档、技术博客的经典选择，比如 Vue 官方部分文档就采用其构建。

除了官方主题之外，应用市场还有一些第三方主题，提供了更强大的扩展功能。

案例：vuepress-reco-一款简洁的 vuepress 博客 & 文档 主题

Docsify

Docsify 是特殊的运行时驱动型生成器，无需构建步骤，直接加载 Markdown 文件即可展示文档。配置极简，能快速搭建轻量级文档或原型，还可通过插件实现 SSR，适合不想处理构建流程、追求快速上线的轻量文档场景，比如小型项目说明文档。

Autojs的开发文档就是用Docsify构建的。

Docusaurus

Docusaurus由 Meta 开发，是 React 生态下的文档专用 SSG。内置版本控制、全文搜索和国际化功能，支持黑暗模式，插件系统丰富，可轻松生成 API 文档等内容。非常适合开源项目搭建结构化、可版本化的文档站，很多 React 生态的开源项目都在用它。

Gatsby

Gatsby基于 React 和 GraphQL 的高性能 SSG，擅长处理内容丰富的站点。能整合多种数据源（如 CMS、本地文件、API 等），通过 GraphQL 统一管理数据，生态中有大量插件可实现图片优化、PWA 等功能，适合搭建内容驱动且交互性强的静态站，比如个人作品集、内容资讯站。

Astro

Astro是现代主流的多框架兼容 SSG，可混合使用 Vue、React、Svelte 等多种前端框架。核心优势是默认输出零 JS 的静态页面，加载速度极快，同时支持 “岛屿架构”，能按需实现页面交互。搭配 Tailwind、MDX 等工具使用体验佳，适合搭建内容为主且追求高性能的网站，如企业宣传站、内容博客。

Next.js

虽是全功能 React 框架，但静态生成（SSG）能力突出，还支持 SSR（服务器端渲染）等混合渲染模式。具备完善的 API 路由功能，可从简单静态站扩展为完整 Web 应用，适合需要高度定制化、兼顾动态内容和 SEO 的场景，比如复杂文档站、电商展示页等。

Hugo

Hugo用 Go 语言开发的高性能 SSG，最大亮点是生成速度极快，处理上千篇文章也能秒级完成构建。支持多语言和复杂内容结构，模板系统灵活，主题丰富，适合搭建多语言企业官网、大型博客等需要高效构建的站点。

Hexo

Hexo是基于 Node.js 的经典博客型 SSG，上手门槛低，插件和主题数量繁多。支持 Markdown，构建速度快，与 GitHub Pages 适配性好，是很多开发者入门搭建个人博客的首选工具，可通过插件扩展实现评论、统计等多种功能。