マークダウンのリンク抽出方法|表とURL一覧で確認する

公開ツールMarkdownリンク抽出ツール

目次
  1. リンクが多い文書では、目で数えるほうがかえって間違えやすい
  2. Markdownのリンク構文を直接読んで抽出する方法
  3. よくある勘違いと、この方法で取りこぼすケース
  4. まとめ
  5. よくある質問

Markdownで書かれた文章やREADMEから [テキスト](URL) 形式のリンクだけを抜き出す問題は、結局のところ大括弧と小括弧のペアを正規表現で見つける問題に行き着きます。リンクと画像(![代替テキスト](URL))は、先頭に感嘆符が1つ付いているかどうかだけで区別されるため、文書が長くなると目で追って見落としやすくなります。

この記事では、そのパースの原理をそのまま示し、参照スタイルのリンクや括弧を含むURLなど、この方法では取りこぼしてしまうケースまで整理します。

まとめ ① Markdownのリンク [テキスト](URL) と画像 ![代替テキスト](URL) は、先頭の感嘆符(!)1つだけで区別されます。 ② 参照スタイルのリンク([text][ref])やURLの中に括弧が含まれる場合は、単純な正規表現のマッチングでは正確に抽出できないことがあります。 ③ 結果は表・URL一覧・JSONの3つの形式で表示でき、形式ごとに含まれる情報の範囲が異なります。

リンクが多い文書では、目で数えるほうがかえって間違えやすい

たとえば参考資料をいくつも貼ったREADMEやブログの下書きを翻訳・校正するために、URLだけを一覧で抜き出したい状況があります。

[説明テキスト](url) 形式のハイパーリンクと ![代替テキスト](url) 形式の画像リンクは見た目がほとんど同じなので、スクロールしながら手で移していると、画像リンクをハイパーリンクと勘違いしたり、その逆をしたりすることが起きます。

1つの文書にリンクが10個前後であれば、手で数えても大きく間違うことはありません。しかし数十〜数百個が混在する文書となると話は別です。どのリンクをすでに移したか印を付けなければ重複や漏れが生じますし、段落の合間に挟まった短いリンク1つが丸ごと抜け落ちることもよくあります。

Markdownのリンク構文を直接読んで抽出する方法

Markdownのインラインリンク構文は [リンクテキスト](リンク先URL) 形式で、画像構文はその前に感嘆符を付けた ![代替テキスト](リンク先URL) 形式です。この2つをテキストから直接見つけるには、大括弧のペアと、そのすぐ後ろに続く小括弧のペアを正規表現でマッチさせればよいことになります。

パターンで書くと (!)?\[([^\]]+)\]\(([^)]+)\) です。先頭の (!)? は画像かどうかを見分ける感嘆符、\[([^\]]+)\] は大括弧内のリンクテキスト、\(([^)]+)\) は小括弧内のURLをそれぞれ捉えます。

grepで実際の文書にすぐ適用してみる

ターミナルで直接試すなら grep でも十分です。

grep -oE '!?\[[^]]+\]\([^)]+\)' README.md

このコマンドを実行すると、ファイル内のすべてのリンク・画像のマッチが1行ずつ出力されます。結果の行が感嘆符で始まっていれば画像、そうでなければハイパーリンクです。テキストエディタの検索ウィンドウを正規表現モードにして同じパターンを入れても、同じようにすべてのマッチがハイライトされて確認できます。

こうして見つけたマッチを手で表や一覧に移せば、欲しい結果が得られます。原理そのものは、下のツールが内部で処理している方法と同じです。ただし1つの文書にマッチが数十〜数百件あると、それを1つずつ書き写す作業自体に時間がかかります。

無料ツールで確認する。

Markdownリンク抽出ツール

貼り付けるだけで、すぐに表・URL一覧・JSONに変換されます。インストールも会員登録も不要で、ブラウザ上でそのまま処理できます。

よくある勘違いと、この方法で取りこぼすケース

出力形式は3つあり、含まれる情報の範囲がそれぞれ異なります。

形式表示される内容こんなときに適する
表アンカーテキスト + クリック可能なURLリンクテキストとアドレスを一緒に確認したいとき
URL一覧純粋なURLのみを改行で並べるアドレスだけをコピーして別の場所に貼り付けたいとき
JSON{text, url, isImage} オブジェクトの配列他のスクリプトやプログラムにそのまま渡したいとき

参照スタイルのリンクが抜けるのはなぜか

最もよく取りこぼすのが参照スタイルのリンクです。[テキスト][ref] のように大括弧のペアが連続し、小括弧がない構文は、[テキスト](URL) パターンとは構造そのものが違うためマッチしません。

