docs: standardize documentation style with anchor IDs and VitePress containers

- Add anchor IDs to all headings (e.g., `## Title {#anchor}`)
- Replace `> [!TIP]` syntax with VitePress containers (`:::tip`)
- Use `sh` instead of `bash` for shell code blocks
- Add file name labels to code blocks (e.g., ` ```ts [build.config.ts] `)
- Add complete import statements in code examples
- Add "Next Steps" section at the end of each document
- Remove unused VitePress example file (api-examples.md)

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

Author: Sunny-117

.claude/settings.local.json

@@ -41,7 +41,8 @@
       "Bash(../../node_modules/.bin/esno:*)",
       "Bash(git restore:*)",
       "Bash(pnpm test:coverage:*)",
-      "Bash(pnpm docs:build:*)"
+      "Bash(pnpm docs:build:*)",
+      "Bash(git checkout:*)"
     ]
   }
 }

docs/advanced/hooks.md

@@ -1,8 +1,8 @@
-# Hooks 钩子
+# Hooks 钩子 {#hooks}
 
 `robuild` 提供构建生命周期钩子，允许在构建过程的不同阶段执行自定义逻辑。
 
-## 可用钩子
+## 可用钩子 {#available-hooks}
 
 ```ts [build.config.ts]
 import { defineConfig } from 'robuild'
@@ -34,49 +34,49 @@ export default defineConfig({
 })
 ```
 
-## 钩子说明
+## 钩子说明 {#hook-descriptions}
 
-### `start`
+### `start` {#start}
 
 构建开始时触发。
 
 ```ts
 start?: (ctx: BuildContext) => void | Promise<void>
 ```
 
-### `entries`
+### `entries` {#entries}
 
 入口解析完成后触发，可以修改入口配置。
 
 ```ts
 entries?: (entries: BuildEntry[], ctx: BuildContext) => void | Promise<void>
 ```
 
-### `rolldownConfig`
+### `rolldownConfig` {#rolldown-config}
 
 Rolldown 配置生成后触发，可以修改配置。
 
 ```ts
 rolldownConfig?: (config: InputOptions, ctx: BuildContext) => void | Promise<void>
 ```
 
-### `rolldownOutput`
+### `rolldownOutput` {#rolldown-output}
 
 输出配置生成后触发。
 
 ```ts
 rolldownOutput?: (config: OutputOptions, result: RolldownBuild, ctx: BuildContext) => void | Promise<void>
 ```
 
-### `end`
+### `end` {#end}
 
 构建完成后触发。
 
 ```ts
 end?: (ctx: BuildContext) => void | Promise<void>
 ```
 
-## BuildContext
+## BuildContext {#build-context}
 
 钩子函数接收的上下文对象：
 
@@ -87,14 +87,22 @@ interface BuildContext {
 }
 ```
 
-## 使用示例
+## 使用示例 {#examples}
 
-### 构建耗时统计
+### 构建耗时统计 {#build-timing}
 
 ```ts [build.config.ts]
+import { defineConfig } from 'robuild'
+
 let startTime: number
 
 export default defineConfig({
+  entries: [
+    {
+      type: 'bundle',
+      input: './src/index.ts',
+    },
+  ],
   hooks: {
     start: () => {
       startTime = Date.now()
@@ -106,10 +114,18 @@ export default defineConfig({
 })
 ```
 
-### 修改 Rolldown 配置
+### 修改 Rolldown 配置 {#modify-rolldown-config}
 
 ```ts [build.config.ts]
+import { defineConfig } from 'robuild'
+
 export default defineConfig({
+  entries: [
+    {
+      type: 'bundle',
+      input: './src/index.ts',
+    },
+  ],
   hooks: {
     rolldownConfig: (config) => {
       config.treeshake = false
@@ -118,5 +134,11 @@ export default defineConfig({
 })
 ```
 
-> [!TIP]
-> 钩子适用于简单的构建过程扩展。对于复杂的代码转换需求，推荐使用插件。
+:::tip
+钩子适用于简单的构建过程扩展。对于复杂的代码转换需求，推荐使用插件。
+:::
+
+## 下一步 {#next-steps}
+
+- [插件](./plugins.md) - 插件系统
+- [程序化使用](./programmatic-usage.md) - API 调用

docs/advanced/plugins.md

@@ -1,10 +1,10 @@
-# 插件
+# 插件 {#plugins}
 
 `robuild` 以 [Rolldown](https://rolldown.rs) 作为核心引擎，支持丰富的插件生态。
 
-## 支持的插件生态
+## 支持的插件生态 {#supported-ecosystems}
 
-### Rolldown 插件
+### Rolldown 插件 {#rolldown-plugins}
 
 由于 `robuild` 基于 Rolldown 构建，因此支持所有 Rolldown 插件：
 
@@ -23,7 +23,7 @@ export default defineConfig({
 })
 ```
 
-### Unplugin
+### Unplugin {#unplugin}
 
 [Unplugin](https://unplugin.unjs.io/) 是一个现代化的插件框架，支持多种打包器。大多数 Unplugin 插件都可以与 `robuild` 配合使用：
 
@@ -42,7 +42,7 @@ export default defineConfig({
 })
 ```
 
-### Rollup 插件
+### Rollup 插件 {#rollup-plugins}
 
 Rolldown 与 Rollup 的插件 API 高度兼容，大多数 Rollup 插件可以直接使用：
 
@@ -61,15 +61,27 @@ export default defineConfig({
 })
 ```
 
-> [!NOTE]
-> 由于 Rollup 和 Rolldown 的 API 并非 100% 兼容，某些插件可能有类型错误。可以使用 `as any` 忽略：
-> ```ts
-> plugins: [SomeRollupPlugin() as any]
-> ```
+:::warning
+由于 Rollup 和 Rolldown 的 API 并非 100% 兼容，某些插件可能有类型错误。可以使用 `as any` 忽略：
 
-## 全局插件 vs 入口插件
+```ts [build.config.ts]
+import { defineConfig } from 'robuild'
 
-### 全局插件
+export default defineConfig({
+  entries: [
+    {
+      type: 'bundle',
+      input: './src/index.ts',
+      plugins: [SomeRollupPlugin() as any],
+    },
+  ],
+})
+```
+:::
+
+## 全局插件 vs 入口插件 {#global-vs-entry-plugins}
+
+### 全局插件 {#global-plugins}
 
 在顶层配置，对所有入口生效：
 
@@ -85,7 +97,7 @@ export default defineConfig({
 })
 ```
 
-### 入口插件
+### 入口插件 {#entry-plugins}
 
 在入口配置，只对该入口生效：
 
@@ -103,11 +115,13 @@ export default defineConfig({
 })
 ```
 
-## 编写自定义插件
+## 编写自定义插件 {#custom-plugins}
 
 可以使用 Rolldown 的插件 API 编写自定义插件：
 
 ```ts [build.config.ts]
+import { defineConfig } from 'robuild'
+
 const myPlugin = () => ({
   name: 'my-plugin',
   transform(code, id) {
@@ -129,3 +143,8 @@ export default defineConfig({
 ```
 
 详细信息请参阅 [Rolldown 插件开发指南](https://rolldown.rs/guide/plugin-development)。
+
+## 下一步 {#next-steps}
+
+- [Hooks 钩子](./hooks.md) - 构建生命周期钩子
+- [Rolldown 选项](./rolldown-options.md) - 直接传递 Rolldown 配置

docs/advanced/programmatic-usage.md

@@ -1,8 +1,8 @@
-# 程序化使用
+# 程序化使用 {#programmatic-usage}
 
 除了 CLI，`robuild` 还提供程序化 API，可以在 Node.js 脚本中调用。
 
-## 基本用法
+## 基本用法 {#basic-usage}
 
 ```ts [scripts/build.ts]
 import { build } from 'robuild'
@@ -19,13 +19,13 @@ await build({
 })
 ```
 
-## API
+## API {#api}
 
-### `build(config)`
+### `build(config)` {#build}
 
 执行构建：
 
-```ts
+```ts [scripts/build.ts]
 import { build } from 'robuild'
 
 await build({
@@ -43,11 +43,11 @@ await build({
 })
 ```
 
-### `defineConfig(config)`
+### `defineConfig(config)` {#define-config}
 
 配置辅助函数，提供类型提示：
 
-```ts
+```ts [build.config.ts]
 import { defineConfig } from 'robuild'
 
 const config = defineConfig({
@@ -60,9 +60,9 @@ const config = defineConfig({
 })
 ```
 
-## 完整示例
+## 完整示例 {#examples}
 
-### 条件构建
+### 条件构建 {#conditional-build}
 
 ```ts [scripts/build.ts]
 import { build } from 'robuild'
@@ -83,7 +83,7 @@ await build({
 })
 ```
 
-### 多包构建
+### 多包构建 {#multi-package-build}
 
 ```ts [scripts/build.ts]
 import { build } from 'robuild'
@@ -105,7 +105,7 @@ for (const pkg of packages) {
 }
 ```
 
-### 与其他工具集成
+### 与其他工具集成 {#integration}
 
 ```ts [scripts/build.ts]
 import { build } from 'robuild'
@@ -125,7 +125,7 @@ await build({
 execSync('pnpm test', { stdio: 'inherit' })
 ```
 
-## 类型导出
+## 类型导出 {#type-exports}
 
 ```ts
 import type {
@@ -138,5 +138,11 @@ import type {
 } from 'robuild'
 ```
 
-> [!TIP]
-> 程序化 API 适合复杂的构建场景，如 monorepo 批量构建、条件构建、与 CI/CD 集成等。
+:::tip
+程序化 API 适合复杂的构建场景，如 monorepo 批量构建、条件构建、与 CI/CD 集成等。
+:::
+
+## 下一步 {#next-steps}
+
+- [Hooks 钩子](./hooks.md) - 构建生命周期钩子
+- [CLI 参考](../reference/cli.md) - 命令行参考