VuePress创建博客 | OnThis.cc
VuePress 本身是一个以 Markdown 为中心的静态网站生成器,既可以用于构建技术文档(Docs),也可以用于搭建博客(Blog)。虽然底层工具相同,但用途、结构和配置重点不同。以下是两者的主要区别:
核心区别
目的不同
- Docs(文档):侧重于结构化、层级清晰的内容展示,如 API 文档、使用指南、教程等。
- Blog(博客):侧重于时间线、分类和互动性,适合分享观点、心得、项目更新等。
内容组织方式不同
- Docs:按功能模块或章节组织,常使用侧边栏导航,强调逻辑顺序。
- Blog:按时间或标签/分类组织,常有归档页、标签云、首页文章列表等。
默认主题与功能差异
- Docs:使用 VuePress 默认主题,突出导航、搜索、代码块高亮等功能。
- Blog:通常使用专门的博客主题(如 vuepress-theme-blog),支持评论、归档、分类、响应式布局等。
配置侧重点不同
- Docs:配置更关注侧边栏深度、页面元数据、版本控制等。
- Blog:配置更关注首页文章列表、作者信息、社交分享、SEO 优化等。
技术实现上的共通性
- 两者都基于 Vue.js + Markdown,可复用相同组件、插件和部署方式(如 GitHub Pages、Vercel、腾讯云等)。
- 都都支持自定义主题、插件扩展、SEO 优化。
可在同一个 VuePress 项目中同时包含 Docs 和 Blog 内容,通过目录结构区分(如 /docs/ 和 /blog/)。
如何选择?
- 如果你主要想写技术文档、API 说明、使用手册 → 选择 Docs 模式。
- 如果你主要想定期发布文章、建立个人品牌、与读者互动 → 选择 Blog 模式。
- 如果两者都需要 → 可在一个项目中混合使用,通过目录和主题配置区分。
提示:VuePress 官方推荐将文档放在 docs/ 目录,博客文章可放在 _posts/ 或 blog/ 目录,并配合自定义主题实现不同风格。
Plume主题
一个简约易用的,功能丰富的 vuepress 文档&博客 主题(外部链接)
npm create vuepress-theme-plume@latest
