# Convert Markdown to HTML, PDF and Word

Convert Markdown to HTML, PDF and Word, and HTML back to Markdown, with conversion reports that list anything that could not be kept.

**Packages**

- [OfficeIMO.Markdown](https://www.nuget.org/packages/OfficeIMO.Markdown) `dotnet add package OfficeIMO.Markdown`
- [OfficeIMO.Markdown.Pdf](https://www.nuget.org/packages/OfficeIMO.Markdown.Pdf) `dotnet add package OfficeIMO.Markdown.Pdf`
- [OfficeIMO.Word.Markdown](https://www.nuget.org/packages/OfficeIMO.Word.Markdown) `dotnet add package OfficeIMO.Word.Markdown`
- [OfficeIMO.Markdown.Html](https://www.nuget.org/packages/OfficeIMO.Markdown.Html) `dotnet add package OfficeIMO.Markdown.Html`

**Works with**

- .NET
- [PowerShell](/docs/pswriteoffice/install/) `Install-Module PSWriteOffice`
- [CLI](/docs/cli/install/) `dotnet tool install --global OfficeIMO.Tool`

**Target frameworks**

netstandard2.0, net8.0, net10.0, net472

**APIs**

- [`MarkdownDocument`](/api/markdown/officeimo-markdown-markdowndocument/)
- [`MarkdownVisualTheme`](/api/markdown/officeimo-markdown-markdownvisualtheme/)
- [`HtmlConversionDocument`](/api/html/officeimo-html-htmlconversiondocument/)
- [`OfficeConversionReport`](/api/core/officeimo-officeconversionreport/)
- [`HtmlMarkdownExportOptions`](/api/markdown-html/officeimo-markdown-html-htmlmarkdownexportoptions/)
- [`MarkdownHtmlExportOptions`](/api/markdown/officeimo-markdown-markdownhtmlexportoptions/)
- [`MarkdownHtmlKind`](/api/markdown/officeimo-markdown-markdownhtmlkind/)
- [`MarkdownPdfExportOptions`](/api/markdown-pdf/officeimo-markdown-pdf-markdownpdfexportoptions/)
- [`MarkdownWordExportOptions`](/api/word-markdown/officeimo-word-markdown-markdownwordexportoptions/)
- [`WordDocument`](/api/word/officeimo-word-worddocument/)
- [`MarkdownColorSchemeKind`](/api/markdown/officeimo-markdown-markdowncolorschemekind/)
- [`MarkdownHtmlStyle`](/api/markdown/officeimo-markdown-markdownhtmlstyle/)

**Cmdlets**

- [`Convert-OfficeDocument`](/api/powershell/convert-officedocument/)
- [`New-OfficeMarkdownPdfOptions`](/api/powershell/new-officemarkdownpdfoptions/)
- [`New-OfficeMarkdownWordOptions`](/api/powershell/new-officemarkdownwordoptions/)
- [`New-OfficeHtmlMarkdownOptions`](/api/powershell/new-officehtmlmarkdownoptions/)

**Commands**

- [`officeimo convert`](/docs/cli/convert/)

**Limits**

Markdown output cannot express merged table cells, cell borders or page layout; those conversions report the loss instead of dropping it silently. [OfficeIMO.Markdown support matrix](/compatibility/#package-markdown), [OfficeIMO.Markdown.Pdf support matrix](/compatibility/#package-markdown-pdf), [OfficeIMO.Word.Markdown support matrix](/compatibility/#package-word-markdown), [OfficeIMO.Markdown.Html support matrix](/compatibility/#package-markdown-html)

**Verified**

Examples compiled against the source on 2026-11-14

**Data**

- [OfficeIMO.Markdown API index](/api/markdown/index.json)
- [OfficeIMO.Markdown.Pdf API index](/api/markdown-pdf/index.json)
- [OfficeIMO.Word.Markdown API index](/api/word-markdown/index.json)
- [OfficeIMO.Markdown.Html API index](/api/markdown-html/index.json)
- [PSWriteOffice command catalog](/data/powershell/commands.json)
- [CLI command catalog](/data/cli/commands.json)
- [Capability catalog (JSON)](/data/capabilities.json)

Every route starts from a `MarkdownDocument`, so you parse once and send the same model to any target. HTML rendering is built into `OfficeIMO.Markdown`. PDF needs `OfficeIMO.Markdown.Pdf`, Word needs `OfficeIMO.Word.Markdown`, and HTML input needs `OfficeIMO.Markdown.Html`. Each `SaveAs…` method returns an `OfficeConversionReport`; set `FailOnLoss` on the options when a conversion must stop instead of writing a lossy file.

```sh
dotnet add package OfficeIMO.Markdown.Pdf
dotnet add package OfficeIMO.Word.Markdown
dotnet add package OfficeIMO.Markdown.Html
```

## Convert Markdown to an HTML page

### C#

```csharp
using OfficeIMO;
using OfficeIMO.Markdown;

File.WriteAllText("status.md", "# Status\n\n| Service | State |\n| --- | --- |\n| API | Green |\n");

MarkdownDocument document = MarkdownDocument.Load("status.md");
OfficeConversionReport report = document.SaveAsHtml("status.html", new MarkdownHtmlExportOptions {
    Kind = MarkdownHtmlKind.Document,
    Style = MarkdownHtmlStyle.Clean,
    Title = "Service status"
});

Console.WriteLine($"{report.Target}: {report.OutputPath}");
```

## Convert Markdown to PDF

Front matter can supply the PDF title, author and theme. Local images are read only when you allow them with a resource policy.

### C#

```csharp
using OfficeIMO;
using OfficeIMO.Markdown;
using OfficeIMO.Markdown.Pdf;

MarkdownDocument document = MarkdownDocument.Parse("""
---
title: Incident review
author: Operations
---
# Incident review

## Summary

- Detection was automatic.
- Customer impact was limited.

| Task | Owner |
| --- | --- |
| Update monitor | Platform |
""");

OfficeConversionReport report = document.SaveAsPdf("incident-review.pdf", new MarkdownPdfExportOptions {
    UseFrontMatterMetadata = true,
    Theme = MarkdownVisualTheme.Report()
});

foreach (OfficeDiagnostic diagnostic in report.Diagnostics) {
    Console.WriteLine($"{diagnostic.Code}: {diagnostic.Message}");
}
```

### PowerShell

```powershell
$options = New-OfficeMarkdownPdfOptions -Title 'Service report' -IncludeLocalImages -BaseDirectory .\Assets
Convert-OfficeDocument -Path .\Report.md -OutputPath .\Report.pdf -Options $options
```

### CLI

```sh
officeimo convert Report.md Report.pdf
```

## Convert Markdown to Word

`ToWord` maps headings, lists, tables, images, code, footnotes and TeX math to native Word content, and turns `[TOC]` markers into a Word table of contents.

### C#

```csharp
using OfficeIMO.Markdown;
using OfficeIMO.Word;
using OfficeIMO.Word.Markdown;

MarkdownDocument markdown = MarkdownDocument.Parse("""
# Runbook

[TOC]

## Prepare

Stop the **scheduler** before you start.

## Deploy

1. Copy the package.
2. Restart the service.
""");

using WordDocument word = markdown.ToWord(new MarkdownWordExportOptions {
    AllowLocalImages = true,
    FitImagesToPageContentWidth = true
});
word.Save("runbook.docx");
```

### PowerShell

```powershell
Convert-OfficeDocument -Path .\Runbook.md -To Word -OutputPath .\Runbook.docx

# Fill a template at a bookmark instead of creating a blank document
$options = New-OfficeMarkdownWordOptions -Template .\Templates\Runbook.dotx -BookmarkName Body
Convert-OfficeDocument -Path .\Runbook.md -To Word -OutputPath .\Runbook.docx -Options $options
```

### CLI

```sh
officeimo convert Runbook.md Runbook.docx
```

## Convert HTML to Markdown

Parse the HTML with `HtmlConversionDocument`, then call `ToMarkdown`. Profiles choose the Markdown dialect: GitHub-flavored, CommonMark or portable.

### C#

```csharp
using OfficeIMO.Html;
using OfficeIMO.Markdown;
using OfficeIMO.Markdown.Html;

HtmlConversionDocument source = HtmlConversionDocument.Parse("""
<h1>Release notes</h1>
<p>See the <a href="guide/start">getting started guide</a>.</p>
<table><tr><th>Area</th><th>State</th></tr><tr><td>PDF</td><td>Done</td></tr></table>
<div class="cookie-banner">Accept cookies</div>
""");

HtmlMarkdownExportOptions options = HtmlMarkdownExportOptions.CreateGitHubFlavoredMarkdownProfile();
options.BaseUri = new Uri("https://example.com/docs/");
options.ExcludeSelectors.Add(".cookie-banner");

using MarkdownDocument document = source.ToMarkdown(options);
document.Save("release-notes.md");
Console.WriteLine(document.ToMarkdown());
```

### PowerShell

```powershell
$options = New-OfficeHtmlMarkdownOptions -Portable -LineEnding LF
Convert-OfficeDocument -Path .\Report.html -To Markdown -OutputPath .\Report.md -Options $options
```

### CLI

```sh
officeimo convert Report.html Report.md
```

## Use one theme for HTML, PDF and Word

A `MarkdownVisualTheme` carries fonts, colors, spacing and table styling into every adapter, so the three outputs look alike.

### C#

```csharp
using OfficeIMO;
using OfficeIMO.Markdown;
using OfficeIMO.Markdown.Pdf;
using OfficeIMO.Word;
using OfficeIMO.Word.Markdown;

MarkdownVisualTheme theme = MarkdownVisualTheme.FromOfficeTheme(OfficeTheme.Boardroom)
    .WithColorScheme(MarkdownColorSchemeKind.Emerald);

using MarkdownDocument document = MarkdownDocument.Parse("# Quarterly report\n\n| Region | Sales |\n| --- | ---: |\n| North | 120 |\n");

document.SaveAsHtml("report.html", new MarkdownHtmlExportOptions { Kind = MarkdownHtmlKind.Document, Theme = theme });
document.SaveAsPdf("report.pdf", new MarkdownPdfExportOptions { Theme = theme });

using WordDocument word = document.ToWord(new MarkdownWordExportOptions { Theme = theme });
word.Save("report.docx");
```

<!-- PowerForge markdown source sha256:349B7BE5F9C6AD5B466B4FC177DB21B040075AC6F6CE0ED7A2D31EE1D02315DB; title=True -->

<!-- PowerForge markdown artifact sha256:0C45CFEC6C5016E7166670A1ED7C9F5A7F2442C8AD6B36BE6331985CC89DCCE2 -->
