页面元信息条(DocPageMeta)
最后更新于
每个文档页的标题下方会自动渲染一条页面元信息条:description 引用与右对齐的操作区。它由 markdown-it 在构建期注入(首个 H1 之后),组件源码位于 docs/.vitepress/theme/components/DocPageMeta.vue。
主页(layout: page)与 404 页不渲染。
结构
- description:取自 frontmatter
description,与正文同样式、仅灰字显示。未声明时跳过。 - 操作区:「最后更新于」左对齐(只显示到年月,如
2026年7月;时间来自 Git 提交历史,页脚默认日期已隐藏并上移至此),操作按钮组右对齐。
复制 Markdown 与下载
可复制页(默认)的操作区:
- 复制 Markdown:拉取本页对应的
.md端点并写入剪贴板。 - 更多操作 下拉菜单:
- 查看 .md:新标签页打开本页 Markdown;
- 下载 .md:下载本页 Markdown 文件;
- 问问 AI:预填提示词「阅读 <本页 .md 地址> 回答相关问题」,在 ChatGPT / Claude / Grok / DeepSeek 中打开;
- 在 Agent 中阅读:同一提示词唤起本地 Codex / Claude Code / Claude Desktop。
.md 端点由 vitepress-plugin-llms 随构建产出(如 /sre/git-basics 对应 /sre/git-basics.md)。开发服务器不产出 .md 文件,此时「复制 Markdown」会提示失败;生产构建与 docs:preview 正常。
copyable:页面级复制许可
frontmatter 新增 copyable 字段,控制访问者能否复制本页内容:
| 值 | 行为 |
|---|---|
缺省 / true | 一切照常:可选取、可复制、有「复制 Markdown」与「下载 .md」 |
false | 全页禁止选取与剪贴板复制;操作区只剩「问问 AI」下拉 |
Markdown
---
title: 受保护的页面
description: 该页禁止复制。
copyable: false
---设为 false 时:
- 无法选取页面任何文字,
Ctrl+C、右键「复制」与剪切均被拦截(copy / cut 事件兜底); - 没有「复制 Markdown」「查看 .md」「下载 .md」入口,「更多操作」按钮替换为单独的问问 AI下拉——点击仅展开菜单(问问 AI / 在 Agent 中阅读两组),不会直接执行某一项;
- 例外:行内代码、代码块、Mermaid 图表仍可选取与复制;
- 这只是访问侧的软限制:
.md端点与llms-full.txt仍公开,AI 依赖它们阅读全文。
组件级 copyable
自研代码块与图表组件也有独立的 copyable 参数(默认 true;false 隐藏复制按钮并禁止选中块内文本),可与页面级 copyable: false 组合:
Code/CodeBlock::copyable="false",见 Code 组件;- 原生
mermaidfence:围栏 meta```mermaid copyable=false; - MermaidBlock:
:copyable="false"。
页面锁与块级参数叠加时,块级 copyable="false" 始终生效;页面锁不例外放行被锁定的块。