GroupDocs.Markdown for .NET overview
Leave feedback
On this page
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.
| Capability | Description |
|---|---|
| 20+ input formats | PDF, DOCX, DOC, XLSX, XLS, CSV, EPUB, MOBI, TXT, CHM, RTF, ODT, and more |
| Markdown flavors | GitHub Flavored Markdown or CommonMark |
| Image handling | Base64 embed, file system, skip, or custom with relative paths and image replacement |
| YAML front matter | Auto-extract metadata for Jekyll, Hugo, Docusaurus |
| Document inspection | Read format, pages, title, author without converting |
| Spreadsheet control | Column/row truncation, sheet separators, hidden sheet filtering |
| Heading offset | Shift heading levels for content embedding |
| Async API | Non-blocking conversion for web and serverless |
| Error handling | Specific exception types and conversion warnings |
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]
- Windows, Linux, macOS
- .NET Framework 4.6.2+
- .NET 6.0, 8.0, 10.0
Was this page helpful?
Any additional feedback you'd like to share with us?
Please tell us how we can improve this page.
Thank you for your feedback!
We value your opinion. Your feedback will help us improve our documentation.