QuestPDF 2024.6.4

There is a newer version of this package available.
See the version list below for details.
dotnet add package QuestPDF --version 2024.6.4                
NuGet\Install-Package QuestPDF -Version 2024.6.4                
This command is intended to be used within the Package Manager Console in Visual Studio, as it uses the NuGet module's version of Install-Package.
<PackageReference Include="QuestPDF" Version="2024.6.4" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add QuestPDF --version 2024.6.4                
#r "nuget: QuestPDF, 2024.6.4"                
#r directive can be used in F# Interactive and Polyglot Notebooks. Copy this into the interactive tool or source code of the script to reference the package.
// Install QuestPDF as a Cake Addin
#addin nuget:?package=QuestPDF&version=2024.6.4

// Install QuestPDF as a Cake Tool
#tool nuget:?package=QuestPDF&version=2024.6.4                

QuestPDF Homepage Getting started tutorial API reference Patterns and Practices GitHub Repo stars Nuget version Nuget download

QuestPDF is a modern open-source .NET library for PDF document generation. Offering comprehensive layout engine powered by concise and discoverable C# Fluent API. Easily generate PDF documents, reports, invoices, exports etc.

Usage animation of the PDF library

👨‍💻 Design PDF documents using C# and employ a code-only approach. Utilize your version control system to its fullest potential.

🧱 Compose PDF document with a range of powerful and predictable structural elements, such as text, image, border, table, and many more.

⚙️ Utilize a comprehensive layout engine, specifically designed for PDF document generation and paging support.

📖 Write code using concise and easy-to-understand C# Fluent API. Utilize IntelliSense to quickly discover available options.

🔗 Don't be limited to any proprietary scripting language or format. Follow your experience and leverage all modern C# features.

⌛ Save time thanks to a hot-reload capability, allowing real-time PDF document preview without code recompilation.

Simplicity is the key

How easy it is to start and prototype with QuestPDF? Really easy thanks to its minimal API! Please analyse the code below that generates basic PDF document:

using QuestPDF.Fluent;
using QuestPDF.Helpers;
using QuestPDF.Infrastructure;

// code in your main method
Document.Create(container =>
{
    container.Page(page =>
    {
        page.Size(PageSizes.A4);
        page.Margin(2, Unit.Centimetre);
        page.Background(Colors.White);
        page.DefaultTextStyle(x => x.FontSize(20));
        
        page.Header()
            .Text("Hello PDF!")
            .SemiBold().FontSize(36).FontColor(Colors.Blue.Medium);
        
        page.Content()
            .PaddingVertical(1, Unit.Centimetre)
            .Column(x =>
            {
                x.Spacing(20);
                
                x.Item().Text(Placeholders.LoremIpsum());
                x.Item().Image(Placeholders.Image(200, 100));
            });
        
        page.Footer()
            .AlignCenter()
            .Text(x =>
            {
                x.Span("Page ");
                x.CurrentPageNumber();
            });
    });
})
.GeneratePdf("hello.pdf");

Minimal PDF example

Let's get started

Begin exploring the QuestPDF library today. You are 250 lines of C# code away from creating a fully functional PDF invoice implementation.

Read the Getting Started tutorial to familiarize yourself with general library architecture, important layout structures as well as to better understand helpful patterns and practices.

Easily start designing your PDF documents, reports, invoices, exports and even more.

Getting started tutorial

