Markdownリンク生成ツール

リンクのURLとアンカーテキストを入力すると、整ったMarkdownリンクの記法([text](url))が生成されます。タイトルのツールチップや、URLを段落の外に切り出す参照形式のバリエーションも任意で利用できます。トラッキングパラメータ付きの長いURLをコピーする際に、リンクを壊さずに段落の読みやすさを保ちたいときに便利です。

Markdownリンクの生成方法

  1. 1

    URLを貼り付ける

    絶対パスでも相対パスでも構いません。ツールが空白や予約文字をURLエンコードします。

  2. 2

    アンカーテキストを入力する

    読者にクリック可能なテキストとして表示される部分です。

  3. 3

    タイトルを追加する(任意)

    ほとんどのレンダラーでカーソルを重ねたときに表示されます。

  4. 4

    形式を選ぶ

    以下の定義に基づき、インライン形式 `[text](url)` か参照形式 `[text][ref]` を選択します。

  5. 5

    コピーして貼り付ける

    ワンクリックで文書やREADMEにコピーできます。

リンクの4つの形式

インライン形式(タイトルなし):

[ドキュメントを読む](https://example.com/docs)

インライン形式(タイトル付き、カーソルを重ねるとツールチップを表示):

[ドキュメントを読む](https://example.com/docs "完全なドキュメント")

参照形式(URLは下部で定義):

[ドキュメント][docs] または [変更履歴][cl] を開いてください。

[docs]: https://example.com/docs
[cl]:   https://example.com/changelog

自動リンク(URLがテキストとリンク先の両方を兼ねる):

<https://example.com>

どの形式を選ぶか

  • インライン形式: URLが短く、段落が問題なく読める、たまに使う程度のリンクに適しています。
  • 参照形式: 同じURLを何度も参照する場合や、URLが200文字にも及ぶトラッキング用の長大な文字列で、そのままでは段落の流れを乱してしまう場合に使います。
  • 自動リンク: 「こちらが当社のドキュメントページです」のように、URLをテキストとリンク先の両方として文字どおり表示したい場合に使います。

特殊文字の扱い

  • URL内の空白には %20 が必要です。そうしないと空白の位置でリンクが途切れます。
  • URL内の丸括弧%28%29 としてURLエンコードする必要があります。そうしないとMarkdownパーサーがそれらを取り込んでしまいます。
  • アンカーテキスト内の角括弧は、パーサーが入れ子のリンク記法と解釈するのを防ぐため、\[\] としてエスケープする必要があります。

アクセシビリティのヒント

  • 「こちらをクリック」を避ける。 こちらをクリック続きを読む のようなアンカーテキストは、スクリーンリーダーの利用者がリンクをタブで移動する際に役に立ちません。[インストールガイド](...) のように説明的なテキストを使いましょう。
  • 長いURLでは、URLそのものをアンカーテキストにしないでください。支援技術にとって扱いにくく、印刷したときにも見栄えが悪くなります。
  • **「新しいタブで開く」**はMarkdownではなく生のHTML(target="_blank")です。生のHTMLを受け付けるほとんどのレンダラーはこれを反映しますが、純粋なCommonMarkでは対応していません。

1行でできるショートカット

GitHubのコメントでは、選択したテキストの上にURLを貼り付けると自動的にMarkdownリンクに変換されます。すでにエディター内で作業しているときに便利です。

よくある質問

いいえ。target="_blank" には生のHTMLが必要です。ほとんどのMarkdownレンダラーはHTMLによる代替手段(<a href="..." target="_blank" rel="noopener">text</a>)を許可しています。

デスクトップのブラウザでは、カーソルを重ねたときのツールチップとして表示されます。ほとんどのスクリーンリーダーでは読み上げられず、タッチデバイスでは無視されるため、重要な情報をそこに入れないでください。

同じURLが何度も登場する場合、URLが長い場合(トラッキングパラメータやUUIDなど)、あるいはメンテナンスを容易にするためにすべてのリンクを文書末尾にまとめたい場合に使います。

はい、ほとんどのレンダラーで機能します。[別のドキュメント](./other.md) は同じフォルダー内の別ファイルにリンクします。ただし挙動はGitHub、Obsidian、静的サイトジェネレーターによって異なるため、実際に使う環境でテストしてください。

関連ツール

このツールは他の言語でも利用できます