Strip .md Extension

最終出力の内部リンク href から .md および .mdx サフィックスを除去します。

Core 機能 — 常に有効です。設定は不要です。

概要

Resolve Links が内部リンクのターゲットを正規化した後、この機能はリンクの href 値に残っている .md または .mdx サフィックスを除去します。最終的な HTML では拡張子のないクリーンな URL が生成されます。

例

詳細は [セットアップ](./installation.mdx) を参照してください。

次のようにレンダリングされます。

<a href="./installation">詳細はセットアップを参照してください。</a>

.mdx 拡張子が除去され、それ以外のパス、クエリ文字列、フラグメントはそのまま保持されます。

処理順序

Strip .md Extension プラグインは、Resolve Links がファイルパスを出力 URL に書き換えた後、hast フェーズで実行されます。2 つの機能は以下の順序で連携します。

1. Resolve Links — ソースファイルパスを出力 URL にマッピングします。

2. Strip .md Extension — 残っている .md/.mdx サフィックスを除去します。

補足

• 相対パスとルート相対パスのみが対象です。絶対 URL は変更されません。

• フラグメント（#section）とクエリ文字列は保持されます。