mcpField
T
transform-convert-markdown-to-pdf-with-transloadit

transform-convert-markdown-to-pdf-with-transloadit

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

transform-convert-markdown-to-pdf-with-transloadit について

Transloadit の公式 CLI でローカルの Markdown ファイルを PDF に変換するスキルです。入出力パスの扱いと、CLI が認証情報を探す順序を説明します。

主な機能

  1. 01ローカル Markdown を PDF に変換
  2. 02出力先を指定または既定値で設定
  3. 03対応する場所から認証情報を解決
  4. 04生成した PDF を確認

活用シーン

  1. 01Markdown の隣に PDF を作成
  2. 02PDF の保存先を指定
  3. 03ローカル認証情報で変換を実行
  4. 04指定した出力ファイルの存在を確認

インストール

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

$npx skills add https://github.com/transloadit/skills --skill transform-convert-markdown-to-pdf-with-transloadit

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

詳細

Transloadit で Markdown を PDF に変換

こんな場合に使います

  • ローカルの Markdown ファイル 1 つをローカルの PDF ファイル 1 つに変換する場合
  • PDF をソースの Markdown ファイルと同じ場所に保存する場合
  • 認証情報がすでにシェル、ローカルの .env、または ~/.transloadit/credentials にある可能性があるエージェントのワークフロー

入力

  • ローカルの .md ファイルへの絶対パス
  • 出力パス（任意）。既定では同じパスの拡張子を .pdf にします

ワークフロー

  1. Markdown の入力ファイルが存在することを確認し、絶対パスを解決します。
  2. ユーザーが別の .pdf 出力先を指定していない限り、同じ場所に出力パスを設定します。
  3. 次の順序で CLI に認証を自動的に解決させます。
    • シェル環境変数
    • 現在の作業ディレクトリにある .env のみ
    • ~/.transloadit/credentials .env が親ディレクトリにある場合は、先に変数をシェルにエクスポートします。
  4. 公式 CLI を使って変換を実行します。
npx -y @transloadit/node markdown pdf --input /ABS/PATH/file.md --output /ABS/PATH/file.pdf

補足

  • @transloadit/node を優先してください。これは公式の CLI 経由であり、markdown pdf を利用できます。
  • --output を指定しない場合、CLI は既定で Markdown ファイルと同じ場所に PDF を書き込みます。
  • 再利用可能なユーザーレベルの設定が必要な場合は、既定のフォールバックとして ~/.transloadit/credentials を使用してください。
  • 現在のディレクトリにある .env が引き続き優先されるため、使用するアカウントを確実に選択する必要がある場合は避けてください。
  • 認証情報がリポジトリのルートにある .env にしか存在しない場合は、そのディレクトリからコマンドを実行するか、先に変数をエクスポートします。
  • シークレットはサーバー側またはローカルのみに保管し、TRANSLOADIT_SECRET をブラウザーのコードに移さないでください。
  • 変換後、想定した出力パスに PDF が存在することを確認します。

コメント

Markdown 対応