docmd 提供了一套可靠的、具有文件系统感知能力的链接系统。你可以用任何格式自然地编写指向源 .md 文件的链接——引擎会自动将它们规范化为干净、经过 SEO 优化的 URL。

URL 规范化

在构建过程中，引擎会对每一个内部链接自动应用规范化。这适用于 Markdown 文本、按钮容器、标签和导航配置中的链接。

内部链接

使用指向源 .md 文件的相对路径链接到其他页面。无论目录深度如何，引擎都能正确解析。

章节锚点

使用标准 URL 哈希片段直接跳转到指定标题。

<!-- 页内锚点 -->
[跳转到路线图](#project-roadmap)

<!-- 跨页锚点 -->
[查看 CLI 标志](../api/cli-commands.md#available-flags)

哈希片段在规范化过程中会被保留。上面的跨页链接在生产环境中渲染为 ../api/cli-commands/#available-flags。

在新标签页中打开

在任何链接 URL 前加上 external: 前缀，即可强制其在新标签页中打开。适用于标准 Markdown 链接、按钮和标签容器。

[在新标签页中打开](external:./configuration/overview.md)
[GitHub](external:https://github.com/docmd-io/docmd)

external: 前缀会从渲染后的 URL 中剥离。默认情况下，所有链接都在同一个窗口中打开。

链接到原始文件

使用 raw: 前缀可绕过规范化，直接链接到可下载的原始文件。扩展名和路径将完全按照编写的方式保留。

[查看原始源码](raw:docs/readme.md)

按钮与标签

::: button 和 ::: tag 容器支持所有标准链接约定，包括 external: 和 raw: 前缀。

::: button "开始使用" ./getting-started/quick-start.md icon:rocket
::: button "在 GitHub 上查看" external:https://github.com/docmd-io/docmd icon:github
::: button "下载源码" raw:docs/readme.md icon:download

::: tag "v0.8.2" link:release-notes/0-8-2.md icon:tag color:#22c55e
::: tag "从外部打开" link:external:./configuration/overview.md icon:external-link

导航配置

在 navigation.json 和 docmd.config.json 中定义的路径会在构建时规范化。三种写法均生成相同的规范 URL。

[
  { "title": "概览", "path": "configuration/overview" },
  { "title": "概览", "path": "configuration/overview.md" },
  { "title": "概览", "path": "configuration/overview/" }
]

对于需要在新标签页中打开的导航项，设置 external 标志。

[
  {
    "title": "GitHub",
    "path": "https://github.com/docmd-io/docmd",
    "external": true
  }
]

<!-- 推荐 -->
[本地化](localisation/)

<!-- 同样有效 -->
[本地化](localisation/index.md)

协议与外部资源

引擎遵循标准浏览器协议，不修改这些链接。

• HTTPS — [docmd 主页](https://docmd.io) — 在同一标签页中打开。
• 邮件 — [支持](mailto:help@docmd.io) — 打开邮件客户端。
• 资源 — [下载 CLI 二进制](/assets/bin/docmd-mac.zip) — 不做规范化。

静态资源

将可下载文件放在项目的 assets/ 目录中。构建器会将这些文件移动到生产根目录，不修改路径。

[下载文档 PDF](/assets/pdf/handbook.pdf)
[查看原始全局配置](/assets/config/docmd.config.json)