GroupDocs.Markdown for .NET overview

What is GroupDocs.Markdown?

GroupDocs.Markdown is a .NET library that converts documents from 20+ formats (PDF, Word, Excel, EPUB, TXT, CHM) into clean, structured Markdown. It uses a custom DOM-based renderer that gives full control over every aspect of the output.

Designed for AI/ML workflows, static site generators, and document processing pipelines — Markdown is the ideal format for language models, text analysis tools, and content management systems.

Key capabilities

CapabilityDescription
20+ input formatsPDF, DOCX, DOC, XLSX, XLS, CSV, EPUB, MOBI, TXT, CHM, RTF, ODT, and more
Markdown flavorsGitHub Flavored Markdown or CommonMark
Image handlingBase64 embed, file system, skip, or custom with relative paths and image replacement
YAML front matterAuto-extract metadata for Jekyll, Hugo, Docusaurus
Document inspectionRead format, pages, title, author without converting
Spreadsheet controlColumn/row truncation, sheet separators, hidden sheet filtering
Heading offsetShift heading levels for content embedding
Async APINon-blocking conversion for web and serverless
Error handlingSpecific exception types and conversion warnings

Quick example

using GroupDocs.Markdown;

// One-liner
string md = MarkdownConverter.ToMarkdown("business-plan.docx");
// # Quarterly Report
//
// ## Executive Summary
//
// This report covers the key initiatives...

// With options
var options = new ConvertOptions
{
    Flavor = MarkdownFlavor.GitHub,
    IncludeFrontMatter = true,
    HeadingLevelOffset = 1
};
MarkdownConverter.ToFile("business-plan.docx", "quick-example.md", options);

business-plan.docx is a sample file used in this example. Click here to download it.

---
title: "Meridian Outdoor Co. — Business Plan"
author: "Meridian Outdoor Co."
format: Docx
pages: 5
---

![](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAlgAAAC0CAYAAABIf1IMAAAABHNCSVQICAgIfAhkiAAADcJJREFUeJzt3VFo3VWeB/BfF2EfdJraSWKkpovabiokaRZcfWiM4jCS0mELjvgwzlZt16fdlUFpKbLCgDKELQ7Oum+yNdYdH4StCLMkdBexSfow7sC0SUA7TZVJW0zbWI1OF/ap+xD+/97k/u/Nze1JbJLPBwo9/3vu/Z1/L5Qv55x7/uumJkauBQAAyfzZdz0AAIDVRsACAEhMwAIASEzAAgBI7Jaii//67/8dZ89dSlbkH576Qdy7+Y4F+6Wqq5566qmnnnrqqbdc9YoUBqyJyYsxevrcDQ2q1LdX/6
[TRUNCATED]

Download full output

Platform support

  • Windows, Linux, macOS
  • .NET Framework 4.6.2+
  • .NET 6.0, 8.0, 10.0

Get started