Markdown2Pdf 0.5.1
See the version list below for details.
dotnet add package Markdown2Pdf --version 0.5.1
NuGet\Install-Package Markdown2Pdf -Version 0.5.1
<PackageReference Include="Markdown2Pdf" Version="0.5.1" />
paket add Markdown2Pdf --version 0.5.1
#r "nuget: Markdown2Pdf, 0.5.1"
// 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
- MathJax: Latex-Math rendering
- Mermaid: Diagrams
- github-markdown-css: Github-Theme
- latex-css: Latex-Theme
Product | Versions 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. |
-
.NETStandard 2.0
- Markdig (>= 0.31.0)
- PuppeteerSharp (>= 10.1.0)
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 |