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

def convert_static():
    """Convert a document to Markdown using the static one-liner API."""
    MarkdownConverter.to_file("business-plan.docx", "convert-static-methods.md")

if __name__ == "__main__":
    convert_static()

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

![](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAlgAAAC0CAYAAABIf1IMAAAABHNCSVQICAgIfAhkiAAADcJJREFUeJzt3VFo3VWeB/BfF2EfdJraSWKkpovabiokaRZcfWiM4jCS0mELjvgwzlZt16fdlUFpKbLCgDKELQ7Oum+yNdYdH4StCLMkdBexSfow7sC0SUA7TZVJW0zbWI1OF/ap+xD+/97k/u/Nze1JbJLPBwo9/3vu/Z1/L5Qv55x7/uumJkauBQAAyfzZdz0AAIDVRsACAEhMwAIASEzAAgBI7Jaii//67/8dZ89dSlbkH576Qdy7+Y4F+6Wqq5566qmnnnrqqbdc9YoUBqyJyYsxevrcDQ2q1LdX/6+mfqnqqqeeeuqpp5566i1XvSKFAWvL5jti3bp1cXbyYvzpf+v/cACAtWhZZrAAANaSdUUHjf7sF7+eE7D+/qkfxL2t9a1BRszOiN12658v2O
[TRUNCATED]

Download full output

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

def convert_instance():
    """Convert a document using the instance API with conversion options."""
    with MarkdownConverter("business-plan.docx") as converter:
        options = ConvertOptions()
        options.heading_level_offset = 1

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

if __name__ == "__main__":
    convert_instance()

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

![](data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAAlgAAAC0CAYAAABIf1IMAAAABHNCSVQICAgIfAhkiAAADcJJREFUeJzt3VFo3VWeB/BfF2EfdJraSWKkpovabiokaRZcfWiM4jCS0mELjvgwzlZt16fdlUFpKbLCgDKELQ7Oum+yNdYdH4StCLMkdBexSfow7sC0SUA7TZVJW0zbWI1OF/ap+xD+/97k/u/Nze1JbJLPBwo9/3vu/Z1/L5Qv55x7/uumJkauBQAAyfzZdz0AAIDVRsACAEhMwAIASEzAAgBI7Jaii//67/8dZ89dSlbkH576Qdy7+Y4F+6Wqq5566qmnnnrqqbdc9YoUBqyJyYsxevrcDQ2q1LdX/6+mfqnqqqeeeuqpp5566i1XvSKFAWvL5jti3bp1cXbyYvzpf+v/cACAtWhZZrAAANaSdUUHjf7sF7+eE7D+/qkfxL2t9a1BRszOiN12658v2O
[TRUNCATED]

Download full output

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:

Close
Loading

Analyzing your prompt, please hold on...

An error occurred while retrieving the results. Please refresh the page and try again.