QuestPDF 2024.3.0-rc

This is a prerelease version of QuestPDF.
There is a newer version of this package available.
See the version list below for details.
dotnet add package QuestPDF --version 2024.3.0-rc
NuGet\Install-Package QuestPDF -Version 2024.3.0-rc
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.3.0-rc" />
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add QuestPDF --version 2024.3.0-rc
#r "nuget: QuestPDF, 2024.3.0-rc"
#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.3.0-rc&prerelease

// Install QuestPDF as a Cake Tool
#tool nuget:?package=QuestPDF&version=2024.3.0-rc&prerelease

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 (20)

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 The ID prefix of this package has been reserved for one of the owners of this package by NuGet.org.

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

A2v10.Pdf.Report

A2v10 Platform PDF report

GitHub repositories (8)

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.
neozhu/CleanArchitectureWithBlazorServer
This is a repository for creating a Blazor Server dashboard application following the principles of Clean Architecture
NickvisionApps/Denaro
Manage your personal finances
axzxs2001/Asp.NetCoreExperiment
原来所有项目都移动到**OleVersion**目录下进行保留。新的案例装以.net 5.0为主,一部分对以前案例进行升级,一部分将以前的工作经验总结出来,以供大家参考!
Version Downloads Last updated
2024.3.2 891 4/25/2024
2024.3.1 3,961 4/22/2024
2024.3.0 11,306 4/12/2024
2024.3.0-rc2 1,921 3/30/2024
2024.3.0-rc1 194 3/29/2024
2024.3.0-rc 541 3/27/2024
2024.3.0-beta1 979 3/18/2024
2024.3.0-beta 2,235 2/29/2024
2024.3.0-alpha 1,267 2/15/2024
2023.12.6 106,930 2/21/2024
2023.12.5 38,729 2/7/2024
2023.12.4 66,760 1/15/2024
2023.12.3 8,139 1/12/2024
2023.12.2 30,734 1/1/2024
2023.12.1 36,366 12/15/2023
2023.12.0 35,243 12/3/2023
2023.10.2 56,997 11/13/2023
2023.10.1 29,774 10/31/2023
2023.10.0 25,933 10/23/2023
2023.10.0-alpha0 333 10/13/2023
2023.9.1 31,918 10/6/2023
2023.9.0 27,116 9/25/2023
2023.6.3 86,080 8/27/2023
2023.6.2 480 8/26/2023
2023.6.1 73,852 7/20/2023
2023.6.0 45,085 6/28/2023
2023.5.3 56,785 6/12/2023
2023.5.2 47,146 5/31/2023
2023.5.1 21,799 5/22/2023
2023.5.0 11,677 5/15/2023
2023.4.2 11,817 5/9/2023
2023.4.1 3,628 5/4/2023
2023.4.0 596 5/4/2023
2022.12.15 24,246 2/7/2024
2022.12.14 11,905 1/12/2024
2022.12.13 5,131 1/1/2024
2022.12.12 11,591 12/15/2023
2022.12.11 8,672 12/3/2023
2022.12.10 6,508 11/13/2023
2022.12.9 2,176 10/31/2023
2022.12.8 4,506 10/23/2023
2022.12.7 58,734 10/6/2023
2022.12.6 348,652 5/9/2023
2022.12.5 127,810 4/27/2023
2022.12.4 23,824 4/22/2023
2022.12.3 67,346 4/16/2023
2022.12.2 241,738 3/12/2023
2022.12.1 474,920 1/13/2023
2022.12.0 133,605 12/14/2022
2022.11.0 332,462 11/5/2022
2022.11.0-alpha1 303 11/1/2022
2022.11.0-alpha0 277 10/28/2022
2022.9.1 78,475 10/15/2022
2022.9.0 121,625 9/18/2022
2022.9.0-alpha1 265 9/16/2022
2022.8.2 147,828 8/21/2022
2022.8.1 20,596 8/19/2022
2022.8.0 77,922 8/15/2022
2022.6.3 48,287 7/18/2022
2022.6.2 118,173 6/22/2022
2022.6.1 21,651 6/12/2022
2022.6.0 138,394 6/12/2022
2022.6.0-prerelease 1,716 5/30/2022
2022.5.0 258,452 5/9/2022
2022.4.1 88,167 4/8/2022
2022.4.0 60,282 4/4/2022
2022.4.0-alpha1 306 3/27/2022
2022.4.0-alpha0 271 3/27/2022
2022.3.1 94,896 3/15/2022
2022.3.0 2,355 3/14/2022
2022.2.7 1,717 3/12/2022
2022.2.6 6,389 3/8/2022
2022.2.5 19,153 2/18/2022
2022.2.4 662 2/18/2022
2022.2.3 10,325 2/7/2022
2022.2.2 1,990 2/1/2022
2022.2.1 1,552 1/30/2022
2022.2.0 1,751 1/29/2022
2022.2.0-beta1 296 1/24/2022
2022.1.0 21,528 1/10/2022
2022.1.0-beta5 941 1/7/2022
2022.1.0-beta4 303 1/6/2022
2022.1.0-beta3 275 1/5/2022
2022.1.0-beta2 292 1/5/2022
2022.1.0-beta1 300 1/3/2022
2022.1.0-beta0 280 12/30/2021
2022.1.0-alpha0 326 12/30/2021
2021.12.0 30,022 12/6/2021
2021.12.0-alpha1 1,127 11/29/2021
2021.12.0-alpha0 352 11/18/2021
2021.11.4 21,566 11/14/2021
2021.11.3 4,716 11/7/2021
2021.11.0-beta3 359 11/3/2021
2021.11.0-beta2 375 10/28/2021
2021.11.0-beta 427 10/23/2021
2021.10.1 9,784 9/30/2021
2021.10.0 572 9/30/2021
2021.10.0-beta.2 248 9/14/2021
2021.10.0-beta 375 9/13/2021
2021.9.3 5,059 9/12/2021
2021.9.2 670 9/1/2021
2021.9.1 515 9/1/2021
2021.9.0 485 8/30/2021
2021.8.0 2,443 8/2/2021
2021.5.2 2,712 5/5/2021
2021.4.0 724 4/2/2021
2021.3.1 7,072 3/1/2021
2021.3.0 538 3/1/2021
2021.2.0 591 2/8/2021
2021.1.0 648 1/4/2021
2020.11.0 9,364 11/1/2020

