QuestPDF 2022.3.0

.NET 6.0 .NET Core 2.0 .NET Standard 2.0 .NET Framework 4.6.2
There is a newer version of this package available.
See the version list below for details. 
dotnet add package QuestPDF --version 2022.3.0
NuGet\Install-Package QuestPDF -Version 2022.3.0
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="2022.3.0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
paket add QuestPDF --version 2022.3.0
#r "nuget: QuestPDF, 2022.3.0"
#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=2022.3.0

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

Dotnet GitHub Repo stars Nuget version Nuget download License Sponsor project

QuestPDF is an open-source .NET library for PDF documents generation.

It offers a layouting engine designed with a full paging support in mind. The document consists of many simple elements (e.g. border, background, image, text, padding, table, grid etc.) that are composed together to create more complex structures. This way, as a developer, you can understand the behavior of every element and use them with full confidence. Additionally, the document and all its elements support paging functionality. For example, an element can be moved to the next page (if there is not enough space) or even be split between pages like table's rows.

Unlike other libraries, it does not rely on the HTML-to-PDF conversion which in many cases is not reliable. Instead, it implements its own layouting engine that is optimized to cover all paging-related requirements.

Installation

The library is available as a nuget package. You can install it as any other nuget package from your IDE, try to search by QuestPDF. You can find package details on this webpage.

// Package Manager
Install-Package QuestPDF

// .NET CLI
dotnet add package QuestPDF

// Package reference in .csproj file
<PackageReference Include="QuestPDF" Version="2022.3.0" />

Documentation

Getting started tutorial A short and easy to follow tutorial showing how to design an invoice document under 200 lines of code.

API reference A detailed description of behavior of all available components and how to use them with C# Fluent API.

Patterns and Practices Everything that may help you designing great reports and create reusable code that is easy to maintain.

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:

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");

And compare it to the produced PDF file:

invoice

Are you ready for more?

The Fluent API of QuestPDF scales really well. It is easy to create and maintain even most complex documents. Read the Getting started tutorial to learn QuestPDF basics and implement an invoice under 200 lines of code. You can also investigate and play with the code from the example repository.

invoice

Product Versions
.NET net5.0 net5.0-windows net6.0 net6.0-android net6.0-ios net6.0-maccatalyst net6.0-macos net6.0-tvos net6.0-windows net7.0 net7.0-android net7.0-ios net7.0-maccatalyst net7.0-macos net7.0-tvos net7.0-windows
.NET Core netcoreapp2.0 netcoreapp2.1 netcoreapp2.2 netcoreapp3.0 netcoreapp3.1
.NET Standard netstandard2.0 netstandard2.1
.NET Framework net461 net462 net463 net47 net471 net472 net48 net481
MonoAndroid monoandroid
MonoMac monomac
MonoTouch monotouch
Tizen tizen40 tizen60
Xamarin.iOS xamarinios
Xamarin.Mac xamarinmac
Xamarin.TVOS xamarintvos
Xamarin.WatchOS xamarinwatchos
Compatible target framework(s)
Additional computed target framework(s)
Learn more about Target Frameworks and .NET Standard.

NuGet packages (11)

Showing the top 5 NuGet packages that depend on QuestPDF:

Package Downloads
AgentHub.Service.Financial.Domain.Shared

Package Description
A2v10.Pdf.Report

A2v10 Platform PDF report
DH.QuestPDF

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

Relorer.QuestPDF.HTML is an extension for QuestPDF that allows to generate PDF from HTML
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.

