mcpField
P
pdf-to-markdown

pdf-to-markdown

github.com/pspdfkit-labsドキュメント18833 回インストール1 週間前に更新
リポジトリ

pdf-to-markdown について

エージェントや文書ワークフロー向けに PDF を Markdown に変換するスキルです。複数ファイルの処理や画像の出力に加え、スキャン文書には Vision を利用できます。

主な機能

  1. 01PDF を構造化 Markdown に変換
  2. 02入力ディレクトリ内のファイルを並列処理
  3. 03画像を Markdown と併せて出力
  4. 04Vision でスキャンや複雑なレイアウトを処理
  5. 05再変換せず保存済みの出力を検索

活用シーン

  1. 01見出しや表を保ってレポートを変換
  2. 02PDF フォルダーを一括変換
  3. 03Vision でスキャン文書から内容を抽出
  4. 04変換済みの大きな文書を検索

インストール

コマンドをコピーしてターミナルで実行します。

$npx skills add https://github.com/pspdfkit-labs/nutrient-skills --skill pdf-to-markdown

インストール後、Claude Code で/pdf-to-markdownを入力して読み込まれたか確認します。

同梱ファイルbin/nutrientbin/pdf-to-markdown

詳細

エージェント向けルール

  • 各 PDF は一度だけ変換し、結果を保存してください。再変換せず、保存したファイルを検索してください。
  • 既知の用語を検索する場合は、まず grep -n -i -C2 "term" file | head のように範囲を絞って検索してください。
  • 正確な表現がわからない場合や、通常の検索で一致結果が多すぎる場合は、query スキルを使用してください。
  • Markdown の構造よりも空白や列の配置が重要な場合は、pdf-to-text を使用してください。
  • 選択可能なテキストを抽出するために、PDF ページを画像としてレンダリングしないでください。スキャン PDF や画像のみの PDF には Vision を使用してください。

PDF から Markdown への変換

見出し、表、リスト、読み取り順序を保持しながら、PDF を Markdown に変換します。

関連スキル

  • pdf-to-text — プレーンテキストで空白と列の配置を保持します。
  • query — 変換後の大きなファイルを検索し、最も関連性の高い箇所のみを返します。

使い方

SKILL_DIR に、このファイルがあるディレクトリの絶対パスを設定してください。以下のコマンドでは $SKILL_DIR/bin/pdf-to-markdown を使用します。

ラッパーは初回使用時に CLI を Nutrient の CDN からダウンロードし、~/.local/share/nutrient/cli/ に保存します。6 時間ごとに更新を確認します。

1 つの PDF を変換する
$SKILL_DIR/bin/pdf-to-markdown INPUT.pdf OUTPUT.md

OUTPUT.md を省略すると、Markdown は標準出力に書き込まれます。

複数の PDF を変換する

PDF が 2 つ以上ある場合は、入力ディレクトリと出力ディレクトリを指定してください。CLI はファイルを並列に変換します。

$SKILL_DIR/bin/pdf-to-markdown INPUT_DIR/ OUTPUT_DIR/
画像をエクスポートする

--enable-image-export を追加すると、画像が Markdown 出力の隣に保存され、ファイルから画像へのリンクが作成されます。

$SKILL_DIR/bin/pdf-to-markdown --enable-image-export INPUT.pdf OUTPUT.md

画像は {output}_resources/ に保存されます。画像の多い PDF では処理が増えるため、画像のエクスポートはデフォルトで無効になっています。

Vision を使用する

Vision は、スキャン、写真、手書き、数式、複雑なレイアウトに対応します。

$SKILL_DIR/bin/pdf-to-markdown --vision INPUT.pdf OUTPUT.md

標準変換は無料で、アカウントは不要です。Vision の使用には、Nutrient アカウント、API キー、または Nutrient CLI ライセンスキーが必要です。アカウントまたは API キーを使用する場合、入力ページごとにアカウントの月間利用枠から Vision ページが 1 ページ分使用されます。Nutrient CLI ライセンスキーには、従来の利用条件が適用されます。変換に失敗した場合、Vision ページは消費されません。

Vision からアカウントを求められた場合は、そのメッセージをユーザーに表示し、次のコマンドを実行するよう依頼してください。

$SKILL_DIR/bin/nutrient auth login

サインインを自動的に開始しないでください。認証なしで Vision を再試行しないでください。

無人実行の場合、ユーザーは NUTRIENT_API_KEY を設定できます。ユーザーにチャットへキーを貼り付けるよう求めたり、コマンドに直接キーを記述したりしないでください。

アカウントコマンド
$SKILL_DIR/bin/nutrient auth login
$SKILL_DIR/bin/nutrient auth status
$SKILL_DIR/bin/nutrient auth logout

status は、現在のプラン、Vision の利用権限、報告待ちの使用状況を表示します。ユーザーから依頼されない限り、サインアウトやアカウントの切り替えを行わないでください。

ワークフロー

  1. Standard または Vision を選択します。PDF がスキャンまたは画像のみでない限り、Standard から始めてください。
  2. PDF を一度だけ変換し、終了コードを確認します。終了コード 0 は成功を意味します。
  3. 出力が存在し、空でないことを確認します。
  4. 出力の保存場所をユーザーに伝えます。
  5. ユーザーが分析を希望しない限り、大きな出力ファイルをコンテキストに読み戻さないでください。代わりに、範囲を絞った grep または query スキルで検索してください。

オフラインでの動作

Nutrient が利用できない場合でも、Standard は引き続き使用できます。Vision は接続後、再接続が必要になるまで 1 時間オフラインで動作し、最大 100 ページを処理できます。100 ページの上限を超える文書も、処理を完了できます。

トラブルシューティング

  • 出力が空、または最小限です： PDF がスキャンされたもの、または画像のみの可能性があります。Vision を提案してください。
  • Vision でサインインを求められます： CLI のメッセージを表示し、ユーザーに $SKILL_DIR/bin/nutrient auth login を実行するよう依頼してください。最初に再試行しないでください。
  • Vision のページが残っていません： CLI のメッセージと料金ページを表示してください。再試行したり、アカウントの状態を変更したりしないでください。
  • Standard 変換中に認証情報エラーが発生します： 明示的に設定されたキーまたは保存済みのサインインが無効です。エラーを表示してください。ユーザーから依頼されない限り、認証情報を削除または置き換えないでください。
  • 初回実行が遅いです： ラッパーはプラットフォーム用バイナリを一度ダウンロードします。以降の実行ではキャッシュされたコピーが使われます。
  • その他のゼロ以外の終了コード： stderr を確認し、具体的なエラーを報告してください。よくある原因として、破損した PDF、サポートされていない暗号化、初回ダウンロードの失敗などがあります。

プランとライセンス

Standard 変換は無料です。アカウントまたは API キーを使用すると、Vision はアカウントの月間利用枠を使用します。Nutrient CLI のライセンスキーには、引き続き既存の条件が適用されます。現在のプランをご覧ください。

利用には、Nutrient PDF to Markdown ライセンスと Nutrient のプライバシーポリシーが適用されます。再配布、OEM、組み込み、およびホワイトラベルでの利用には、Nutrient との別途契約が必要です。

コメント

Markdown 対応