Encephos/markdown-link-resolver

MarkdownのURL相対パスを絶対URLに変換し、RAGやLLM前処理に対応するPythonツール

開発の材料自由に使える · MITデータ・クローリングPython難易度
580 保存
3フォーク0Issue

中辛 の解説

Pythonの軽量ユーティリティで、Markdownの相対パスを絶対URLに統一します。ウェブスクレイピング、RAG、マルチモーダルLLM(GPT-4o、Claude 3.5など)への入力準備に最適です。インライン化したBase64画像対応、認証ヘッダー対応で、プライベートなリソースにも対応します。タイムアウトや404は自動的に絶対URLへフォールバックするため堅牢です。

こんなリポジトリです

こんなときに便利です

  • ウェブスクレイピング後のMarkdownコンテンツをLLMやRAGシステムに投入する前処理として活用できます。
  • プライベートリソース(認証が必要な画像・ドキュメント)を含むMarkdownをマルチモーダルLLMに渡す際、自動認証とBase64変換で手作業を削減します。
  • 複数のドメインから集約したMarkdownを統一フォーマットに正規化する必要があるデータパイプラインで利用できます。

主な機能

相対パスを絶対URLに自動解決画像をBase64にインライン化してLLM対応認証ヘッダーでプライベートリソースに対応

ほかとの違い

依存関係ゼロで軽量な設計により、既存プロジェクトへの影響を最小化しながら、マルチモーダルLLM入力用の画像Base64変換まで専門化した処理を提供します。

このリポジトリの作り方

はじめてですか? むずかしくありません — 上から順にたどれば、自分の環境で動かして味見できます。

すぐに始める

  1. パッケージをインストールします。
pip install markdown-link-resolver
  1. Pythonコード内で基本的な相対パス解決を実行します。
from markdown_link_resolver import resolve_markdown_links

base_url = "https://example.com/blog/"
dirty_markdown = "Check out our [about us](../about) page or our ![logo](images/logo.png)."

clean_markdown = resolve_markdown_links(dirty_markdown, base_url)
print(clean_markdown)
  1. 画像のBase64インライン化と認証が必要な場合、ヘッダーを指定して実行します。
auth_headers = {
    "Authorization": "Bearer YOUR_API_TOKEN"
}

md_with_images = "Look at this chart: ![Chart](/assets/private-chart.png)"

prepared_md = resolve_markdown_links(
    md_with_images,
    base_url="https://secure.example.com/",
    inline_images=True,
    headers=auth_headers
)

ギット飯トライで味見

入れるのが面倒で少し不安だったなら — 安全スキャンからインストールまで、ターミナル一行で終わります。

ターミナルに貼り付ければ、ギット飯の安全スキャン → 隔離フォルダへ clone → インストール → 実行方法の案内まで自動です。はじめてでも大丈夫 — この一行だけです。

npx gitbap-try Encephos/markdown-link-resolver

Node.js さえあれば、インストールなしで動きます · ギット飯トライとは? →

スター推移 · 7日

587日間の増加数を計算するための比較データが不足しています

確認日時

使いやすさ · まねしやすいか

まねしやすいサンプル評点 52/100
  • ゆるいライセンス
  • テストあり
  • サンプル集
  • 最近の更新
  • AGENTS.md
  • llms.txt
  • テンプレート

最近の更新あり · 2026 年に作成

「データ・クローリング」 こういうリポジトリを毎週受け取りませんか?

毎週月曜の朝、選んだ一膳だけ。広告なし · いつでも解除。

自分のリポジトリですか? README にギット飯バッジを貼る
[![깃밥](https://www.gitbap.com/badge/Encephos/markdown-link-resolver.svg)](https://www.gitbap.com/r/Encephos/markdown-link-resolver)
Claude からそのまま使う — ギット飯のつなぎ方

ギット飯を Claude につなぐと、こうしたリポジトリを Claude・Cursor・Codex から直接さがして試せます。

方法 ① コネクタ URL

Claude の設定 → コネクタにこのアドレスを貼り付け。

https://www.gitbap.com/api/mcp
方法 ② プラグイン(試用まで)

プラグインを入れると /gitbap-trending·/gitbap-try のスラッシュコマンドで、その場でリポジトリを試せます。Claude Code で下の 2 行を順に実行してください。

/plugin marketplace add jakeparkcolde/gitbap-cowork
/plugin install gitbap-cowork@gitbap
つなぎ方をくわしく →

AI が README をもとに要約しました · 原文を見る