Markdown

⚠️ Important Update

This article is outdated and no longer reflects the current state of TX Text Control. Markdown import and export is now built directly into TX Text Control packages without the need for third-party packages. To learn how to use the integrated Markdown features, check out our updated guide:

Introducing TXTextControl.Markdown.Core: Import and Export Markdown in TX Text Control

Markdown is a popular, lightweight markup language to create formatted text in a simple way. Specifically for developers, it became a standard to describe projects such as in Readme files in GitHub repositories and other resources.

This article shows how convert Markdown files to Office Open XML and PDF documents using TX Text Control and Markdig - a powerful and extensible Markdown processor for .NET.

Use the following steps to create a console application to convert Markdown to Office Open XML and PDF documents.

Prerequisites A trial version of TX Text Control .NET Server is required for this tutorial.

Download Trial Version Setup download and installation required.

Creating the Application

In Visual Studio, create a new Console App .

In the Solution Explorer , select the created project and choose Manage NuGet Packages... from the Project main menu. Set the Package source to nuget.org and search for Markdig . Select the package Markdig and click Install .

Switch the Package source to Text Control Offline Packages and install the package TXTextControl.TextControl.ASP.SDK .

Create a new class named TXMarkdown and paste the following code into the class: using Markdig;

namespace TXTextControl { public static class Markdown { public static byte[] Convert(string markdown, BinaryStreamType binaryStreamType) {

var pipeline = new MarkdownPipelineBuilder().UseAdvancedExtensions().Build(); var htmlString = Markdig.Markdown.ToHtml(markdown, pipeline);

using (ServerTextControl tx = new ServerTextControl()) { tx.Create();

tx.Load(htmlString, StringStreamType.HTMLFormat);

byte[] results; tx.Save(out results, binaryStreamType);

return results; } } } }

Now, you can use this class in your application to convert any Markdown file to an Office Open XML (DOCX) file: var mdFile = System.IO.File.ReadAllText("sample.md");

byte[] document = TXTextControl.Markdown.Convert( mdFile, TXTextControl.BinaryStreamType.WordprocessingML);

The converted results of the following sample Markdown file can be seen in the screenshot below:

--- __Advertisement__

- __[pica](https://nodeca.github.io/pica/demo/)__ - high quality and fast image resize in browser. - __[babelfish](https://github.com/nodeca/babelfish/)__ - developer friendly i18n with plurals support and easy syntax.

TX Text Control .NET Server

DS Server

Server & Web

Windows Forms

WPF

ActiveX

Core Technologies

Blog

Core Technologies

Blog

Authors

Latest Posts

Support Resources

Documentation

Support

Getting Started

Other Resources

About Us

Industry events

Company

Contact

Newsletter

Legal

Sign in

Create account

Text Control Account

Markdown

Post tagged with Markdown in 2022

Server & Web

Windows Forms

WPF

ActiveX

Core Technologies

​

Latest Posts

​

Support

Getting Started

​

Other Resources

Company

Contact

Newsletter

Legal

Text Control Account

​

​

Markdown

Post tagged with Markdown in 2022 ​

November 2022

Post tagged with Markdown in 2022