Example invoice

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 is compatible.  net6.0-android was computed.  net6.0-ios was computed.  net6.0-maccatalyst was computed.  net6.0-macos was computed.  net6.0-tvos was computed.  net6.0-windows was computed.  net7.0 was computed.  net7.0-android was computed.  net7.0-ios was computed.  net7.0-maccatalyst was computed.  net7.0-macos was computed.  net7.0-tvos was computed.  net7.0-windows was computed.  net8.0 is compatible.  net8.0-android was computed.  net8.0-browser was computed.  net8.0-ios was computed.  net8.0-maccatalyst was computed.  net8.0-macos was computed.  net8.0-tvos was computed.  net8.0-windows was computed. 
.NET Core netcoreapp2.0 was computed.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 was computed.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net40 is compatible.  net403 was computed.  net45 was computed.  net451 was computed.  net452 was computed.  net46 was computed.  net461 was computed.  net462 was computed.  net463 was computed.  net47 was computed.  net471 was computed.  net472 was computed.  net48 was computed.  net481 was computed. 
MonoAndroid monoandroid was computed. 
MonoMac monomac was computed. 
MonoTouch monotouch was computed. 
Tizen tizen40 was computed.  tizen60 was computed. 
Xamarin.iOS xamarinios was computed. 
Xamarin.Mac xamarinmac was computed. 
Xamarin.TVOS xamarintvos was computed. 
Xamarin.WatchOS xamarinwatchos was computed. 
Compatible target framework(s)
Included target framework(s) (in package)
Learn more about Target Frameworks and .NET Standard.
  • .NETStandard 2.0

    • No dependencies.
  • net6.0

    • No dependencies.
  • net8.0

    • No dependencies.

NuGet packages (41)

Showing the top 5 NuGet packages that depend on QuestPDF:

Package Downloads
AgentHub.Service.Financial.Domain.Shared

Package Description

HTMLToQPDF

Relorer.QuestPDF.HTML is an extension for QuestPDF that allows to generate PDF from HTML

DH.QuestPDF

DH框架的Pdf处理库。基于https://github.com/QuestPDF/QuestPDF

Verify.QuestPDF