Version 2024.3.0-alpha
The primary theme of this release is the removal of the SkiaSharp dependency and the introduction of custom native layer built on top of Skia M121.
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, reducing the file size. The size difference can be enormous when complex fonts are used of various styles,
- Improved text-related capabilities, including text justification, bi-directionality, enhanced line breaking algorithms, and more,
- Introduced additional document compression to reduce file size,
- Integrated native SVG support,
- Improved performance by 25% on average,
- In the future release: enhanced accessibility by support for PDF tags.

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.

This release requires at least .NET Standard 2.1. The beta release will reintroduce support for the .NET Standard 2.0.



Version 2024.3.0-beta
- Updated the codebase to Skia m122 and resolved all backward-incompatible changes,
- Added support for the .NET Standard 2.0,
- Improved P/Invoke and marshaling compatibility with the legacy .NET Framework,
- Fixed a bug in the Text element that could cause an exception under certain conditions,
- Updated the Lato font to the latest version (2.015),
- Improved the loading method for native dependencies,
- Added the Text.ClampLines functionality,
- Added support for adjusting the thickness and style of text decorations (overline, strikeout, underline),
- Added support for word spacing,
- Reduced the risk of race conditions in Avalonia in the QuestPDF Previewer,
- Enhanced exception message when the QuestPDF Previewer fails to load due to missing required dotnet 8 runtime,
- Improved native memory management and fixed memory leaks,
- Include licenses of the third party dependencies in the NuGet package,
- Performed code cleanup and made minor adjustments.



Version 2024.3.0-beta1
- Greatly reduced the size of the native binaries by switching from ICU to libgrapheme,
- Improved the logic for finding and loading native dependencies,
- Fixed an issue where the font fallback does not work when the Settings.UseEnvironmentFonts setting is set to false,
- Added the ability to provide multiple font families or fallbacks,
- Fixed an issue where the text element does not render its content in certain scenarios when it contains page numbers,
- Fixed an issue where SkSvgCanvas may produce incomplete results, resulting in invalid SVG content,
- Improved memory management for SkParagraph in certain scenarios.



Version 2024.3.0-rc
- Updated Skia to version m124,
- Linux support: Removed dependency on the FontConfig library,
- Linux support: added support for older Linux distributions, equivalent to Ubuntu 18,
- Linux support: Introduced support for arm64 architecture,
- Resolved an issue causing an "Invalid UTF8" error message showing in the console,
- Addressed a problem with the text underline effect not functioning as expected due to Skia's DecorationMode.Gaps not handling all fonts correctly,
- Optimized the algorithm for loading fonts provided in the application folder, including default fonts, for better performance.
- Included a list of contributors in the nuget package, to acknowledge the valuable input from our community in improving QuestPDF,
- Implemented safeguards in the native code wrapper to throw an exception when a native object pointer is null,
- Optimized runtime (Avalonia) and development dependencies,
- Refined the native artifacts build system through code refactoring and the integration of execution tests, improving build reliability and efficiency,
- Planned: in the next major release, the WASM support will be investigated and potentially reintroduced,
- Known Issue: During stress testing, an issue was identified that native memory usage is higher than expected when generating long documents rich in short text elements. This issue is currently under investigation and will be addressed in the next major release.