Template Source Markdown
# Telerik Document Processing Library
**Telerik DPL** is a server-side .NET library for creating, importing,
exporting, and converting documents *without any UI dependencies*.
It supports a wide range of formats and runs on .NET Standard 2.0,
.NET 8, and .NET 10.
## Supported Formats
| Format | Import | Export | Notes |
|----------|--------|--------|----------------------------------|
| DOCX | ✓ | ✓ | OpenXML Word Processing |
| RTF | ✓ | ✓ | Rich Text Format |
| HTML | ✓ | ✓ | HyperText Markup Language |
| TXT | ✓ | ✓ | Plain text |
| Markdown | ✓ | ✓ | CommonMark and GitHub Flavored |
| PDF | — | ✓ | Export via PdfFormatProvider |
## Key Features
- **Format conversion** — Load any format and save it to a different one
with just a few lines of code.
- **Rich document model** — Paragraphs, tables, lists, headers, footers,
images, and hyperlinks are all first-class citizens.
- **Cross-platform** — No Word, Excel, or Acrobat installation required
on the server. Runs anywhere .NET runs.
- **High performance** — Optimized for throughput; suitable for
server-side pipelines processing thousands of documents.
## Quick Start
### 1. Add the NuGet Package
```xml
<PackageReference Include="Telerik.Documents.Flow" Version="*" />
```
### 2. Convert Markdown to DOCX
```csharp
var mdProvider = new MarkdownFormatProvider();
var docxProvider = new DocxFormatProvider();
RadFlowDocument document = mdProvider.Import(File.OpenRead("input.md"));
using var output = File.Create("output.docx");
docxProvider.Export(document, output);
```
## Markdown Import Support
The `MarkdownFormatProvider` converts these Markdown elements to their
document model equivalents:
1. Headings (H1 – H6) → Heading paragraph styles
2. **Bold** and *italic* → Character formatting properties
3. Ordered and unordered lists → List paragraphs with numbering
4. Tables (GitHub Flavored Markdown) → Word-compatible table model
5. Fenced code blocks → Monospaced paragraph style
6. Inline `code` spans → Monospaced character formatting
7. Hyperlinks → Inline hyperlink fields
8. Block quotes → Indented paragraph style
> **Tip:** When exporting to PDF, combine `MarkdownFormatProvider`
> with `PdfFormatProvider` from the
> `Telerik.Documents.Flow.FormatProviders.Pdf` package for
> pixel-perfect output.
## Markdown Export Support
Any `RadFlowDocument` — regardless of how it was originally created or
imported — can be exported to Markdown. The exporter maps document
elements back to their Markdown representations, preserving:
- **Heading styles** as ATX-style `#` headers
- *Italic* and **bold** inline runs
- Tables as GitHub Flavored Markdown pipe tables
- Hyperlinks as `[text](url)` syntax
- Code paragraphs as fenced `` ``` `` blocks
## License
Telerik DPL is part of the **Telerik DevCraft** product suite.
A free trial is available at [telerik.com](https://www.telerik.com).
