QuestPDF 2024.3.10

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

No packages depend on QuestPDF.

Version 2024.3.0 The primary theme of this release is the removal of the SkiaSharp dependency and the introduction of a custom native layer built on top of Skia M124. This change was necessary to provide much higher flexibility and enable several new long-awaited features: - Font subsetting - this feature includes only necessary font glyphs in the output document, greatly reducing the file size, especially when using glyph-rich fonts supporting multiple languages, - Improved text-related capabilities, including but not limited to text justification, bi-directionality, enhanced line breaking algorithms, more styles for text decoration, word spacing, and more, - Introduced additional document compression to further reduce file size, - Integrated native SVG support, - In future releases: enhanced accessibility through support for PDF tags. Other changes: - Removed the SkiaSharp dependency, thereby making QuestPDF a standalone library, - Updated the Lato font to the latest version (2.015), - Included licenses of the third-party dependencies in the NuGet package, - Included a list of Contributors in the NuGet package to acknowledge the valuable input from our Community in improving QuestPDF. Unfortunately, this release also introduces breaking changes: - Removed support for injecting SkiaSharp content directly into the document. It is still possible to integrate SkiaSharp through vector and raster graphics; please consult the documentation for more details, - Removed support for platforms: Android, iOS, UWP, WASM, and Linux-Alpine. We are currently investigating reintroducing support for WASM and Linux-Alpine in future releases. We would like to thank the SkiaSharp project, its maintainers, and contributors, for creating a fantastic graphics library. It was a fantastic foundation for QuestPDF for over 3 years. Version 2024.3.1 - Enhanced discoverability of text alignment options (AlignLeft, AlignCenter, AlignRight, AlignStart, AlignEnd and Justify) when using the shorthand Text method (common use case). - To enhance compatibility with existing codebases, we've removed the breaking change associated with the deprecation of the TextStyle.Fallback method. Although this method remains obsolete, we've reintroduced it with a compatibility layer to prevent disruptions. - Enhanced compatibility with dotnet standard projects. - Fix: on the Windows platform, the "Could not find an appropriate font fallback for the following glyphs: $U-000D" exception is thrown when the "QuestPDF.Settings.CheckIfAllTextGlyphsAreAvailable" is set true, and the "TextDescriptor.Line" method is used (that inserts the '\r' character). - Fix: resolved an issue where the positioning of hyperlinks was incorrect when text contained injected block items. Version 2024.3.2 - Introduced support for the linux-musl-x64 platform. - Adjusted how the Lato font is embedded in the NuGet package to prevent issues with the files not being provided on the platform-specific runtimes. - Improved compatibility with texts that contain the carriage return character '\r'. - Enhanced exception messages when the FontManager.RegisterFont method fails due to an invalid font file. - Enhanced the Canvas element deprecation message by adding a link to the documentation. - Fixed: the SVG image is not always scaled properly, especially when uses relative units internally (percentage, cm, "mm", etc.). - Fixed a sporadic `AccessViolationException` that occurred when UseEnvironmentFonts was set to `false` and documents were generated in parallel. - Fixed an issue where dynamic SVG images were not utilizing the available space correctly. This resulted in images with a zero size. Version 2024.3.3 - Improved the default scaling behavior of Image and SvgImage elements when they are direct descendants of the Constrained element (Width, Height, MinWidth, MinHeight, MaxWidth, MaxHeight). - Enhanced handling of texts containing the carriage return character '\r' within the custom page format setting. - Fixed: enhanced the handling of the TextStyle.LineHeight modifier for better consistency with industry-standard software, as well as adjusted the default value. - Fixed: when the UseEnvironmentFonts setting is enabled, the Lato font was not being properly registered. This issue could lead to runtime exceptions in specific minimal environments. - Fixed: Addressed a potential null reference exception in the SvgImage object’s finalizer that could lead to application crashes when handling invalid SVG content. Version 2024.3.4 - Improved font rendering by setting half-leading when line-height is overridden. - Enhanced exception messages for unsupported x86 platforms. Version 2024.3.5 - Enhancement: text uses half-leading by default. - Fixed: default text decoration color should match font color. - Fixed: the Column element may not render successfully when it has non-zero spacing, contains a child with zero height, and is repeated. Version 2024.3.6 - Introduced support for the win-x86 platform. - Improved SVG image support for less common unit types. - Enhanced automated testing environment. Version 2024.3.7 - Introduced an explicit CallingConvention.Cdecl to address and fix the issue of stack imbalance on Windows platforms. Version 2024.3.9 - Fixed: the thickness of text decorations was significantly higher than defined by the font settings. Version 2024.3.10 - Updated Skia to M126 release, - Enhancement: SVG content supports embedded PNG/JPEG images, - Enhancement: SVG content supports loading external images from application local directory.

.NET 6.0

  • No dependencies.

.NET 8.0

  • No dependencies.

.NET Standard 2.0

  • No dependencies.

