docmd 提供了健壮的文件系统感知链接系统。通过使用相对路径引用源 .md 文件,可确保链接在 IDE(如 VS Code)中正常工作,并在生产构建时自动重写为正确路径。

扩展名中立性

在构建过程中,引擎会自动将 .md 扩展名解析为对应的相对 HTML 路径。无论是在本地浏览源文件还是编译后的生产网站,内部文档链接都不会失效。

内部链接解析

定向策略 Markdown 语法
同级页面 [系统概览](overview.md)
子目录 [API 参考](api/node-api.md)
上级目录 [返回首页](../index.md)

节点锚点(深层链接)

使用标准 URL slug 直接定位特定标题。

  • 页内锚点[跳转到路线图](#project-roadmap)
  • 跨页锚点[查看 CLI 参数](../cli-commands.md#available-flags)

协议与外部资源

引擎支持各类标准浏览器协议。

  • HTTPS[docmd 首页](https://docmd.io)
  • 邮件协议[支持渠道](mailto:help@docmd.io)
  • 资源下载[下载 CLI 二进制](/assets/bin/docmd-mac.zip)

静态资源引用

如需提供下载或引用原始源文件,将其放入项目的 assets/ 目录。docmd 构建器会确保这些文件在没有路径修改的情况下迁移到生产根目录。

[下载文档 PDF](/assets/pdf/handbook.pdf)
[查看原始全局配置](/assets/config/docmd.config.js)
AI 语义链接

跨模块链接时,优先使用描述性锚点文本(如 [优化 PWA 缓存](../plugins/pwa.md))而非泛泵文本(如 [阅读更多](../plugins/pwa.md))。详细的链接标签为 AI Agent 提供了 llms-full.txt 上下文中不同文档节点间语义关系的高保真地图。