QuestPDF 2022.4.0-alpha0

.NET 6.0 This package targets .NET 6.0. The package is compatible with this framework or higher. .NET Core 2.0 This package targets .NET Core 2.0. The package is compatible with this framework or higher. .NET Standard 2.0 This package targets .NET Standard 2.0. The package is compatible with this framework or higher. .NET Framework 4.6.2 This package targets .NET Framework 4.6.2. The package is compatible with this framework or higher.
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 2022.4.0-alpha0                

                    
                

            
NuGet\Install-Package QuestPDF -Version 2022.4.0-alpha0
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.4.0-alpha0" />
For projects that support PackageReference, copy this XML node into the project file to reference the package. 
paket add QuestPDF --version 2022.4.0-alpha0                

                    
                

            
#r "nuget: QuestPDF, 2022.4.0-alpha0"
#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.4.0-alpha0&prerelease

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

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 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 was computed.  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 is compatible.  netcoreapp2.1 was computed.  netcoreapp2.2 was computed.  netcoreapp3.0 is compatible.  netcoreapp3.1 was computed. 
.NET Standard netstandard2.0 is compatible.  netstandard2.1 was computed. 
.NET Framework net461 was computed.  net462 is compatible.  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.

NuGet packages (43)

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
2025.1.0-alpha0 1,802 12/4/2024
2024.12.1 20,735 12/9/2024
2024.12.0 11,693 12/4/2024
2024.12.0-rc3 1,062 11/29/2024
2024.12.0-rc2 1,066 11/22/2024
2024.12.0-rc1 160 11/22/2024
2024.12.0-rc0 1,756 11/18/2024
2024.10.4 35,595 11/22/2024
2024.10.3 51,581 11/8/2024
2024.10.2 73,622 10/24/2024
2024.10.1 56,163 10/14/2024
2024.10.0 38,757 10/4/2024
2024.10.0-rc4 2,867 9/26/2024
2024.10.0-rc3 7,678 9/17/2024
2024.10.0-rc2 338 9/16/2024
2024.10.0-rc1 300 9/13/2024
2024.10.0-rc0 3,819 9/4/2024
2024.7.3 173,695 8/27/2024
2024.7.2 130,857 8/1/2024
2024.7.1 66,919 7/22/2024
2024.7.0 37,863 7/15/2024
2024.7.0-rc0 2,026 7/4/2024
2024.6.4 78,361 6/25/2024
2024.6.3 349 6/25/2024
2024.6.2 30,579 6/20/2024
2024.6.1 23,291 6/15/2024
2024.6.0 55,141 6/11/2024
2024.3.10 83,674 5/25/2024
2024.3.9 11,607 5/23/2024
2024.3.8 252 5/23/2024
2024.3.7 23,369 5/20/2024
2024.3.6 37,281 5/14/2024
2024.3.5 26,116 5/12/2024
2024.3.4 28,495 5/6/2024
2024.3.3 10,235 5/2/2024
2024.3.2 39,574 4/25/2024
2024.3.1 35,051 4/22/2024
2024.3.0 67,219 4/12/2024
2024.3.0-rc2 4,312 3/30/2024
2024.3.0-rc1 248 3/29/2024
2024.3.0-rc 631 3/27/2024
2024.3.0-beta1 2,450 3/18/2024
2024.3.0-beta 3,819 2/29/2024
2024.3.0-alpha 1,700 2/15/2024
2023.12.6 300,754 2/21/2024
2023.12.5 76,286 2/7/2024
2023.12.4 155,032 1/15/2024
2023.12.3 21,353 1/12/2024
2023.12.2 66,790 1/1/2024
2023.12.1 72,315 12/15/2023
2023.12.0 54,193 12/3/2023
2023.10.2 87,197 11/13/2023
2023.10.1 46,851 10/31/2023
2023.10.0 33,208 10/23/2023
2023.10.0-alpha0 382 10/13/2023
2023.9.1 48,909 10/6/2023
2023.9.0 38,229 9/25/2023
2023.6.3 151,182 8/27/2023
2023.6.2 644 8/26/2023
2023.6.1 109,036 7/20/2023
2023.6.0 78,871 6/28/2023
2023.5.3 92,963 6/12/2023
2023.5.2 64,185 5/31/2023
2023.5.1 29,274 5/22/2023
2023.5.0 12,695 5/15/2023
2023.4.2 14,457 5/9/2023
2023.4.1 4,995 5/4/2023
2023.4.0 1,657 5/4/2023
2022.12.15 265,775 2/7/2024
2022.12.14 35,257 1/12/2024
2022.12.13 9,857 1/1/2024
2022.12.12 24,816 12/15/2023
2022.12.11 23,619 12/3/2023
2022.12.10 12,269 11/13/2023
2022.12.9 3,446 10/31/2023
2022.12.8 26,611 10/23/2023
2022.12.7 98,946 10/6/2023
2022.12.6 480,099 5/9/2023
2022.12.5 156,612 4/27/2023
2022.12.4 35,312 4/22/2023
2022.12.3 77,676 4/16/2023
2022.12.2 335,610 3/12/2023
2022.12.1 598,761 1/13/2023
2022.12.0 161,631 12/14/2022
2022.11.0 399,604 11/5/2022
2022.11.0-alpha1 364 11/1/2022
2022.11.0-alpha0 324 10/28/2022
2022.9.1 97,022 10/15/2022
2022.9.0 144,715 9/18/2022
2022.9.0-alpha1 307 9/16/2022
2022.8.2 168,680 8/21/2022
2022.8.1 21,034 8/19/2022
2022.8.0 102,062 8/15/2022
2022.6.3 56,577 7/18/2022
2022.6.2 131,689 6/22/2022
2022.6.1 23,554 6/12/2022
2022.6.0 169,589 6/12/2022
2022.6.0-prerelease 1,774 5/30/2022
2022.5.0 290,936 5/9/2022
2022.4.1 117,657 4/8/2022
2022.4.0 72,231 4/4/2022
2022.4.0-alpha1 341 3/27/2022
2022.4.0-alpha0 309 3/27/2022
2022.3.1 100,243 3/15/2022
2022.3.0 2,650 3/14/2022
2022.2.7 1,773 3/12/2022
2022.2.6 6,597 3/8/2022
2022.2.5 20,859 2/18/2022
2022.2.4 716 2/18/2022
2022.2.3 11,502 2/7/2022
2022.2.2 2,070 2/1/2022
2022.2.1 1,630 1/30/2022
2022.2.0 1,912 1/29/2022
2022.2.0-beta1 337 1/24/2022
2022.1.0 26,951 1/10/2022
2022.1.0-beta5 990 1/7/2022
2022.1.0-beta4 348 1/6/2022
2022.1.0-beta3 319 1/5/2022
2022.1.0-beta2 336 1/5/2022
2022.1.0-beta1 338 1/3/2022
2022.1.0-beta0 316 12/30/2021
2022.1.0-alpha0 364 12/30/2021 2022.1.0-alpha0 is deprecated because it is no longer maintained.
2021.12.0 33,304 12/6/2021
2021.12.0-alpha1 1,166 11/29/2021
2021.12.0-alpha0 393 11/18/2021
2021.11.4 23,054 11/14/2021
2021.11.3 4,938 11/7/2021
2021.11.0-beta3 405 11/3/2021
2021.11.0-beta2 436 10/28/2021
2021.11.0-beta 469 10/23/2021
2021.10.1 10,126 9/30/2021
2021.10.0 620 9/30/2021
2021.10.0-beta.2 280 9/14/2021
2021.10.0-beta 422 9/13/2021
2021.9.3 6,650 9/12/2021
2021.9.2 739 9/1/2021
2021.9.1 570 9/1/2021
2021.9.0 536 8/30/2021
2021.8.0 2,503 8/2/2021
2021.5.2 3,374 5/5/2021
2021.4.0 781 4/2/2021
2021.3.1 7,137 3/1/2021
2021.3.0 596 3/1/2021
2021.2.0 641 2/8/2021
2021.1.0 707 1/4/2021
2020.11.0 11,190 11/1/2020

- Introduced the Previewer tool - a hot-reload powered, cross-platform program that visualizes your PDF document and updates the preview every time you make a code change (available only for dotnet 6),
- Improved default word-wrapping algorithm to better handle words which do not fit on the available width,
- Introduced new word-wrapping option 'WrapAnywhere' that wraps word at the last possible character instead of moving it into new line.