Version Downloads Last updated
2024.10.0-rc3 0 17.09.2024
2024.10.0-rc2 0 16.09.2024
2024.10.0-rc1 0 13.09.2024
2024.10.0-rc0 0 04.09.2024
2024.7.3 0 27.08.2024
2024.7.2 0 01.08.2024
2024.7.1 0 22.07.2024
2024.7.0 0 15.07.2024
2024.7.0-rc0 0 04.07.2024
2024.6.4 0 25.06.2024
2024.6.3 0 25.06.2024
2024.6.2 0 20.06.2024
2024.6.1 0 15.06.2024
2024.6.0 0 11.06.2024
2024.3.10 1 10.06.2024
2024.3.9 0 23.05.2024
2024.3.8 0 23.05.2024
2024.3.7 0 20.05.2024
2024.3.6 0 14.05.2024
2024.3.5 0 12.05.2024
2024.3.4 0 06.05.2024
2024.3.3 0 02.05.2024
2024.3.2 0 25.04.2024
2024.3.1 0 22.04.2024
2024.3.0 0 12.04.2024
2024.3.0-rc2 0 30.03.2024
2024.3.0-rc1 0 29.03.2024
2024.3.0-rc 0 27.03.2024
2024.3.0-beta1 0 18.03.2024
2024.3.0-beta 0 29.02.2024
2024.3.0-alpha 0 15.02.2024
2023.12.6 0 21.02.2024
2023.12.5 0 07.02.2024
2023.12.4 0 15.01.2024
2023.12.3 0 12.01.2024
2023.12.2 0 01.01.2024
2023.12.1 0 15.12.2023
2023.12.0 0 03.12.2023
2023.10.2 0 13.11.2023
2023.10.1 0 31.10.2023
2023.10.0 0 23.10.2023
2023.10.0-alpha0 0 13.10.2023
2023.9.1 0 06.10.2023
2023.9.0 0 25.09.2023
2023.6.3 0 27.08.2023
2023.6.2 0 26.08.2023
2023.6.1 0 20.07.2023
2023.6.0 0 28.06.2023
2023.5.3 0 12.06.2023
2023.5.2 0 31.05.2023
2023.5.1 0 22.05.2023
2023.5.0 0 15.05.2023
2023.4.2 0 09.05.2023
2023.4.1 0 04.05.2023
2023.4.0 0 04.05.2023
2022.12.15 0 07.02.2024
2022.12.14 0 12.01.2024
2022.12.13 0 01.01.2024
2022.12.12 0 15.12.2023
2022.12.11 0 03.12.2023
2022.12.10 0 13.11.2023
2022.12.9 0 31.10.2023
2022.12.8 0 23.10.2023
2022.12.7 0 06.10.2023
2022.12.6 0 09.05.2023
2022.12.5 0 27.04.2023
2022.12.4 0 22.04.2023
2022.12.3 0 16.04.2023
2022.12.2 0 12.03.2023
2022.12.1 0 13.01.2023
2022.12.0 0 14.12.2022
2022.11.0 0 05.11.2022
2022.11.0-alpha1 0 01.11.2022
2022.11.0-alpha0 0 28.10.2022
2022.9.1 0 15.10.2022
2022.9.0 0 18.09.2022
2022.9.0-alpha1 0 16.09.2022
2022.8.2 0 21.08.2022
2022.8.1 0 19.08.2022
2022.8.0 0 15.08.2022
2022.6.3 0 18.07.2022
2022.6.2 0 22.06.2022
2022.6.1 0 12.06.2022
2022.6.0 0 12.06.2022
2022.6.0-prerelease 0 30.05.2022
2022.5.0 0 09.05.2022
2022.4.1 0 08.04.2022
2022.4.0 0 04.04.2022
2022.4.0-alpha1 0 27.03.2022
2022.4.0-alpha0 0 27.03.2022
2022.3.1 0 15.03.2022
2022.3.0 0 14.03.2022
2022.2.7 0 12.03.2022
2022.2.6 0 08.03.2022
2022.2.5 0 18.02.2022
2022.2.4 0 18.02.2022
2022.2.3 0 07.02.2022
2022.2.2 0 01.02.2022
2022.2.1 0 30.01.2022
2022.2.0 0 29.01.2022
2022.2.0-beta1 0 24.01.2022
2022.1.0 0 10.01.2022
2022.1.0-beta5 0 07.01.2022
2022.1.0-beta4 0 06.01.2022
2022.1.0-beta3 0 05.01.2022
2022.1.0-beta2 0 05.01.2022
2022.1.0-beta1 0 03.01.2022
2022.1.0-beta0 0 30.12.2021
2022.1.0-alpha0 0 30.12.2021
2021.12.0 0 06.12.2021
2021.12.0-alpha1 0 29.11.2021
2021.12.0-alpha0 0 18.11.2021
2021.11.4 0 14.11.2021
2021.11.3 0 07.11.2021
2021.11.0-beta3 0 03.11.2021
2021.11.0-beta2 0 28.10.2021
2021.11.0-beta 0 23.10.2021
2021.10.1 0 30.09.2021
2021.10.0 0 30.09.2021
2021.10.0-beta.2 0 14.09.2021
2021.10.0-beta 0 13.09.2021
2021.9.3 0 12.09.2021
2021.9.2 0 01.09.2021
2021.9.1 0 01.09.2021
2021.9.0 0 30.08.2021
2021.8.0 0 02.08.2021
2021.5.2 0 05.05.2021
2021.4.0 0 02.04.2021
2021.3.1 0 01.03.2021
2021.3.0 0 01.03.2021
2021.2.0 0 08.02.2021
2021.1.0 0 04.01.2021
2020.11.0 0 01.11.2020