Customizing document styles with FSharp.Markdown.Pdf

Following on from my last post on formatting a Markdown document into PDF using FSharp.Markdown.Pdf, if you don’t like the default styling (which I tried to mimic style Github formats Markdown documents with) you can set your own styling for the different types of Markdown elements by going down a level of abstraction.

The FSharp.Markdown.Pdf.MarkdownStyleNames module defines all the names of styles used to format the different Markdown elements (e.g. heading 1-6, code block, listing 1-3, etc.) into PDF. To override the default styles, you need to:

  1. Instantiate an instance of the Document type from the MigraDoc.DocumentObjectModel namespace.
  2. Add the predefined style names from the aforementioned MarkdownStyleNames module to the document’s collection of styles.
  3. Tweak the style to your liking.
  4. Call the FSharp.Markdown.Pdf.PdfFormatting.formatMarkdown function with the Document value.
  5. Voila! You now have an instance of PdfDocument which has been formatted with your custom styling.

to see these simple steps in action:

You can compare the original and customized PDF outputs here and here.

Liked this article? Support me on Patreon and get direct help from me via a private Slack channel or 1-2-1 mentoring.
Subscribe to my newsletter


Hi, I’m Yan. I’m an AWS Serverless Hero and the author of Production-Ready Serverless.

I specialise in rapidly transitioning teams to serverless and building production-ready services on AWS.

Are you struggling with serverless or need guidance on best practices? Do you want someone to review your architecture and help you avoid costly mistakes down the line? Whatever the case, I’m here to help.

Hire me.


Check out my new course, Complete Guide to AWS Step Functions. In this course, we’ll cover everything you need to know to use AWS Step Functions service effectively. Including basic concepts, HTTP and event triggers, activities, callbacks, nested workflows, design patterns and best practices.

Get Your Copy