Skip to content

让第一篇文章出现在这里 ​

新建一篇文章 ​

在 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/,正文使用 ![图片描述](/images/example.png) 引用。发布前请确认图片里没有密码、令牌或个人隐私。

本地预览 ​

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。

最近更新