Comment utiliser IronPDF avec Cursor

Curtis Chau
Curtis Chau
Mis à jour : 26 octobre 2026

Demandez à n'importe quel assistant IA d'écrire du code IronPDF et il produira quelque chose qui semble correct. Parfois, c'est le cas. D'autres fois, il appelle une méthode qui n'a jamais existé, et vous le découvrez lors de la compilation plutôt qu'à la révision. Le modèle ne fonctionne pas mal. Il comble un manque dans ce qu'il connaît avec quelque chose de plausible, ce qui est le même instinct qui le rend utile et dangereux à la fois.

Cursor est un éditeur de code axé sur l'IA construit sur VS Code, et sa fonctionnalité la plus précieuse pour le travail sur une bibliothèque n'est pas la boîte de dialogue. C'est la capacité à récupérer la documentation d'une bibliothèque à partir d'un lien et à engager les règles du projet dans le référentiel, de sorte que l'éditeur réponde à partir des véritables API d'IronPDF et suive les conventions de votre équipe sans avoir à le redire deux fois. IronPDF rend HTML, CSS et JavaScript en PDF via un moteur Chromium intégré. Aucun outil ne connaît l'autre, et il n'y a pas d'intégration à installer. Ce que vous configurez à la place, c'est du contexte, et cette configuration est ce que couvre la première moitié de ce guide.

Une distinction avant de commencer, car deux sujets similaires se confondent. Ce guide porte sur l'utilisation d'un éditeur IA pour construire des logiciels avec IronPDF. Il ne s'agit pas d'utiliser des modèles d'IA pour lire ou analyser le contenu des fichiers PDF, que le tutoriel de traitement des PDF propulsé par l'IA couvre séparément.

Démarrage rapide
NuGetInstaller avec NuGet

PM > Install-Package IronPdf

Installez IronPDF en exécutant la commande ci-dessus dans la console du gestionnaire de packages NuGet, ou recherchez le package dans le gestionnaire de packages NuGet.

Ouvrez un projet C# dans Cursor et interrogez la documentation d'IronPDF plutôt que la mémoire du modèle :

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.
Text

Cursor écrit les quelques lignes qui importent : construisez un ChromePdfRenderer, appelez RenderHtmlAsPdf sur le balisage, et SaveAs le résultat sur le disque. Le lien de documentation sur la première ligne est ce qui distingue cette requête de la même tapée dans une fenêtre de chat général, et le configurer est la première véritable section ci-dessous.

Une courte note de sécurité. Un agent avec accès en écriture de fichier et au terminal ne devrait jamais recevoir une clé de licence en ligne, donc gardez-la dans une variable d'environnement ou un fichier de configuration exclu du contrôle du code source. Le guide des clés de licence couvre les options supportées.



Que se passe-t-il réellement derrière la boîte de dialogue ?

Cursor ne vient pas avec un seul modèle attaché. Il embarque le sien, et vous permet aussi de diriger le même éditeur vers celui de quelqu'un d'autre.

Composer est le propre modèle agentique de Cursor. Le sélecteur de modèle offre également les modèles Grok de SpaceXAI, que Cursor a co-développés, ainsi que des modèles d'OpenAI, Anthropic, Google et d'autres laboratoires. Vous pouvez les échanger au sein d'une seule session. Tab, le complément en ligne de Cursor, termine une ligne et prédit la prochaine édition. Le test réalisé ci-dessous a utilisé Grok 4.7.

Pour le travail avec des PDF, cela a une conséquence pratique qui vaut la peine d'être planifiée. La plupart d'une session de document consiste en un travail bon marché et répétitif : ajuster une marge, reconstruire, regarder le résultat, ajuster à nouveau. Parfois, un tableau se casse à travers une page pour une raison qu'aucun compilateur n'expliquera, et c'est le moment de passer à un modèle qui réfléchit plus longtemps avant d'éditer. Attendez-vous à ce que le document change avec le choix également. La même invite donnée à deux modèles renvoie deux mises en page qui diffèrent dans l'espacement et les sauts de page tout en respectant ce que vous avez spécifié explicitement, ce qui est l'argument pour épingler le compte de pages, le texte d'en-tête, et le format de pied de page plutôt que de faire confiance à une valeur par défaut.

Cela signifie aussi que cette série se chevauche ici. Exécutez un modèle Claude dans Cursor et les observations dans le guide Claude Code s'appliquent toujours à son résultat, car le modèle est le même même si la surface ne l'est pas.

Comment donner à Cursor la documentation d'IronPDF pour qu'il arrête de deviner ?

Cursor utilisait pour indexer la documentation externe derrière une mention @Docs. Ses notes de version 3.21 enregistrent que l'option Docs "avait déjà cessé d'ajouter de la documentation au contexte de l'agent" et l'ont retirée du menu @. Ce qui fonctionne aujourd'hui est un lien. L'agent de Cursor a un outil web qui récupère une URL nommée dans l'invite, et IronPDF publie llms.txt, un index de ses pages de documentation. Lors d'un essai avec l'interface CLI de Cursor, l'agent a récupéré cet index puis les pages d'en-têtes et de pieds de page auxquelles il renvoie avant de répondre. Donner la documentation d'IronPDF à Cursor est l'étape à plus haute valeur de configuration de ce guide, car cela remplace le rappel par la récupération.

La raison vaut la peine d'être énoncée clairement pour quiconque est nouveau à cela. Un modèle interrogé sur une bibliothèque spécifique s'appuie sur ce qu'il a absorbé pendant l'entraînement, ce qui peut être vieux d'un an et n'a jamais été vérifié par rapport à la version actuelle. Un lien de documentation donne à l'éditeur quelque chose à consulter. La différence se manifeste immédiatement dans les noms de méthodes : un modèle sans base invente renderer.ConvertHtmlToPdfDocument(), et cela semble parfaitement correct jusqu'à ce que le compilateur soit en désaccord.

Le lien va dans une invite sous forme d'une seule ligne de texte :

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.
Text

Demander la page source est une habitude de vérification bon marché. Si l'éditeur ne peut pas pointer sur une vraie page de documentation pour l'API qu'il vient de recommander, c'est un signal pour vérifier avant d'écrire du code contre elle.

Conseils: Cela rapporte à nouveau plus tard, sur les classes inconnues. Demandez à l'éditeur de résumer le type d'options de rendu et de lister lesquelles votre projet a déjà définies, et la référence API devient quelque chose à interroger au lieu de faire défiler.

Comment écrivez-vous des règles de projet qui encodent vos conventions IronPDF ?

Les règles du projet Cursor vivent dans un répertoire .cursor/rules à la racine du référentiel et sont contrôlées par version, de sorte qu'elles sont commises avec le code et chaque développeur hérite du même comportement sans rien configurer.

Les règles sont des fichiers .mdc : des markdown avec un en-tête YAML contenant description, globs, et alwaysApply. Cursor les lit de manière récursive, donc les sous-répertoires fonctionnent. Un fichier .md simple dans ce dossier est ignoré, car il n'a pas d'en-tête pour l'activer. Une règle pour les conventions IronPDF ressemble à ceci :

---
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.
Text

Cette dernière ligne fait plus de travail qu'il n'y paraît. Dire au modèle qu'admettre l'incertitude est acceptable réduit les API inventées, et le mettre dans une règle engagée signifie que vous n'avez plus à le répéter à chaque incitation.

La ligne globs est la partie qui mérite d'être copiée délibérément. Tout ce qui est marqué alwaysApply: true se charge dans chaque requête et consomme le budget de contexte, donc restreindre la règle IronPDF aux chemins où le code PDF réside réellement le garde hors des requêtes qui n'ont rien à voir avec le rendu.

Veuillez noter: Cursor lit également un fichier simple AGENTS.md à la racine du projet, le même fichier que ChatGPT Codex et Google Antigravity lisent. Il ne porte pas de frontmatter, donc il n'a pas de globs et s'applique toujours. Utilisez .cursor/rules lorsque vous souhaitez une portée, et AGENTS.md lorsque vous souhaitez un fichier d'instructions unique que plusieurs outils respectent.

Une limite surprend les gens : les règles s'appliquent aux interactions d'agent et de chat, pas à la complétion Tab ou aux modifications en ligne. Une convention encodée dans une règle façonne ce que l'agent écrit et n'empêchera pas Tab de suggérer autre chose. Bon à savoir avant de conclure qu'une règle est ignorée.

Quel mode convient au changement ?

Cursor offre plusieurs façons distinctes de faire une modification, et choisir la mauvaise fait perdre du temps. L'instinct utile est l'échelle.

ModeAllez le chercher quandTâche PDF typique
OngletVous tapez déjà et la prochaine édition est prévisibleFinir une propriété d'options de rendu que vous avez déjà définie
Édition en ligneLe changement tient en une phrase et réside dans un fichierAjouter une marge, un pied de page, ou un réglage de taille de page
AgentLe travail s'étend sur des fichiers, ou nécessite une boucle de compilation et de correctionConnecter un moteur de rendu à un service et le faire compiler
Planifiez d'abordUne réécriture est assez importante pour qu'il serait pire de l'examiner après coup que de s'entendre dessus d'abordMigrer un générateur de rapport d'une autre bibliothèque PDF
Agent cloudLa tâche n'a pas besoin d'être surveillée et ne bloque rienÉcrire une suite de tests autour de la sortie PDF

Une édition en ligne sur un moteur de rendu est la plus claire illustration, car vous décrivez le changement et examinez un diff en place plutôt que de lire un nouveau fichier :

Add a 25mm top margin and an HTML footer showing "{page} of {total-pages}",
centered, max height 15mm.
Text

Ce qui arrive dans le fichier est assez court pour être vérifié d'un coup d'œil :

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>",
};
C#

MarginTop = 25 réaffirme la marge supérieure par défaut de 25 millimètres d'IronPDF, de sorte que cette ligne laisse la page inchangée. Aucune des marges ne déplace le pied de page. La marge inférieure définit où le corps s'arrête au-dessus, comme le montre la correction du pied de page plus tard sur cette page.

{page} et {total-pages} sont les propres champs de fusion d'IronPDF plutôt que des espaces réservés de chaînes que vous substituez vous-même, ce genre de détail que la documentation obtient bien et qu'une estimation sans base généralement n'obtient pas.

Que change réellement une mention @ ?

Les mentions de contexte disent à l'éditeur exactement quoi regarder. Nommer le fichier qui construit un PDF produit un bien meilleur résultat que le décrire, parce qu'une description est une perte et une référence de fichier ne l'est pas.

@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.
Text

En plus des fichiers, le menu @ de Cursor prend des dossiers pour des travaux couvrant un module, des sorties terminales, des discussions antérieures, des diffs Git, et le navigateur intégré. Lorsque vous ne savez pas quel fichier est important, laissez la mention de côté et l'agent recherche la base de code lui-même. Combiner un fichier avec un lien de documentation, comme ci-dessus, est le modèle qui maintient la précision du travail sur IronPDF : le fichier fournit ce que fait actuellement votre code et les docs fournissent ce que la bibliothèque offre réellement.

Cette invite particulière illustre également pourquoi le fondement est important. Un pied de page configuré sans une marge correspondante chevauche le corps, car le pied de page occupe l'espace que le contenu ne cède pas de lui-même. C'est un paramètre de moteur de rendu plutôt qu'un problème CSS, et le guide des en-têtes et pieds de page documente la relation.

Voici la facture rendue lors du test après la correction :

Comment planifiez-vous et exécutez-vous une migration vers IronPDF ?

Les migrations sont là où une réécriture multi-fichier non reviewée devient coûteuse, car en défaire une est plus difficile que l'écrire. Planifier avant l'implémentation existe précisément pour cela : cela fixe l'objectif, pose des questions clarificatrices, et produit un plan éditable avant que du code ne soit écrit.

@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.
Text

Examinez le plan, corrigez-le en une phrase ou deux, et le renvoyez pour mise en œuvre. Le mode agent lit la base de code, édite à travers les fichiers, exécute des commandes terminales, lit le résultat, et itère, donc le suivi est court :

Implement the approved plan. Then run dotnet build, fix what breaks, and
show me the diff. Don't add new packages.
Text

Contraindre l'agent au plan approuvé et interdire de nouveaux packages compte plus qu'il n'y paraît. Les agents laissés sans contrainte ont tendance à traiter une migration comme une invitation à redessiner la convention d'appel en prime.

Un travail qui ne nécessite pas de supervision peut fonctionner dans un agent cloud pendant que vous continuez ailleurs. Une suite de tests autour de la sortie PDF est un bon candidat, car les tests affirment sur le document plutôt que sur l'implémentation et n'ont pas besoin que la migration soit terminée en premier.

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.
Text

Exclure la comparaison d'octets empêche toute une classe de tests instables qui coûteraient sinon un après-midi à quelqu'un.

Où se situent réellement les problèmes de rendu ?

Trois des causes qu'IronPDF documente pour les différences entre le navigateur et le PDF sont une feuille de style écrite pour les médias d'écran plutôt que d'impression, une police web qui n'était pas chargée lorsque la mise en page a été calculée, et un contenu produit par JavaScript qui a été capturé trop tôt. Nommer le symptôme et le fichier obtient une réponse bien plus utile que coller le projet entier.

@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.
Text

Séparer le diagnostic de la correction vous donne quelque chose à évaluer plutôt qu'un changement à rétro-concevoir. Dans ce cas, les deux problèmes ont des chez-soi différents : le comportement de saut de page appartient à la feuille de style, couvert par le guide des sauts de pages, tandis qu'un logo qui se résout dans un navigateur et non dans le rendu est généralement une question de chemin de base, car une chaîne HTML brute ne porte pas d'emplacement de document pour résoudre des URL relatives.

Voici le rapport du site rendu lors du test après les deux corrections :

Les échecs de déploiement sont là où l'accès terminal gagne sa place, puisque la réponse se trouve généralement dans le conteneur plutôt que dans le code.

@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.
Text

L'instruction de ne pas toucher le code d'application est délibérée. Une bibliothèque partagée manquante dans une image n'est pas un problème C#, et un agent donné carte blanche enveloppera parfois l'appel dans un try/catch qui cache l'échec plutôt que de le corriger. Le guide de déploiement Docker documente les exigences actuelles, qui changent entre les versions.

Qu'est-ce que les messages ont produit lors d'une réelle exécution ?

Sept des neuf invites sur cette page ont été exécutées dans l'ordre lors d'une session Cursor CLI, version 2026.10.14-941492e. L'édition en ligne a été effectuée dans l'application de bureau Cursor, version 3.23.23. Le projet était une petite application .NET 8 sur IronPDF 2026.10.3 avec chaque fichier que les invites nomment et les défauts qu'elles décrivent. Les chiffres ci-dessous proviennent de rendus indépendants du code que l'agent a écrit, non de ses réponses.

  • L'agent a récupéré 21 pages de documentation différentes d'IronPDF au cours de la session, en commençant par llms.txt.
  • Chaque classe et membre nommé dans la réponse de pied de page existait dans IronPDF 2026.10.3, et toutes les sept pages citées ont été chargées.
  • Le programme Quickstart a écrit un hello.pdf d'une page de 17 385 octets avec la clé configurée et a déclenché une LicensingException à SaveAs sans elle.
  • L'édition en ligne a ajouté une marge supérieure de 25 mm, qui est la marge par défaut d'IronPDF, et un pied de page centré qui a imprimé "1 de 1".
  • Avant la correction du pied de page, la ligne Total dû a été imprimée sur la première ligne de pied de page d'une facture d'une page.
  • La correction a relevé la marge inférieure dans InvoiceRenderer.cs de 10 à 40 millimètres et a laissé le modèle inchangé.
  • Après la correction, aucune ligne de la facture n'a touché le pied de page, et les totaux ont été déplacés vers une deuxième page.
  • La migration a conservé les quatre signatures de méthodes publiques, a retiré PDFsharp et n'a ajouté aucun paquet.
  • Le rapport migré a conservé deux pages A4, les polices Arial, l'ordre des sections et le total régional.
  • Deux rendus du même rapport migré avaient la même taille et des octets différents.
  • Les tests xUnit ont réussi 4 sur 4 avec la clé et 0 sur 4 sans elle.
  • Avant la correction du rendu, le rapport du site montrait le texte alternatif du logo et divisait sa dernière ligne de table sur les pages 1 et 2.
  • La correction a passé le dossier modèle en tant que chemin de base, et une règle de feuille de style a maintenu chaque ligne de table ensemble.
  • Après la correction, le logo a apparu sur la page 1 et la dernière ligne a été déplacée entière sur la page 2.
  • Lors des tests CLI, le fichier de règle a été appliqué dans 6 des 6 tests avec des globs séparés par des virgules et dans 0 des 6 avec une liste YAML.
  • Certaines étapes ont été exécutées différemment de la page. L'interface CLI a envoyé chaque mention @ sous forme de texte brut, et l'agent a ouvert les fichiers nommés avec ses propres outils. Après le plan de migration, la session est restée en mode plan, donc les deux invites suivantes ont retourné des plans qu'un message de suivi a construits. La suite de tests a été exécutée en tant qu'agent local, car les agents en cloud nécessitent un référentiel hébergé. L'invite d'édition en ligne a été exécutée dans l'application de bureau Cursor, qui l'a enregistrée comme une conversation Agent avec la ligne sélectionnée attachée. L'invite Docker n'a pas été exécutée, car la machine de test n'a aucun environnement Docker ou Linux.

Le rapport d'exécution sur le guide des assistants de codage AI répertorie l'outil, le modèle et la durée de chaque guide de cette série.

Que devriez-vous configurer en premier ?

La mise en place avant tout. Lier la documentation d'IronPDF et engager une règle de projet ciblée prend environ quinze minutes, s'applique à chaque invite par la suite, et est toute la différence entre ce flux de travail et coller des questions dans un assistant de chat général. Tout ce qui suit, les éditions en ligne, les mentions, la planification, les agents, est une utilisation ordinaire de l'éditeur qui fonctionne simplement mieux une fois le fondement en place.

L'habitude de vérification reste la même quel que soit le modèle qui répond : construisez tôt, ouvrez le PDF, et vérifiez les noms d'API par rapport à la documentation avant que quoi que ce soit ne soit expédié. La version reproductible de cette vérification, exécutée du début à la fin avec un résultat publié, se trouve dans le guide des assistants de codage IA, aux côtés des guides pour ChatGPT Codex, GitHub Copilot, et Google Antigravity.


Dépannage


Des questions ?

Si vous avez des questions, contactez support@ironsoftware.com

Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes et créer des manuels bien structurés et visuellement attrayants.

Lire la suite

Prêt à commencer ?

Téléchargements NuGet 22,198,312Version :2026.11tout juste publié