MdToPptx 2.0.1

MdToPptx

A .NET 8 library that converts Markdown text to OpenXML PowerPoint (PPTX) elements. Parse your Markdown once, get properly formatted paragraphs, lists, tables, and inline styles ready to insert into any PPTX slide — with automatic multi-slide pagination when content overflows.

Supported Markdown Features

Installation

Add the NuGet package to your project (once published), or reference the project directly:

dotnet add reference path/to/src/MdToPptx/MdToPptx.csproj

Dependencies

• DocumentFormat.OpenXml (>= 3.4.1)
• Markdig (>= 0.45.0)

Quick Start

Creating a Multi-Slide PPTX from Scratch

Use AddToSlides to automatically paginate content across multiple slides when it exceeds the usable area:

using MdToPptx;
using MdToPptx.Helpers;

var markdown = """
    # Quarterly Report
    Revenue increased by **15%** compared to last quarter.

    | Metric | Q1 | Q2 |
    | --- | --- | --- |
    | Revenue | $2.0M | $2.3M |

    ## Highlights
    - Launched **new enterprise tier**
    - Expanded into *3 new markets*

    For details, visit [the dashboard](https://example.com).
    """;

using var doc = PresentationBuilder.CreatePresentation("output.pptx", widescreen: true);

var converter = new MarkdownToPptxConverter(new ConversionOptions
{
    DefaultFontSize = 1400,  // 14pt
});

// Automatically creates as many slides as needed
List<SlidePart> slides = converter.AddToSlides(doc, markdown);

doc.Save();
Console.WriteLine($"Created {slides.Count} slide(s)");

Adding Markdown to a Single Slide

If you already have a slide and want to add content to it (no auto-pagination):

using var doc = PresentationBuilder.CreatePresentation("output.pptx");
var slidePart = PresentationBuilder.AddBlankSlide(doc);

var converter = new MarkdownToPptxConverter();
converter.AddToSlide(slidePart, markdownText);

doc.Save();

Get Paragraphs for an Existing Text Body

var converter = new MarkdownToPptxConverter();
var paragraphs = converter.ConvertToParagraphs("**Hello** *world*");

// Append to any TextBody (shape, table cell, etc.)
foreach (var p in paragraphs)
{
    textBody.AppendChild(p);
}

Get Raw Elements for Custom Layout

var elements = converter.ConvertToSlideElements(markdownText);

// elements is a List<OpenXmlElement> containing:
//   - A.Paragraph for text/headings/lists
//   - A.Table for tables (wrap in GraphicFrame for slide placement)

Append Directly to a TextBody

var converter = new MarkdownToPptxConverter();
converter.AppendToTextBody(existingTextBody, markdownText);

Customization

Pass a ConversionOptions object to control styling:

var converter = new MarkdownToPptxConverter(new ConversionOptions
{
    DefaultFontFamily = "Arial",
    CodeFontFamily = "Fira Code",
    DefaultFontSize = 1600,            // 16pt (value is in hundredths of a point)
    DefaultFontColor = "333333",       // dark gray
    LinkFontColor = "1A73E8",          // Google blue
    CodeFontColor = "D63384",          // pink
    CodeHighlightColor = "F8F9FA",     // light background
    HeadingBold = true,
    HeadingFontColor = "1F2937",
    HeadingFontSizes = new Dictionary<int, int>
    {
        { 1, 3600 },  // 36pt
        { 2, 3000 },  // 30pt
        { 3, 2400 },  // 24pt
        { 4, 2000 },  // 20pt
        { 5, 1800 },  // 18pt
        { 6, 1600 },  // 16pt
    },
    BulletChar = "\u2022",             // bullet character
    ListIndentPerLevel = 457200,       // 0.5 inch per indent level
    ParagraphSpaceBefore = 400,
    ParagraphSpaceAfter = 400,
    TableBorderColor = "D1D5DB",
    TableHeaderBackground = "F3F4F6",
    TableBorderWidth = 12700,          // 1pt
});

API Reference

MarkdownToPptxConverter

PresentationBuilder

Project Structure

md_to_pptx/
├── src/MdToPptx/                  # Core library
│   ├── MarkdownToPptxConverter.cs # Public API (single-slide & multi-slide)
│   ├── ConversionOptions.cs       # Styling configuration
│   ├── Converters/
│   │   ├── InlineConverter.cs     # Bold, italic, code, links
│   │   ├── BlockConverter.cs      # Paragraphs, headings, lists, quotes
│   │   └── TableConverter.cs      # Table conversion
│   └── Helpers/
│       ├── PptxElementFactory.cs  # OpenXML element builders
│       └── PresentationBuilder.cs # Valid PPTX skeleton creator
├── tests/MdToPptx.Tests/         # xUnit test suite (42 tests)
├── samples/SampleApp/            # Example console application
└── MdToPptx.sln

Running the Sample

cd samples/SampleApp
dotnet run

This creates a SampleOutput.pptx file you can open in PowerPoint.

Running Tests

dotnet test

License

MIT