Markdown OpenDocument Swap

Markdown to OpenDocument

Choose a Markdown file

…or drop a Markdown file here

.md, .markdown, .mdown, .mkd

Convert

Download

FAQ and format details
Why convert Markdown to OpenDocument?

Public-sector and open-source shops often refuse DOCX as a canonical format. If your source of truth is Markdown (docs-as-code) but the records office wants ODT, this is the bridge that does not require a Windows copy of Word.

How this conversion runs

GFM → sanitized HTML → text:h / text:p / lists / tables inside content.xml, plus a small styles.xml for bold and italic. YAML front matter never becomes a Writer heading. The ZIP follows the ODF mimetype-first rule.

Keep in mind for Markdown → OpenDocument

Markdown's job is structure, not page layout. You will not get Writer master pages, indexes, or bibliographic databases from a README. Include files and MkDocs snippets are not expanded — only the file you drop is converted.

After you have a OpenDocument file

Open in LibreOffice, apply a template, and export PDF from Writer if print quality matters. Google Docs can import ODT with style remapping. Do not treat the ODT as a second source of truth; edit Markdown and reconvert.

Can I convert a whole MkDocs project?

Not as a folder. Convert one .md at a time, or build the site to HTML and use HTML→ODT on a single article export.

What about Markdown footnotes?

Standard GFM as parsed here does not implement footnotes. They will appear as literal [^1] unless you preprocessed them to links.

This pair at a glance
Accepts
.md, .markdown, .mdown, .mkd
Writes
.odt · application/vnd.oasis.opendocument.text
Read fidelity
high (Markdown → HTML)
Write fidelity
high (HTML → OpenDocument)
Source size
Plan for files under 3.8 MB

Runs in this browser.

Something off with this pair? Send feedback.

About Markdown and OpenDocument Text

Source file

Markdown

A lightweight plain-text syntax for structured writing that compiles to HTML. The lingua franca of README files, wikis, and note apps.

Markdown stores documents as readable plain text with a small set of punctuation conventions for headings, emphasis, lists, links, and code. GitHub-Flavored Markdown (GFM) adds tables, strikethrough, task lists, and fenced code blocks. Conversion through HTML is a natural fit because Markdown was designed as an HTML shorthand.

Extensions
.md, .markdown, .mdown, .mkd
MIME types
text/markdown, text/x-markdown
Kind
text · utf-8
Category
markup
Standard
Open format · since 2004
Comfortable size
Up to about 3.8 MB in this browser converter
Read into HTML
high fidelity · implemented — Parsed as GitHub-Flavored Markdown.

What this format can hold

  • headings
  • paragraphs
  • lists
  • tables
  • links
  • images
  • inline formatting
  • code blocks
  • blockquotes

Usually dropped on the way in

  • raw html passthrough is sanitized

Apps that consume Markdown

  • GitHub (GitHub) — creates and opens on Web
  • Obsidian (Dynalist) — creates and opens on Windows, macOS, Linux, iOS, Android
  • VS Code (Microsoft) — creates on Windows, macOS, Linux
  • Typora — creates and opens on Windows, macOS, Linux
  • Notion — creates and opens on Web, Windows, macOS
  • Jupyter — creates and opens on Web
  • Discord — opens on Web, Windows, macOS, iOS, Android

Catalog notes

  • Front matter (YAML between --- lines) is preserved as a prefix when converting from Markdown, and ignored when converting to Markdown.
  • Obsidian wikilinks and footnotes have no lossless HTML equivalent yet.

Destination file

OpenDocument Text

The ISO text format used by LibreOffice Writer and OpenOffice: a ZIP of XML, the open counterpart to DOCX.

ODT is part of the OpenDocument family (ODS spreadsheets, ODP presentations). Governments and open-source shops standardize on it. Internally it is content.xml plus styles, metadata, and media. Conversion through HTML maps text:h / text:p / tables onto HTML equivalents.

Extensions
.odt
MIME types
application/vnd.oasis.opendocument.text
Kind
zip · binary
Category
word processing
Standard
Open format · since 2005
Comfortable size
Up to about 24 MB in this browser converter
Written from HTML
high fidelity · implemented — Writes a minimal ODT package with nested lists, emphasis styles, and Pictures/ embeds for data-URL images.

What this format can hold

  • headings
  • paragraphs
  • lists
  • tables
  • links
  • images
  • inline formatting
  • styles

Usually dropped on the way out

  • css positioning
  • webfonts

Apps that consume OpenDocument

  • LibreOffice Writer (The Document Foundation) — creates and opens on Windows, macOS, Linux
  • Apache OpenOffice Writer (Apache) — creates and opens on Windows, macOS, Linux
  • Google Docs (Google) — creates and opens on Web
  • Microsoft Word (Microsoft) — creates and opens on Windows, macOS, Web
  • Calligra Words (KDE) — creates and opens on Linux
  • OnlyOffice — creates and opens on Windows, macOS, Linux, Web

Catalog notes

  • FODT (flat XML OpenDocument) is not yet a separate type; save as ODT first.
  • ZIP collision with DOCX/EPUB is resolved by checking mimetype or META-INF/manifest.xml.
Other conversions

Other conversions from Markdown: HTMLWordRTFPDFEPUB

Other ways to get OpenDocument: HTMLWordRTFPDFEPUB