docmd bietet ein zuverlässiges, Dateisystem-bewusstes Verlinkungssystem. Schreiben Sie Links zu Ihren Quell-.md-Dateien ganz natürlich in jedem beliebigen Format - die Engine normalisiert diese automatisch in saubere, SEO-optimierte URLs.

URL-Normalisierung

Während des Build-Prozesses normalisiert die Engine jeden internen Link automatisch. Dies gilt für Markdown-Texte, Button-Container, Tags und die Navigationskonfiguration.

Interne Links

Verlinken Sie auf andere Seiten über relative Pfade zu den Quell-.md-Dateien. Die Engine löst diese unabhängig von der Verzeichnistiefe korrekt auf.

Abschnitts-Anker (Deep Linking)

Navigieren Sie direkt zu einer bestimmten Überschrift mit Standard-URL-Hash-Fragmenten.

<!-- Anker auf derselben Seite -->
[Zum Roadmap springen](#project-roadmap)

<!-- Anker auf anderer Seite -->
[CLI-Flags prüfen](../api/cli-commands.md#available-flags)

Hash-Fragmente bleiben bei der Normalisierung erhalten. Der obige seitenübergreifende Link wird in der Produktion als ../api/cli-commands/#available-flags gerendert.

In einem neuen Tab öffnen

Setzen Sie das Präfix external: vor eine beliebige Link-URL, um das Öffnen in einem neuen Browser-Tab zu erzwingen. Dies funktioniert in Standard-Markdown-Links, Buttons und Tags.

[In neuem Tab öffnen](external:./configuration/overview.md)
[GitHub](external:https://github.com/docmd-io/docmd)

Das Präfix external: wird aus der gerenderten URL entfernt. Standardmäßig werden alle Links im selben Fenster geöffnet.

Verlinkung zu Rohdateien (Raw Files)

Verwenden Sie das Präfix raw:, um die Normalisierung zu umgehen und direkt auf eine herunterladbare Datei zu verlinken. Die Erweiterung und der Pfad bleiben exakt so erhalten, wie sie geschrieben wurden.

[Quellcode anzeigen](raw:docs/readme.md)

Buttons & Tags

Die Container ::: button und ::: tag unterstützen alle Standard-Verlinkungskonventionen, einschließlich der Präfixe external: und raw::

::: button "Erste Schritte" ./getting-started/quick-start.md icon:rocket
::: button "Auf GitHub anzeigen" external:https://github.com/docmd-io/docmd icon:github
::: button "Quelle herunterladen" raw:docs/readme.md icon:download

::: tag "v0.8.2" link:release-notes/0-8-2.md icon:tag color:#22c55e
::: tag "Extern öffnen" link:external:./configuration/overview.md icon:external-link

Navigationskonfiguration

In navigation.json und docmd.config.json definierte Pfade werden zur Build-Zeit normalisiert. Schreiben Sie sie in einem beliebigen Format - alle drei Einträge unten erzeugen die identische kanonische URL.

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

Für Elemente, die in einem neuen Tab geöffnet werden sollen, setzen Sie das Flag external.

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

<!-- Bevorzugt -->
[Lokalisierung](localisation/)

<!-- Funktioniert auch -->
[Lokalisierung](localisation/index.md)

Protokolle & Externe Ressourcen

Die Engine respektiert Standard-Browserprotokolle für externe Ressourcen und ändert diese Links niemals.

• HTTPS - [docmd Homepage](https://docmd.io) - öffnet sich im selben Tab.
• Mail - [Support](mailto:help@docmd.io) - öffnet den E-Mail-Client.
• Assets - [CLI-Binary herunterladen](/assets/bin/docmd-mac.zip) - wird nicht normalisiert.

Statische Assets

Platzieren Sie herunterladbare Dateien im Verzeichnis assets/ Ihres Projekts. Der Builder verschiebt diese Dateien ohne Pfadänderungen in das Produktions-Root.

[Dokumentations-PDF herunterladen](/assets/pdf/handbook.pdf)
[Globale Konfiguration anzeigen](/assets/config/docmd.config.json)