切换主题
让第一篇文章出现在这里
新建一篇文章
在 docs/knowledge/ 的对应分类下创建 .md 文件,例如 frontend/my-first-post.md。
yaml
---
title: 我的第一篇文章
date: 2026-10-22 10:00:00
categories:
- 前端开发
tags:
- Vue
- 实践
description: 用一句话概括这篇文章。
---在这些元信息下面直接写正文即可。需要进入左侧知识目录时,在 docs/.vitepress/config.ts 的 sidebar 中补充文章链接。
写正文
用二级标题组织章节,用列表梳理步骤,用代码块记录可以复用的片段。标题负责说明问题,正文负责留下证据与解法。
ts
const message = "Hello, blog!";
console.log(message);图片放哪里?
把图片放进 docs/public/images/,正文使用  引用。发布前请确认图片里没有密码、令牌或个人隐私。
本地预览
bash
pnpm install --frozen-lockfile
pnpm docs:dev开发预览会在保存 Markdown 文件后自动刷新。
构建与发布
bash
pnpm docs:build生成的网站位于 docs/.vitepress/dist/。把构建产物发布到静态网站服务器即可;完整部署步骤见项目根目录的 README.md。
修改站点信息
网站名称与导航在 docs/.vitepress/config.ts,首页横幅、作者和页脚在 docs/.vitepress/teekConfig.ts,关于页在 docs/about.md。