Extends Verify (https://github.com/VerifyTests/Verify) to allow verification via QuestPDF.

QuestPDF.Markdown

QuestPDF.Markdown is an open-source helper library that allows rendering markdown into a QuestPDF document

GitHub repositories (15)

Showing the top 5 popular GitHub repositories that depend on QuestPDF:

Repository Stars
nopSolutions/nopCommerce
ASP.NET Core eCommerce software. nopCommerce is a free and open-source shopping cart.
beto-rodriguez/LiveCharts2
Simple, flexible, interactive & powerful charts, maps and gauges for .Net, LiveCharts2 can now practically run everywhere Maui, Uno Platform, Blazor-wasm, WPF, WinForms, Xamarin, Avalonia, WinUI, UWP.
Pixeval/Pixeval
Wow. Yet another Pixiv client!
ariacom/Seal-Report
Database Reporting Tool and Tasks (.Net)
neozhu/CleanArchitectureWithBlazorServer
This is a repository for creating a Blazor Server dashboard application following the principles of Clean Architecture
Version Downloads Last updated
2024.10.2 23,284 10/24/2024
2024.10.1 27,664 10/14/2024
2024.10.0 25,752 10/4/2024
2024.10.0-rc4 1,647 9/26/2024
2024.10.0-rc3 4,842 9/17/2024
2024.10.0-rc2 287 9/16/2024
2024.10.0-rc1 285 9/13/2024
2024.10.0-rc0 2,685 9/4/2024
2024.7.3 133,117 8/27/2024
2024.7.2 102,052 8/1/2024
2024.7.1 52,331 7/22/2024
2024.7.0 30,860 7/15/2024
2024.7.0-rc0 1,584 7/4/2024
2024.6.4 66,349 6/25/2024
2024.6.3 328 6/25/2024
2024.6.2 24,741 6/20/2024
2024.6.1 20,504 6/15/2024
2024.6.0 44,233 6/11/2024
2024.3.10 73,892 5/25/2024
2024.3.9 8,506 5/23/2024
2024.3.8 227 5/23/2024
2024.3.7 20,151 5/20/2024
2024.3.6 32,082 5/14/2024
2024.3.5 23,025 5/12/2024
2024.3.4 25,372 5/6/2024
2024.3.3 9,203 5/2/2024
2024.3.2 30,042 4/25/2024
2024.3.1 30,031 4/22/2024
2024.3.0 56,886 4/12/2024
2024.3.0-rc2 4,026 3/30/2024
2024.3.0-rc1 238 3/29/2024
2024.3.0-rc 612 3/27/2024
2024.3.0-beta1 2,127 3/18/2024
2024.3.0-beta 3,442 2/29/2024
2024.3.0-alpha 1,668 2/15/2024
2023.12.6 274,041 2/21/2024
2023.12.5 70,039 2/7/2024
2023.12.4 137,347 1/15/2024
2023.12.3 19,697 1/12/2024
2023.12.2 59,429 1/1/2024
2023.12.1 65,863 12/15/2023
2023.12.0 50,734 12/3/2023
2023.10.2 82,803 11/13/2023
2023.10.1 43,381 10/31/2023
2023.10.0 31,785 10/23/2023
2023.10.0-alpha0 373 10/13/2023
2023.9.1 45,213 10/6/2023
2023.9.0 36,559 9/25/2023
2023.6.3 138,953 8/27/2023
2023.6.2 636 8/26/2023
2023.6.1 102,243 7/20/2023
2023.6.0 72,814 6/28/2023
2023.5.3 85,786 6/12/2023
2023.5.2 60,827 5/31/2023
2023.5.1 27,525 5/22/2023
2023.5.0 12,499 5/15/2023
2023.4.2 14,101 5/9/2023
2023.4.1 4,657 5/4/2023
2023.4.0 1,327 5/4/2023
2022.12.15 204,273 2/7/2024
2022.12.14 30,388 1/12/2024
2022.12.13 9,076 1/1/2024
2022.12.12 23,580 12/15/2023
2022.12.11 20,243 12/3/2023
2022.12.10 11,354 11/13/2023
2022.12.9 3,347 10/31/2023
2022.12.8 22,687 10/23/2023
2022.12.7 91,031 10/6/2023
2022.12.6 455,374 5/9/2023
2022.12.5 150,366 4/27/2023
2022.12.4 33,159 4/22/2023
2022.12.3 76,708 4/16/2023
2022.12.2 317,334 3/12/2023
2022.12.1 572,907 1/13/2023
2022.12.0 155,795 12/14/2022
2022.11.0 387,438 11/5/2022
2022.11.0-alpha1 357 11/1/2022
2022.11.0-alpha0 320 10/28/2022
2022.9.1 92,753 10/15/2022
2022.9.0 139,062 9/18/2022
2022.9.0-alpha1 301 9/16/2022
2022.8.2 165,942 8/21/2022
2022.8.1 21,020 8/19/2022
2022.8.0 97,801 8/15/2022
2022.6.3 55,092 7/18/2022
2022.6.2 128,628 6/22/2022
2022.6.1 23,129 6/12/2022
2022.6.0 159,999 6/12/2022
2022.6.0-prerelease 1,755 5/30/2022
2022.5.0 285,406 5/9/2022
2022.4.1 110,599 4/8/2022
2022.4.0 70,067 4/4/2022
2022.4.0-alpha1 337 3/27/2022
2022.4.0-alpha0 305 3/27/2022
2022.3.1 98,704 3/15/2022
2022.3.0 2,574 3/14/2022
2022.2.7 1,762 3/12/2022
2022.2.6 6,572 3/8/2022
2022.2.5 20,503 2/18/2022
2022.2.4 708 2/18/2022
2022.2.3 11,280 2/7/2022
2022.2.2 2,059 2/1/2022
2022.2.1 1,621 1/30/2022
2022.2.0 1,881 1/29/2022
2022.2.0-beta1 331 1/24/2022
2022.1.0 25,828 1/10/2022
2022.1.0-beta5 984 1/7/2022
2022.1.0-beta4 344 1/6/2022
2022.1.0-beta3 315 1/5/2022
2022.1.0-beta2 330 1/5/2022
2022.1.0-beta1 334 1/3/2022
2022.1.0-beta0 310 12/30/2021
2022.1.0-alpha0 360 12/30/2021 2022.1.0-alpha0 is deprecated because it is no longer maintained.
2021.12.0 32,332 12/6/2021
2021.12.0-alpha1 1,161 11/29/2021
2021.12.0-alpha0 388 11/18/2021
2021.11.4 22,628 11/14/2021
2021.11.3 4,917 11/7/2021
2021.11.0-beta3 401 11/3/2021
2021.11.0-beta2 432 10/28/2021
2021.11.0-beta 465 10/23/2021
2021.10.1 10,089 9/30/2021
2021.10.0 611 9/30/2021
2021.10.0-beta.2 278 9/14/2021
2021.10.0-beta 418 9/13/2021
2021.9.3 6,294 9/12/2021
2021.9.2 730 9/1/2021
2021.9.1 562 9/1/2021
2021.9.0 525 8/30/2021
2021.8.0 2,493 8/2/2021
2021.5.2 3,282 5/5/2021
2021.4.0 771 4/2/2021
2021.3.1 7,126 3/1/2021
2021.3.0 585 3/1/2021
2021.2.0 631 2/8/2021
2021.1.0 694 1/4/2021
2020.11.0 10,668 11/1/2020

Version 2024.6.0

New Features:
- Paragraph Formatting: Added support for paragraph spacing and first-line indentation.
- SVG Output: Introduced support for SVG output format.
- Exception Messaging: Improved exception messages for layout issues, providing detailed information and suspected locations.


Enhancements:
- Content Drawing: Enhanced default content drawing behavior, so content does not unexpectedly repeat in certain cases.
- Library Dependencies: Disabled visibility of native dependencies and the Lato font for cleaner output.
- Compatibility Messaging: Enhanced compatibility exception messages for supported but potentially outdated environments.
- Image Loading: Added fallback path for image loading to enhance development experience on ASP.NET.
- Color Conversion: Added implicit conversion from hex numbers to color.
- Inline Element: Simplified implementation and improved performance.
- Column Element: Simplified implementation and improved performance.


Bug Fixes:
- Column Element: Resolved instability issues in nested layouts with spacing and zero-sized elements.
- JPEG Quality: Disabled JPEG image downsampling/downscaling to maintain the highest quality levels.
- Image Compression: Disabled additional image compression performed by Skia.


Version 2024.6.1
- Layout debugging: significantly improved calculation performance and accuracy of issue detection.
- Text element: improved the default sizing behavior for the Text element. Now, when the text is empty, it works more consistently by taking up zero width while still reserving vertical space based on the font size.
- Fixed compatibility with .NET Standard 2.0.
- Fixed an issue causing invisibility of Table elements containing only Header/Footer elements without content.
- Improved the Document Composition Fluent API for Page, Table and Decoration elements. An exception is now thrown if any layer is configured more than once, preventing unexpected behavior.


Version 2024.6.2
- Reduced peak memory usage in documents with high number of text elements.
- Implemented a new caching mechanism to reduce the number of layout-related calculations.
- Introduced caching for DynamicSvgImage to enhance performance when the image is repeated across multiple pages.
- Introduced caching for DynamicImage to enhance performance when the image is repeated across multiple pages.
- Generating debugging information now respects the QuestPDF.Settings.EnableDebugging flag.
- Enhanced the accuracy and conciseness of layout-issue debugging messages.
- Fixed an issue where text width calculation was unnecessarily rounded, which caused text overflow.
- Resolved an issue where the Text element was not visible when it contained only the page number.


Version 2024.6.3
- Improved performance of Text elements containing null, empty, or whitespace content only.


Version 2024.6.4
- Fixed a bug where Text elements, containing only null, empty, or whitespace content, could cause document layout issues.