---
title: "快速开始"
description: "如何编写、预览和扩展个人文档网站。"
---

> Documentation Index
> Fetch the complete documentation index at: https://personal-docs-b7b.pages.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# 快速开始

这个网站使用 **Astro + Nimbus** 搭建，主张内容优先、结构清晰、可长期维护。

## 添加一篇文档

1. 在 `src/content/docs/` 下创建 `.md` 或 `.mdx` 文件。
2. 在文件顶部写好标题和描述。
3. 将文档加入 `astro.config.ts` 中 `nimbus()` 配置的 `sidebar.items`。
4. 本地运行 `npm run dev` 预览。

例如：

```md
---
title: 我的第一篇文档
description: 这篇文章介绍我的学习过程。
---

# 开始记录

用 Markdown 编写正文。
```

## 使用交互组件

- `.md`：普通 Markdown 文档。
- `.mdx`：使用 Nimbus 组件（`Aside`、`Tabs`、`Card` 等无需 import）。
- `public/demos/*.html`：完整 HTML 页面，使用 sandbox iframe 嵌入。

[查看 Nimbus 组件演示](/examples/vercel-ui/)或[独立 HTML 交互示例](/examples/interactive/)。

## 搜索与目录

Nimbus 内置 Pagefind 全文搜索（生产构建时生成索引），左侧浏览分类，右侧定位章节。

## 部署

`npm run build` 生成 `dist/` 目录，后续通过 Cloudflare Workers Static Assets 部署。

Source: https://personal-docs-b7b.pages.dev/start/introduction/index.mdx