TXTextControl.Markdown.Core 33.0.0-beta.2

TXTextControl.Markdown.Core

TXTextControl.Markdown.Core is a .NET 8 library that provides a public interface for converting between Markdown and TX Text Control documents. It enables seamless integration of Markdown import and export functionality with TX Text Control, a powerful word processing component for .NET applications.

It works with:

• TXTextControl.ServerTextControl (.NET, ASP.NET Core)
• TXTextControl.TextControl (WinForms)
• TXTextControl.WPF.TextControl (WPF)

Features

• Import Markdown content into a TX Text Control document
• Export TX Text Control document content as Markdown
• Simple and intuitive API

Install

dotnet add package TXTextControl.Markdown.Core

Targets: net8.0

Namespace to import:

using TXTextControl.Markdown;

Quick start

// Server (ASP.NET Core / services)
using TXTextControl;
using TXTextControl.Markdown;

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

tx.LoadMarkdown("# Hello from Markdown");
string md = tx.SaveMarkdown();
// or:
tx.SaveMarkdown(out var mdOut);

Requirements

• A TX Text Control instance at runtime (ServerTextControl, TextControl, or WPF.TextControl), created by your app.
• .NET net8.0.

Trimming / AOT (NativeAOT, PublishTrimmed)

If you publish trimmed or AOT, reflection needs the TX Text Control members preserved. Options:

• Use the package as-is with its buildTransitive trimming descriptor (if included in your version).
• Or add your own linker config to keep:
  • TXTextControl.StringStreamType
  • TXTextControl.SaveSettings (property CssSaveMode)
  • TXTextControl.CssSaveMode (value Inline)
  • Load/Save on your control types

Limitations

• Only basic Markdown features are supported including:
  • Headings
  • Paragraphs
  • Horizontal rules
  • Blockquote
  • Lists
  • Images
  • Links
  • Tables

Supported Styles

The following style names are supported and will be exported to Markdown. They get converted to the proper Markdown syntax. Inline formatting is additionally converted to Markdown.

Paragraph styles:

• BODY
• H1
• H2
• H3
• H4
• H5
• H6
• BLOCKQUOTE

Inline styles:

• TH
• PRE
• STRONG
• EM
• CAPTION
• CODE
• A
• KBD
• DEL
• S
• STRIKE

Style to Markdown Mapping

Handling Different Style Names

When converting documents from formats such as DOCX, RTF, or HTML to Markdown, the style names in the source document may differ from the supported style names listed above.
In this case, you should map custom styles to supported Markdown styles before conversion.

For example:

• Map Heading 1, Überschrift 1, or Title1 → H1
• Map Quote or Citation → BLOCKQUOTE
• Map Strong Emphasis → STRONG
• Map CaptionText → CAPTION (which is converted to italic Markdown)

This mapping can be done by:

• Normalizing style names in the TX Text Control document before calling SaveMarkdown
• Applying a custom mapping layer in your code that translates document-specific styles to the supported names

If a style is not mapped, it will be exported as plain text without Markdown formatting.

Versioning

This package binds to TX Text Control's public method and enum names. If those change in a future major TX Text Control release, update this package accordingly.

License

Redistribution and use in source and binary forms, with or without modification, are permitted with a valid license of TX Text Control.

THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.