CursorでIronPDFを使用する方法
AIアシスタントにIronPDFコードを書くように頼むと、正しいと思われる何かを生成します。 時にはそうです。 その他の場合には、存在したことのないメソッドを呼び出し、レビューではなくビルド段階でそのことを知ることになります。 モデルが誤作動しているわけではありません。 それは知識の隙間を、もっともらしい形で埋めているのです。これは、それが有用であると同時に危険である理由と同じ本能です。
CursorはVS Codeに基づいたAI優先のコードエディターで、その最も価値のあるライブラリ作業の機能はチャットボックスではありません。 リンクからライブラリのドキュメントを取得し、プロジェクトのルールをリポジトリにコミットする能力です。これにより、エディターはIronPDFの実際のAPIから回答を得て、あなたのチームの規約に従います。IronPDFは埋め込みのChromiumエンジンを通じてHTML、CSS、JavaScriptをPDFに変換します。どちらのツールも他方について知識を持たず、インストールする統合はありません。 代わりに設定するのはコンテキストで、そのセットアップについてこのガイドの前半で説明します。
始める前に区別が一つ、二つの類似したトピックが混同されがちです。 このガイドは、IronPDFを使用してソフトウェアを構築するためにAIエディターを利用する方法についてです。 それは、PDFファイルの内容を読んだり分析したりするためにAIモデルを使用することについてではありません。この話題はAIを使ったPDF処理のチュートリアルで別途説明されています。
クイックスタートCursorでC#プロジェクトを開き、モデルのメモリではなくIronPDFのドキュメントに対してプロンプトを行います:
Read https://ironpdf.com/llms.txt and the pages it links to.
In this C# project, create Program.cs that renders "<h1>Hello from IronPDF</h1>"
to hello.pdf. Read the license key from the IRONPDF_LICENSE_KEY environment
variable. Use only methods that appear in the linked documentation.
Cursorは重要な数行を書きます:ChromePdfRendererを構築し、RenderHtmlAsPdfをマークアップで呼び出し、結果をディスクにSaveAsします。 最初の行のドキュメントリンクは、一般的なチャットウィンドウに入力した同じリクエストとこれを区別するものであり、設定することが下の最初の実際のセクションです。
短い安全性に関するノートです。 ファイル書き込みやターミナルアクセスを持つエージェントにライセンスキーをインラインで渡すべきではありません。それを環境変数やソースコントロールから除外された設定ファイルに保管してください。 ライセンスキーガイドはサポートされているオプションを説明しています。
最小限のワークフロー(5ステップ)
- NuGetからC# PDFライブラリをダウンロード
- Cursorを
llms.txtへのリンクでIronPDFドキュメントに向けます - IronPDFのバージョンと独自の規約を固定するプロジェクトルールをコミットします
@メンションとプロンプト時のドキュメントリンクで特定のファイルを参照します- ビルドし、PDFを開いて、APIリファレンスと照らし合わせてすべてのAPI名を確認します
チャットボックスの背後で実際に何が動いているのですか?
Cursorには単一のモデルが付属していません。 独自のものを出荷し、同じエディターを他の誰かにポイントすることもできます。
ComposerはCursor独自のエージェントモデルです。 モデルピッカーは、Cursorが共同開発したSpaceXAIのGrokモデルやOpenAI、Anthropic、Google、その他の研究所のモデルも提供します。 1つのセッション内でそれらを切り替えることができます。 Tab、Cursorのインライン補完機能は、行を完了し次の編集を予測します。 以下のテスト実行ではGrok 4.7を使用しました。
PDF作業において、それは計画すべき実用的な結果を1つ持ちます。 ドキュメントセッションの大部分は安価で反復的な作業です: マージンを調整し、再構築し、出力を確認し、再度調整します。 時々、コンパイラが説明しない理由で表がページをまたいで崩れることがあり、それは編集前によく考えるモデルに移行する時です。 文書が選択によっても変わることを予期してください。 2つのモデルに渡された同じプロンプトは、スペースやページブレークが異なる2つのレイアウトを返しますが、それでも明示的に指定されたものを捉えます。これはページ数、ヘッダーテキスト、フッターフォーマットを固定する理由であり、デフォルトを信頼する理由にはなりません。
それはこのシリーズがここで重なっていることも意味します。 Cursor内でClaudeモデルを実行し、Claude Codeガイドでの観察がその出力にも適用されます。モデルが同じでも表面が違うからです。
CursorにIronPDFのドキュメントをどのように提供して推測を止めさせますか?
Cursorは@Docsメンションのバックに外部ドキュメントをインデックスすることがありました。 3.21リリースノートには、Docsオプションが "すでにエージェントコンテキストにドキュメントを追加するのを停止して"、それを@メニューから削除したことが記録されています。 今日うまくいくのはリンクです。 Cursorのエージェントには、プロンプトで指定したURLを取得するWebツールがあり、IronPDFはそのドキュメントページのインデックスであるllms.txtを公開しています。 Cursor CLIでの調査では、エージェントはそのインデックスを取得し、その後それがリンクするヘッダーとフッターのページを取得してから回答しました。 このガイドで最も高価値の設定ステップはCursorにIronPDFドキュメントを与えることです。なぜならそれによって想起が取得に置き換わるからです。
この理論を何か新しい人に対してはっきり言う価値があります。 特定のライブラリについて質問されたモデルは、トレーニング中に吸収したものに頼り、それが1年古かったり、最新リリースに対して確認されたことがない状態です。 ドキュメントリンクはエディターに参照するものを提供します。 違いはメソッド名にすぐに現れます:裏付けのないモデルはrenderer.ConvertHtmlToPdfDocument()を作り出し、それはコンパイラが異議を唱えるまで完全に読み取れます。
リンクは1行のテキストとしてプロンプトに入ります:
Use the IronPDF docs at https://ironpdf.com/llms.txt.
What are the options for adding a footer with page numbers to a rendered PDF?
Show the exact class and property names from the documentation, and link the
page you took them from.
ソースページを求めることは安価な検証習慣です。 エディターが推奨したAPIの実際のドキュメントページを指し示せない場合、それはコードを書く前にチェックするシグナルです。
IronPDFの規約をエンコードするプロジェクトルールを書くにはどうすればいいですか?
Cursorのプロジェクトルールはリポジトリのルートにある.cursor/rulesディレクトリに存在し、バージョン管理されているため、コードと一緒にコミットされ、すべての開発者は何も設定せずに同じ動作を引き継ぎます。
ルールは.mdcファイルです:description、globs、alwaysApplyを持つYAMLフロントマター付きのマークダウンです。 Cursorはそれらを再帰的に読み取るため、サブディレクトリが機能します。 そのフォルダにある通常の.mdファイルは無視されます。なぜならフロントマターがないためです。 IronPDFの規約のルールはこれのようになります:
---
description: IronPDF conventions for PDF generation in this project
globs: **/Services/**/*.cs, **/Pdf/**/*.cs
alwaysApply: false
---
# IronPDF conventions
- Use ChromePdfRenderer for all HTML-to-PDF conversion.
- Target the IronPDF version pinned in Directory.Packages.props. Do not upgrade it
as part of an unrelated change.
- Never inline a license key. Read it from configuration or the
IRONPDF_LICENSE_KEY environment variable.
- Prefer the shared PdfDocumentService helper over constructing a renderer
per call. A ChromePdfRenderer instance is reusable.
- Use the async rendering methods in web request paths.
- Do not invent IronPDF API names. If a method is uncertain, say so and cite
the documentation instead of guessing.
最後の行は見た目以上の作業をしています。 モデルに不確実性を認めることが許されることを伝えることは、発明的なAPIを減らし、それをコミットされたルールに置くことでプロンプトごとに繰り返すのをやめることを意味します。
globs行は故意にコピーする価値のある部分です。 alwaysApply: trueとしてマークされたすべてのものは、すべてのリクエストにロードされ、コンテキスト予算を消費します。そのため、IronPDFルールをPDFコードが実際に存在するパスに制限することで、レンダリングに関係のないリクエストから除外します。
AGENTS.mdを読み込みます。同じファイルをChatGPT CodexとGoogle Antigravityも読み込みます。 それはフロントマターを持たないので、グロブがなく、常に適用されます。 スコーピングが必要な時は.cursor/rulesを使用し、複数のツールが対応する1つの指示ファイルが必要な時はAGENTS.mdを使用してください。1つの制限事項が人々を驚かせます: ルールはエージェントとチャットのやり取りに適用され、Tab補完やインライン編集には適用されません。 ルールにエンコードされた規約はエージェントが書くものを形作り、Tabから別の提案がされることを止めません。 ルールが無視されていると結論付ける前に知っておく価値があります。
どのモードが変更に適していますか?
Cursorはいくつかの異なる方法で編集を行う方法を提供しており、間違ったものを選択すると時間を無駄にします。役立つ本能はスケールです。
| モード | 必要となるとき | 典型的なPDFタスク |
|---|---|---|
| タブ | すでにタイピングしていて次の編集は予測可能 | 以前に設定したレンダリングオプションプロパティを終了 |
| インライン編集 | 変更が1文で収まり、1ファイルにある | マージン、フッター、またはページサイズ設定の追加 |
| エージェント | 作業がファイル全体に及ぶか、ビルドと修正ループが必要 | レンダラーをサービスに接続してコンパイルさせる |
| まず計画 | リライトが大きすぎて、後からレビューするより先に同意する方が悪い | 他のPDFライブラリからのレポートジェネレーターの移行 |
| クラウドエージェント | タスクが監視を必要とせず、何もブロックしない場合 | PDF出力周辺のテストスイートを書く |
レンダラーへのインライン編集は最も明確なイラストレーションで、変更を説明し、その場で差分をレビューするため、新しいファイルを読むのではありません:
Add a 25mm top margin and an HTML footer showing "{page} of {total-pages}",
centered, max height 15mm.
ファイルに収まるものは、一目で確認できるくらい短いです:
var renderer = new ChromePdfRenderer();
renderer.RenderingOptions.MarginTop = 25;
renderer.RenderingOptions.HtmlFooter = new HtmlHeaderFooter
{
MaxHeight = 15,
HtmlFragment = "<div style='text-align:center'>{page} of {total-pages}</div>",
};
MarginTop = 25はIronPDFのデフォルトの上部マージン25ミリメートルを再定義しているため、その行はページを変更しません。 どちらのマージンもフッターを移動させません。 下部マージンは本文が画像の上でどこで終了するかを設定し、このページの後で示されるフッター修正のようにします。
{page}および{total-pages}は、文字列プレースホルダではなく、IronPDF独自のマージフィールドです。これはドキュメントでうまく扱われる詳細であり、多くの場合、裏付けのない推測は正しく行いません。
@メンションは実際に何を変えるのですか?
コンテキスト言及はエディターに何を見ればいいかを正確に伝えます。 PDFを構築するファイルを指定する方が、説明するより遥かに良い結果を生み出します。なぜなら、説明は損失があるのに対し、ファイル参照は損失がないからです。
@Services/InvoiceRenderer.cs @Templates/invoice.html Use the IronPDF docs at https://ironpdf.com/llms.txt.
The footer overlaps the last line of the invoice table. Fix it in the renderer
configuration, not the template. Explain which setting causes the overlap.
ファイルに加えて、Cursorの@メニューは、モジュール全体にまたがる作業、省ターミナル出力、以前のチャット、Git差分、組み込みブラウザのためフォルダを受け入れます。 どのファイルが重要であるかわからない場合は、メンションを省略し、エージェントがコードベース自体を検索します。 上記のように、ファイルとドキュメントリンクを組み合わせるパターンがIronPDFの作業を正確なままに保ちます:ファイルは現在あなたのコードで何を行っているかを提供し、ドキュメントはライブラリが実際に提供するものを供給します。
その特定のプロンプトは、基礎が重要である理由も示しています。 対応するマージンがないまま設定されたフッターは、本体に重なります。なぜなら、フッターはコンテンツが自ら放棄しないスペースを占有するからです。 これはレンダラー設定であってCSS問題ではなく、ヘッダーとフッターガイドがその関係を文書化しています。
これは修正後にレンダリングされたテスト実行の請求書です:
IronPDFへの移行をどのように計画し実行しますか?
移行は未レビューのマルチファイルリライトが高価になる場所であり、それを解くのは書くより難しいです。 実装前に計画を立てることがこれに正確にあるのです: 目標を取って、疑問を明確にし、コードを書く前に編集可能な計画を作ります。
@Reports/ Use the IronPDF docs at https://ironpdf.com/llms.txt.
This folder builds PDFs by positioning text at coordinates with another library.
Plan a migration to IronPDF using HTML templates.
Summarize what the current output looks like, covering page size, sections, and
fonts, then propose the template structure and the files that change. Keep
existing public method signatures so callers don't change. Don't write code yet.
計画をレビューし、1~2文で修正し、それを実装するために返します。 エージェントモードはコードベースを読み、ファイル全体を編集し、ターミナルコマンドを実行し、出力を読み取り、繰り返すため、フォローアップは短くなります。
Implement the approved plan. Then run dotnet build, fix what breaks, and
show me the diff. Don't add new packages.
エージェントを承認された計画に制限し、新しいパッケージを禁止することは見た目以上に重要です。 無制約のエージェントは、移行を呼び出し規約をボーナスとして再設計する招待状と見なす傾向があります。
監督を必要としない作業は、あなたが別の場所で続ける間、クラウドエージェントで実行できます。 PDF出力周辺のテストスイートは良い候補で、ドキュメントではなく実装に基づいてテストし、移行を最初に完了する必要はありません:
Write xUnit tests for the migrated report output: result is non-empty, begins
with the %PDF- signature, extracted text contains the bound company name, and
page count matches expectation. No golden-file byte comparisons, since
rendering output is not byte-stable across versions or platforms.
バイト比較を除外することは、さもなければ誰かの午後を費やすであろう不安定なテストの全クラスを防ぎます。
レンダリング問題は実際どこに存在しますか?
IronPDFがブラウザとPDFの違いについてドキュメント化している原因の3つは、画面ではなく印刷メディア用に書かれたスタイルシート、レイアウトが計算された時点でロードされていなかったウェブフォント、そして早すぎる段階でキャプチャされたJavaScriptによって生成されたコンテンツです。 症状とファイル名を名付けることは、プロジェクト全体を貼り付けるよりも遥かに役立つ答えを導き出します。
@Templates/report.html @Services/ReportRenderer.cs Use the IronPDF docs at https://ironpdf.com/llms.txt.
The report renders correctly in Chrome but the PDF drops the logo and splits a
table row across pages. Explain the cause of each before changing anything,
then fix the table break in CSS and the logo in the renderer configuration.
診断を修正から分離することで、逆工学する変更ではなく評価できるものを得ることができます。 この場合、2つの問題は異なるホームを持ち、ページブレーク動作はスタイルシートに属し、ページブレークガイドでカバーされている一方、ブラウザで解決し、レンダリングで解決しないロゴは通常ベースパスの問題であり、生のHTML文字列は相対URLを解決するためのドキュメントの場所を持たないためです。
これは両方の修正後にレンダリングされたテスト実行のサイトレポートです:
デプロイメントの失敗は、ターミナルアクセスがその場所を得る場所であり、答えは通常コードではなくコンテナに存在します。
@Dockerfile Use the IronPDF docs at https://ironpdf.com/llms.txt.
Rendering works on Windows but fails in our Linux container with:
[PASTE FULL EXCEPTION AND STACK TRACE HERE]
Check for missing native dependencies IronPDF's Chromium engine needs on
Debian-based images. Explain the cause, then propose the Dockerfile change.
Don't modify C# code unless the cause is there.
アプリケーションコードに触れるなという指示は意図的です。 イメージ内の欠落した共有ライブラリはC#の問題ではなく、自由に操作できるエージェントは時々呼び出しを失敗を隠すtry/catchで包むことがあります。 Dockerデプロイメントガイドはリリース間で変化する現在の要件を文書化しています。
プロンプトが実運用で生成したものは何ですか?
このページの9つのプロンプトのうち7つは、1つのCursor CLIセッション、バージョン2026.10.14-941492eで順番に実行されました。 インライン編集はCursorデスクトップアプリで実行され、バージョン3.23.23でした。プロジェクトは小さな.NET 8のアプリケーションで、IronPDF 2026.10.3のすべてのファイルを持ち、プロンプトが名前を付け、彼らが記述した欠陥も含んでいました。以下の数字はエージェントが書いたコードの独立したレンダーから来たもので、エージェントの返答からのものではありません。
- エージェントはセッション中に21の異なるIronPDFドキュメントページをllms.txtから始めて取得しました。
- フッターの回答で名前を挙げたすべてのクラスとメンバーはIronPDF 2026.10.3に存在し、引用したすべての7ページがロードされました。
- クイックスタートプログラムはキーセット付きで17,385バイトの1ページのhello.pdfを書き、SaveAsでそれを持たずにLicensingExceptionを投げました。
- インライン編集は上部マージン25 mmを追加しました。これはIronPDFのデフォルトであり、中央に "1 of 1" を印刷するフッターでした。
- フッター修正の前に、Total due行は1ページの請求書の最初のフッター行に印刷されました。
- 修正はInvoiceRenderer.csの下部マージンを10から40ミリメートルに引き上げ、テンプレートは変更しませんでした。
- 修正後、請求書の行はフッターに触れず、合計は2ページ目に移動しました。
- 移行はすべての4つの公開メソッド署名を保持し、PDFsharpを削除し、パッケージを追加しませんでした。
- 移行報告書は2ページのA4、Arialフォント、節順および地域の合計を保持しました。
- 同じ移行報告書の2つのレンダーは、サイズが同じでバイトが異なりました。
- xUnitテストはキー付きで4の4に合格し、なしでは0の4に合格しました。
- レンダリング修正の前に、サイトレポートはロゴのaltテキストを示し、その最後のテーブル行をページ1と2に分割しました。
- 修正はテンプレートフォルダを基準パスとして提供し、スタイルシートルールは各テーブル行を一緒に保ちました。
- 修正後、ロゴはページ1に現れ、最後の行は全体でページ2に移動しました。
- CLIプローブでは、規則ファイルはコンマセパレートグロブで6の6回テストに適用され、YAMLリストでは0の6回適用されました。
- 一部のステップはページと異なる方法で実行されました。 CLIは各@メンションをプレーンテキストとして送信し、エージェントは独自のツールで名前の付いたファイルを開きました。 移行計画の後、セッションは計画モードに留まり、次の2つのプロンプトはフォローアップメッセージが構築した計画を返しました。 テストスイートはローカルエージェントとして実行されました。クラウドエージェントはホストされたリポジトリが必要だからです。 インライン編集プロンプトはCursorデスクトップアプリで実行され、それをエージェントチャットとして記録し、選択された行が添付されました。 Dockerプロンプトは実行されませんでした。テストマシンにはDockerやLinux環境がないからです。
AIコーディングアシスタントガイドのラン記録には、このシリーズの各ガイドのツール、モデルおよび期間がリストされています。
最初に何をセットアップすべきですか?
まず最初に基礎です。 IronPDFのドキュメントをリンクし、スコープされたプロジェクトルールを1つコミットするのに約15分かかり、それ以降すべてのプロンプトに適用され、これがこのワークフローと一般的なチャットアシスタントに質問を貼り付けることの違いのすべてです。 それ以降、インライン編集、言及、計画、エージェントはすべて、基礎が整っているとより良く機能する通常のエディター使用です。
どのモデルが回答しているかに関わらず確認の習慣は同じです: 早めにビルドし、PDFを開いて、何かを出荷する前にドキュメンテーションとAPI名を確認します。 開始から完了まで実行され、公開された結果と共に、その確認の再現可能なバージョンは、AIコーディングアシスタントガイドにあり、ChatGPT Codex、GitHub Copilot、およびGoogle Antigravityのガイドと並んでいます。
トラブルシューティング
- IronPDFでのライセンスキーの適用: PDFの保存がライセンス例外をスローする場合
- RenderingOptionsの初期化方法が正しいか: 推奨されたオプション名が解決されない場合
- どのバージョンのIronPDFを使用すべきですか?: あなたのプロジェクトルールでバージョンを固定する
- DockerコンテナでIronPDFを実行する方法:レンダリングがローカルで動作し、コンテナ内で失敗する場合
質問ありますか?
質問がある場合は、support@ironsoftware.com にお問い合わせください。
Curtis Chauは、カールトン大学でコンピュータサイエンスの学士号を取得し、Node.js、TypeScript、JavaScript、およびReactに精通したフロントエンド開発を専門としています。直感的で美しいユーザーインターフェースを作成することに情熱を持ち、Curtisは現代のフレームワークを用いた開発や、構造の良い視覚的に魅力的なマニュアルの作成を楽しんでいます。