资源处理

引用图片

在 Markdown 中用相对路径引用图片：

![描述](./image.png)

图片会被 Vite 自动处理：小于 4KB 的图片会内联为 base64，大图片会被复制到输出目录并使用哈希文件名。

public 目录

把文件放到 public/ 目录（位于源目录下，比如 src/public/），这些文件会原样复制到网站根目录。

适合放这些文件：

• favicon.ico（网站图标）
• robots.txt（搜索引擎爬虫规则）
• 不需要被 Vite 处理的静态文件
• PDF、字体等下载文件

引用方式：用根路径绝对引用。例如 src/public/logo.png，写 /logo.png 引用。

链接 vs 图片

Markdown 链接引用的 PDF 等文件不会被自动当作资源。要让它可访问，必须放到 public/ 里。

base 路径

如果站点部署在子路径（如 https://用户名.github.io/仓库名/），需要设置 base：

export default defineConfig({
  base: '/仓库名/',
})

所有静态资源路径会自动适配 base，不用手动改引用。但如果用 Vue 组件动态链接资源，需要用 withBase() 辅助函数：

<script setup>
import { withBase, useData } from 'vitepress'
const { theme } = useData()
</script>

<template>
  <img :src="withBase(theme.logoPath)" />
</template>