Convert files to various formats

GroupDocs.Markdown provides a quick and easy way to convert documents into clean, structured Markdown. The library offers two approaches: static methods for one-line conversions and an instance API for more control.

Static methods (simplest)

Call MarkdownConverter.to_markdown() to get a Markdown string, or MarkdownConverter.to_file() to write directly to disk:

from groupdocs.markdown import MarkdownConverter

md = MarkdownConverter.to_markdown("business-plan.docx")
MarkdownConverter.to_file("business-plan.docx", "convert-static.md")

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

Instance API

Create a MarkdownConverter instance for advanced scenarios such as inspecting metadata before converting or reusing a loaded document:

from groupdocs.markdown import MarkdownConverter, ConvertOptions

with MarkdownConverter("business-plan.docx") as converter:
    options = ConvertOptions()
    options.heading_level_offset = 1

    converter.convert("convert-instance.md", convert_options=options)

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

Conversion options

Use ConvertOptions to customize the output – select specific pages, control image handling, choose a Markdown flavor, add YAML front matter, and more. For loading customization, use LoadOptions to specify file format or provide a password.

These documentation articles explain how to convert files from the most popular formats: