syncfusion-dotnet-pdf

PDF Document Processing

Overview

Create, read, write, and convert PDF files using the Syncfusion PDF Library. This skill supports two operational modes — generating C# code for the user's project or executing tasks directly through a CSX script.

Key Capabilities

• Create & Edit: PDF files from scratch, text, images (various formats), tables, shapes, paragraphs, headings, styles, lists, hyperlinks, bookmarks, headers/footers, watermarks, template management, metadata editing
• Forms & Interactive Elements: Create, fill, and flatten forms (AcroForms and XFA), bookmarks, annotations, attachments, buttons, and content controls
• Advanced Features: Comments, layers (add, remove, flatten), PDF portfolios, JavaScript execution, 3D model embedding and interaction, rich media content (audio/video), optical character recognition (Tesseract engine), text redaction, image redaction, digital signatures and validation
• Conversion: SVG to PDF, XPS to PDF, PDF to PDF/A conformance
• Extraction: Extract text and images from PDF documents
• Security: Password encryption/decryption, advanced encryption standards, document protection with editable ranges, macro management, digital signing capabilities
• Barcodes & Standards: 1D barcodes, 2D barcodes, ZUGFeRD invoice support, PDF/A-1B, PDF/A-1A, PDF/A-2B, PDF/A-2A, PDF/A-2U, PDF/A-3B, PDF/A-3A, PDF/A-3U, PDF/A-4, PDF/A-4E, PDF/A-4F, PDF/X1-A conformances, Accessible PDF/Tagged PDF (PDF/UA) with Section 508 compliance
• Additional Operations: Merge and split PDF files, open and modify existing PDF files, compress PDF files, corrupted PDF detection.

Quick Start Examples

Example 1: Generate Code (Mode 1)

User: "Show me the C# code to create a PDF with a title, a heading, and a paragraph." Result: C# code snippet displayed (no files created)

Example 2: Execute Task (Mode 2)

User: "Generate a meeting agenda document and save it to output/agenda.pdf." Result: Physical file created at specified path

Two Modes — Choose Based on User Intent

Mode 1: Generate C# Code for the User's Project (default)

Trigger keywords: "code", "snippet", "how to write", "Program.cs", "show me", "sample", "example code", "generate code for".

Workflow:

1. Build the C# code using snippets from references/*.md files and replace placeholders with actual content
2. Add the code directly into the user's project files (e.g., Program.cs)
3. Do not create or run any .csx script

Note: Use Syncfusion.Drawing namespace for this code for cross-platform projects, not System.Drawing. This ensures compatibility across Windows, macOS, and Linux.

Note: If Syncfusion.Pdf.Net.Core package is suggested, then must be use the Syncfusion.Drawing namespace for graphics operations instead of System.Drawing to ensure cross-platform compatibility. The Syncfusion.Pdf.Net.Core package is designed to work with the Syncfusion.Drawing namespace, which provides a consistent API for drawing operations across different platforms. Using System.Drawing may lead to compatibility issues, especially on non-Windows platforms, as it relies on GDI+ which is not fully supported outside of Windows. Therefore, always use Syncfusion.Drawing when working with PDF graphics in a cross-platform context.

Note: If RectangleF, PointF, SizeF, or Color types are needed, use the ones from Syncfusion.Drawing namespace for cross-platform compatibility, not the ones from System.Drawing. This ensures that the code will work correctly on Windows, macOS, and Linux without relying on GDI+.

---

Mode 2: Execute via CSX Script (does not touch project files)

Trigger keywords: "create a pdf document", "make a document", "generate a document", "open", "edit", "modify", "change" a .pdf file, "without modifying my project", "run a csx script", or when the user provides a file path (e.g., output/report.pdf).

Workflow:

1. Create {skill-root}/syncfusion-dotnet-pdf/scripts/temp-{timestamp}.csx using references/template.csx as the base or references/template-ocr.csx for OCR-specific operations. Example, skill-root = .github/skills.
2. Add required operations from references/*.md snippets and replace placeholders with actual content
3. Run: dotnet script {skill-root}/syncfusion-dotnet-pdf/scripts/temp-{timestamp}.csx
4. Delete the temp script after execution
5. Report SUCCESS/ERROR and show the output file path

Note: Use Syncfusion.Drawing namespace for this csx script, not System.Drawing.

---

Code References

All templates and snippets are in the references/ folder:

---

Rules

• Output files go in ./output/ directory
• Temp .csx scripts must be created inside {skill-root}/syncfusion-dotnet-pdf/scripts/ — never in the workspace root or customer scripts/ folder
• Use license key from SyncfusionLicense.txt at workspace root
• Never use Python libraries (e.g., python-pdf)
• Never leave temp .csx files after execution
• Always use the latest NuGet package version

Prerequisites

• .NET SDK 8+ and dotnet-script: dotnet tool install -g dotnet-script
• Syncfusion License: SyncfusionLicense.txt or env var SYNCFUSION_LICENSE_KEY
• Free license: https://www.syncfusion.com/products/communitylicense

Documentations

• Syncfusion PDF Docs
• API Reference