GitHub repositories (7)

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.
axzxs2001/Asp.NetCoreExperiment
原来所有项目都移动到**OleVersion**目录下进行保留。新的案例装以.net 5.0为主，一部分对以前案例进行升级，一部分将以前的工作经验总结出来，以供大家参考！
neozhu/CleanArchitectureWithBlazorServer
This is a repository for creating a Blazor Server dashboard application following the principles of Clean Architecture
nlogozzo/NickvisionMoney
A personal finance manager
Version Downloads Last updated
2022.12.2 13,308 3/12/2023
2022.12.1 108,698 1/13/2023
2022.12.0 59,084 12/14/2022
2022.11.0 133,098 11/5/2022
2022.11.0-alpha1 82 11/1/2022
2022.11.0-alpha0 65 10/28/2022
2022.9.1 39,027 10/15/2022
2022.9.0 57,968 9/18/2022
2022.9.0-alpha1 83 9/16/2022
2022.8.2 79,770 8/21/2022
2022.8.1 7,108 8/19/2022
2022.8.0 21,981 8/15/2022
2022.6.3 35,541 7/18/2022
2022.6.2 75,715 6/22/2022
2022.6.1 15,964 6/12/2022
2022.6.0 64,245 6/12/2022
2022.6.0-prerelease 1,445 5/30/2022
2022.5.0 165,777 5/9/2022
2022.4.1 40,158 4/8/2022
2022.4.0 30,427 4/4/2022
2022.4.0-alpha1 117 3/27/2022
2022.4.0-alpha0 84 3/27/2022
2022.3.1 86,304 3/15/2022
2022.3.0 1,603 3/14/2022
2022.2.7 1,290 3/12/2022
2022.2.6 5,843 3/8/2022
2022.2.5 13,614 2/18/2022
2022.2.4 325 2/18/2022
2022.2.3 9,015 2/7/2022
2022.2.2 1,170 2/1/2022
2022.2.1 1,026 1/30/2022
2022.2.0 968 1/29/2022
2022.2.0-beta1 112 1/24/2022
2022.1.0 15,346 1/10/2022
2022.1.0-beta5 686 1/7/2022
2022.1.0-beta4 113 1/6/2022
2022.1.0-beta3 110 1/5/2022
2022.1.0-beta2 104 1/5/2022
2022.1.0-beta1 108 1/3/2022
2022.1.0-beta0 108 12/30/2021
2022.1.0-alpha0 133 12/30/2021
2021.12.0 19,654 12/6/2021
2021.12.0-alpha1 930 11/29/2021
2021.12.0-alpha0 168 11/18/2021
2021.11.4 18,166 11/14/2021
2021.11.3 3,589 11/7/2021
2021.11.0-beta3 162 11/3/2021
2021.11.0-beta2 211 10/28/2021
2021.11.0-beta 262 10/23/2021
2021.10.1 7,381 9/30/2021
2021.10.0 311 9/30/2021
2021.10.0-beta.2 169 9/14/2021
2021.10.0-beta 203 9/13/2021
2021.9.3 2,777 9/12/2021
2021.9.2 367 9/1/2021
2021.9.1 240 9/1/2021
2021.9.0 235 8/30/2021
2021.8.0 2,084 8/2/2021
2021.5.2 1,772 5/5/2021
2021.4.0 444 4/2/2021
2021.3.1 6,609 3/1/2021
2021.3.0 258 3/1/2021
2021.2.0 274 2/8/2021
2021.1.0 318 1/4/2021
2020.11.0 4,698 11/1/2020

- Added minimal API to help you quickly start with QuestPDF development and speed up prototyping,
- Improved exception message when desired font type cannot be found (instead of loading default font on Windows and failing with wrong characters on Linux),
- Improved support for custom font types: loading all type faces from a file, respecting true font family, using CSS-like algorithm to find best style match,
- Added support for custom page number formats in the `Text` element, e.g. you can implement roman literal style if required,
- Improved text API to make it more concise,
- Extended support for the `Section` element (previously the `Location` element) by tracking: beginning page number, end page number, page length, page number within location,
- Renaming: the `ExternalLink` element was renamed to the `Hyperlink` element,
- Renaming: the `Location` element was renamed to the `Section` element,
- Renaming: the `InternalLink` element was renamed to the `SectionLink` element,
- Updated homepage and GitHub pages content.