この構文は本文とは別に [ref]: URL 形式の定義行まで探して結び付ける必要がありますが、それは別の正規表現が必要な、別個の作業になります。

URLの中に括弧が含まれている場合も見落としやすいです。Wikiの記事URLのようにアドレスの途中に (曖昧さ回避) のような括弧が入っていると、正規表現が最初の閉じ括弧で止まってしまうため、URLが途中で切れて出てきます。

画像オプションとURL検証の範囲

画像リンクが結果に表示されない場合は、ほとんどがオプションの問題です。「画像を含める」チェックボックスの初期値がオフ(false)になっているので、オンにしないと ![代替テキスト](URL) のマッチは統計と結果一覧から除外されます。

また、抽出されたURLはtrimが適用されるだけで、別途の妥当性チェックは行われません。そのため、打ち間違いがあったり相対パスだったりするアドレスもそのまま結果に含まれます。

まとめ

  • Markdownのリンクと画像は、先頭の感嘆符(!)1つで区別されます。
  • インラインリンク [テキスト](URL) 形式だけが正確に抽出され、参照スタイルのリンクは対象外です。
  • URLに括弧が含まれていると、最初の閉じ括弧の位置で切れることがあります。
  • 「画像を含める」チェックボックスは初期状態がオフなので、オンにしないと画像リンクは結果から外れます。
  • 結果は表・URL一覧・JSONの3形式で表示でき、用途に応じて使い分けられます。
Markdownリンク抽出ツール

貼り付けるだけで、すぐに表・URL一覧・JSONに変換されます。インストールも会員登録も不要で、ブラウザ上でそのまま処理できます。

よくある質問

参照スタイルのリンク([text][ref])も抽出されますか?

いいえ。このツールはインラインのMarkdownリンク [テキスト](URL) 形式と画像 ![代替テキスト](URL) 形式のみを重点的にパースします。参照スタイルのリンクは大括弧のペアが連続し、小括弧がない別の構文なので、このパターンには当てはまりません。

画像リンクが結果に表示されないのはなぜですか?

前述の「画像を含める」チェックボックスがオフになっているためです。チェックボックスをオンにすると、![代替テキスト](URL) 形式の画像マッチが結果一覧に追加され、上部の統計エリアにも「画像リンク」の項目がそこで初めて新たに表示されます。

抽出したURLをそのままクリックして開けますか?

表形式で表示する場合は可能です。表に並ぶURLアドレスはクリック可能なハイパーリンクとして表示されるので、新しいウィンドウで直接開いて、アドレスが生きているか確認できます。

JSON形式で出力するとどんな値が出ますか?

抽出されたリンクごとに {text, url, isImage} 形式のオブジェクトが配列として出てきます。textは大括弧内のテキスト、urlは小括弧内のアドレス(trimのみ適用、別途の妥当性チェックなし)、isImageは感嘆符が付いた画像リンクかどうかを示します。

この記事は韓国語の原文をもとに作成しています。 韓国語の原文を読む

関連記事

  1. URLリンク自動変換の仕組み|正規表現とtarget/rel属性テキスト内のhttp・httpsアドレスを正規表現で検出し、aタグに変換する仕組みを解説。target=_blank、rel=noopener noreferrer、省略表示、classが出力HTMLに反映される様子も見られます。
  2. チェックサム比較のやり方: ハッシュ値でファイル同一性を確認ダウンロードしたファイルが原本と同じかは、ハッシュ値(チェックサム)の照合で確かめられます。MD5・SHA-1・SHA-256の違いと、公開値と比べる手順、よくある間違いを整理しました。
  3. font-display swapの違いを表で解説font-displayのauto・block・swap・fallback・optionalがblock期間とswap期間でどう違うかを表とタイムラインで整理。swap期間が無限(∞)の意味も解説します。
  4. @font-faceの書き方|woff2・woff・ttfの順番Webフォントを@font-faceで読み込むときのsrcの順番、font-familyの引用符、font-display: swapの書き方をコード構造から解説します。
  5. 自分の位置の緯度経度を確認する方法ブラウザのGeolocation APIで現在位置の緯度・経度を取得する手順と、accuracy・altitude・speedの値が何を意味するかを整理して解説します。
  6. hexdump の見方|オフセット・16進数・ASCII の3列hexdump のオフセット・16進数・ASCII の3つの領域が何を表すのか、オフセットの進数で数字が違って見える理由、点(.)が出る理由を構造から解説します。テキストやファイルを入れて結果も確認できます。

関連ツール