正式なドキュメントは英語版であり、この日本語訳はAI支援翻訳により作成された参考用のものです。日本語訳の一部の内容は人間によるレビューがまだ行われていないため、翻訳のタイミングにより英語版との間に差異が生じることがあります。最新かつ正確な情報については、英語版をご参照ください。

Wiki固有のMarkdown

  • プラン: Free、Premium、Ultimate
  • 提供形態: GitLab.com、GitLab Self-Managed、GitLab Dedicated

次のトピックでは、Wiki内のリンクの動作について説明します。

Wikiページにリンクする場合は、ページ名ではなく、ページslugを使用してください。ページslugとは、URLフレンドリーなバージョンのページタイトルで、スペースがハイフンに置き換えられ、特殊文字が削除または変換されます。たとえば、「GitLabの使用方法」というタイトルのページのslugはHow-to-Use-GitLabです。

標準のMarkdownリンクに加えて、Wikiでは、Wikiページ間のリンクをより簡単にする特別なWikiスタイルのリンク構文をサポートしています。

二重角括弧構文

二重角括弧を使用してWikiページにリンクできます:

[[Home]]

この構文は、slugがHomeのWikiページへのリンクを作成します。ページが存在しない場合、リンクを選択すると、このページを作成できます。

ページslugにハイフンが含まれている場合、リンクにはslugがそのまま表示されます:

[[Home-page-new-slug]]

これは、リンクテキストとしてHome-page-new-slugを表示します。

カスタムテキストを使用した二重角括弧構文

ページslugが表示するタイトルと異なる場合は、パイプ（|）文字を使用して、表示テキストをページslugから分離します:

[[How to use GitLab|how-to-use-gitlab]]

これは、リンクテキストとして「GitLabの使用方法」を表示しますが、slugがhow-to-use-gitlabのページにリンクします。

この構文を使用して、ハイフンで区切られたslugを持つページに対して、より読みやすいタイトルを提供することもできます:

[[Home page (renamed)|Home-page-new-slug]]

これは、リンクテキストとして「ホームページ (名前変更)」を表示しますが、slugがHome-page-new-slugのページにリンクします。

代替Wikiページ構文

また、[wiki_page:PAGE_SLUG]構文を使用することもできます:

[wiki_page:Home]

クロスプロジェクト参照の場合は、プロジェクトの完全パスを指定します:

[wiki_page:namespace/project:Home]
[wiki_page:group1/subgroup:Home]

URLの自動認識

MarkdownのフォーマットなしでWikiページに完全なURLを貼り付けると、GitLabは自動的にリンクに変換し、ハイフンの代わりにスペースを含むページslugを表示します:

https://gitlab.com/namespace/project/-/wikis/Home-page-new-slug

これにより、「Home page new slug」というテキスト（ハイフンがスペースに変換される）のリンクとして自動的にレンダリングされます。

ダイレクトページリンク

ダイレクトページリンクには、Wikiのベースレベルで、そのページを指すページのslugが含まれます。

この例は、Wikiのルートにあるdocumentationページにリンクしています:

[Link to Documentation](documentation-top-page)

ダイレクトファイルリンクは、現在のページを基準にして、ファイルのファイル拡張子を指します。

次の例が<your_wiki>/documentation/relatedのページにある場合、<your_wiki>/documentation/file.mdにリンクします:

[Link to File](file.md)

階層リンクは、./<page>や../<page>のような相対パスを使用して、現在のWikiページを基準に構築できます。

この例が<your_wiki>/documentation/mainのページにある場合、<your_wiki>/documentation/relatedにリンクします:

[Link to Related Page](related)

この例が<your_wiki>/documentation/related/contentのページにある場合、<your_wiki>/documentation/mainにリンクします:

[Link to Related Page](../main)

この例が<your_wiki>/documentation/mainのページにある場合、<your_wiki>/documentation/related.mdにリンクします:

[Link to Related Page](related.md)

この例が<your_wiki>/documentation/related/contentのページにある場合、<your_wiki>/documentation/main.mdにリンクします:

[Link to Related Page](../main.md)

ルートリンクは、/で始まり、Wikiルートを基準にしています。

この例は、<wiki_root>/documentationにリンクしています:

[Link to Related Page](/documentation)

この例は、<wiki_root>/documentation.mdにリンクしています:

[Link to Related Page](/documentation.md)

diagrams.netエディタ

Wikiでは、diagrams.netエディタを使用して図を作成できます。diagrams.netエディタで作成した図を編集することもできます。図エディタは、プレーンテキストエディタとリッチテキストエディタの両方で使用できます。

詳細については、Diagrams.netを参照してください。

プレーンテキストエディタ

次の手順により、プレーンテキストエディタで図を作成できます:

  1. 編集するWikiページで編集を選択。
  2. テキストボックスで、プレーンテキストエディタを使用していることを確認（左下のボタンにリッチテキスト編集に切り替えると表示されます）。
  3. エディタのツールバーでダイアグラムの挿入または編集（ diagram ）を選択。
  4. app.diagrams.netエディタで図を作成。
  5. Save & exit（保存して終了）を選択。

図へのMarkdown画像参照がWikiコンテンツに挿入されます。

次の手順により、プレーンテキストエディタで図を編集できます:

  1. 編集するWikiページで編集を選択。
  2. テキストボックスで、プレーンテキストエディタを使用していることを確認（左下のボタンにリッチテキスト編集に切り替えると表示されます）。
  3. 図を含むMarkdown画像参照内にカーソルを合わせる。
  4. エディタのツールバーでダイアグラムの挿入または編集（ diagram ）を選択。
  5. app.diagrams.netエディタで図を編集。
  6. Save & exit（保存して終了）を選択。

図へのMarkdown画像参照がWikiコンテンツに挿入され、前の図が置き換えられます。

リッチテキストエディタ

次の手順により、リッチテキストエディタで図を作成できます:

  1. 編集するWikiページで編集を選択。
  2. テキストボックスで、リッチテキストエディタを使用していることを確認します（左下のボタンにテキスト編集に切り替えると表示されます）。
  3. エディタのツールバーでその他のオプション（ plus ）を選択。
  4. ドロップダウンリストでダイアグラムの作成または編集を選択。
  5. app.diagrams.netエディタで図を作成。
  6. Save & exit（保存して終了）を選択。

diagrams.netエディタで視覚化された図がWikiコンテンツに挿入されます。

次の手順により、リッチテキストエディタで図を編集できます:

  1. 編集するWikiページで編集を選択。
  2. テキストボックスで、リッチテキストエディタを使用していることを確認します（左下のボタンにテキスト編集に切り替えると表示されます）。
  3. 編集する図を選択。
  4. フローティングツールバーでダイアグラムの編集（ diagram ）を選択。
  5. app.diagrams.netエディタで図を編集。
  6. Save & exit（保存して終了）を選択。

選択した図が更新されたバージョンに置き換えられます。