菜单
Preview documentation at a branch, commit or pull request without changing production. Use when debugging content on /tree/:branch, /blob/:sha or /pr/:number, or explaining how ISR and GitHub-pinned content work.
默认使用会先检查来源的 Prompt；你也可以切换为直接命令，或下载本地副本。
决定是否安装前，请先阅读 SKILL.md，以及 SkillsMP 当前展示的配套文件。
用 Codex 或 Claude 帮你安装 复制这段 Prompt，粘贴到 Codex、Claude 或其他助手里，让它检查 Skill 页面并帮你完成安装。
直接命令不会经过审查 Prompt；运行前请先检查来源。
npx skills add https://github.com/comarkdown/comark-docs --skill preview-versions命令会保持在同一行。复制前请横向滚动并检查完整内容。
想先保存到本地？可下载 SkillsMP 当前能够提供的文件。
Set up a documentation site with the comark-docs Nuxt layer. Use when creating a docs app, installing the layer, extending nuxt.config, or wiring site name and URL.
Author Markdown pages for a comark-docs site. Use when adding or editing content under content/, writing MDC, callouts, code blocks, or navigation YAML.
正在显示 SKILL.md
| name | preview-versions |
| description | Preview documentation at a branch, commit or pull request without changing production. Use when debugging content on /tree/:branch, /blob/:sha or /pr/:number, or explaining how ISR and GitHub-pinned content work. |
Content is served at request time. Production is pinned to a commit SHA; any branch, commit or pull request can be previewed through versioned URLs.
| Mode | URL | Content |
|---|---|---|
| prod | /getting-started/introduction | pinned production SHA |
| tree | /tree/main/getting-started/introduction | latest commit touching the content directory |
| blob | /blob/<sha>/getting-started/introduction | immutable commit |
| pr | /pr/<number>/getting-started/introduction | the PR's head commit (follows new pushes) |
Commit and PR previews are authorized: a /blob/ SHA must be in production history or belong to a PR (same-repo, or a fork PR carrying the preview:enabled label), and /pr/ applies the same rule. Unauthorized refs answer 404.
Raw markdown mirrors exist at /raw/** for production pages only — preview pages serve HTML.
Two cache tiers: ISR-cached page HTML at the edge, and a per-parser-version, per-content-SHA runtime cache for parsed Markdown bodies. A GitHub push to the production branch hits /api/revalidate and purges ISR.
Keyboard shortcut g h toggles the version-history panel on a docs page.
Read more: Architecture, Versioned previews.
