Markdown2Pdf 0.5.1

There is a newer version of this package available.
See the version list below for details.
dotnet add package Markdown2Pdf --version 0.5.1                
NuGet\Install-Package Markdown2Pdf -Version 0.5.1                
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="Markdown2Pdf" Version="0.5.1" />                
For projects that support PackageReference, copy this XML node into the project file to reference the package.
paket add Markdown2Pdf --version 0.5.1                
#r "nuget: Markdown2Pdf, 0.5.1"                
#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 Markdown2Pdf as a Cake Addin
#addin nuget:?package=Markdown2Pdf&version=0.5.1

// Install Markdown2Pdf as a Cake Tool
#tool nuget:?package=Markdown2Pdf&version=0.5.1                

<p align="center"> <a href="https://www.nuget.org/packages/Markdown2Pdf" target="_blank"> <img alt="Nuget" src="https://img.shields.io/nuget/v/Markdown2Pdf"> </a>

<a href="https://github.com/Flayms/Markdown2Pdf/actions/workflows/build-and-release.yml" target="_blank"> <img src="https://github.com/Flayms/Markdown2Pdf/actions/workflows/build-and-release.yml/badge.svg?event=workflow_dispatch" alt="Build and Release" /> </a> </p>

<h1 align="center"> Markdown2Pdf</h1>

<p align="center"> <img src="./assets/md2pdf.svg" alt="Logo" Width=128px/> <br> </p>

.NET library for converting Markdown to PDF. Uses Markdig for converting markdown to html and then Puppeteer Sharp to convert that output to PDF. For a cross-platform console-application checkout Markdown2Pdf.Console.

A demo can be found here!

Usage

var converter = new Markdown2PdfConverter();
converter.Convert("README.md");

Options

To further specify the conversion process you can pass Markdown2PdfOptions to the converter:

var options = var options = new Markdown2PdfOptions {
  HeaderUrl = "header.html",
  FooterUrl = "footer.html",
  DocumentTitle = "Example PDF",
};
var converter = new Markdown2PdfConverter(options);
Option Description
HeaderUrl Path to an html-file to use as the document-header. Allows the classes date, title, document-title, url, pageNumber and totalPages for injection.
FooterUrl Path to an html-file to use as the document-footer. Allows the classes date, title, document-title, url, pageNumber and totalPages for injection.
DocumentTitle The title of this document. Can be injected into the header / footer by adding the class document-title to the element.
ChromePath Path to chrome or chromium executable or self-downloads it if null.
KeepHtml true if the created html should not be deleted.
MarginOptions Css-margins for the sides of the document.
ModuleOptions Options that decide from where to load additional modules. Default: ModuleOptions.Remote.
Theme The styling to apply to the document. Default: Theme.Github.

Modules

This library uses node_modules packages. By default they're loaded over a CDN like https://cdn.jsdelivr.net.

You can also use a local installation of them by running the script Init.ps1 and setting Markdown2PdfOptions.ModuleOptions to ModuleOptions.Global.

Note: For this you need to have npm installed and added to PATH.

Alternatively you can also install the packages from the script manually and configure a custom installation path with ModuleOptions.FromLocalPath().

Used Modules

Product Compatible and additional computed target framework versions.
.NET net5.0 was computed.  net5.0-windows was computed.  net6.0 was computed.  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 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 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.

NuGet packages

This package is not used by any NuGet packages.

GitHub repositories

This package is not used by any popular GitHub repositories.

Version Downloads Last updated
2.2.1 5,805 5/25/2024
2.2.0 165 5/15/2024
2.1.0 568 4/23/2024
2.0.0 362 4/7/2024
1.3.0 938 2/8/2024
1.2.0 119 1/30/2024
1.1.0 106 1/26/2024
1.0.1 118 1/20/2024
1.0.0 2,628 9/3/2023
0.5.2 191 7/23/2023
0.5.1 161 7/18/2023
0.4.0 155 7/17/2023
0.3.4 146 7/16/2023
0.3.3 146 7/16/2023
0.3.2 151 7/13/2023
0.3.1 152 7/10/2023