WaywardTools

Small tools. Local when they can be.

Markdown OpenDocument Swap

Markdown to OpenDocument

Your file never leaves this device. Conversion runs in your browser. The document itself is not uploaded.

1 · Choose a Markdown file

…or drop a Markdown file here

.md, .markdown, .mdown, .mkd · stays in this tab

2 · Convert

3 · Download

Choose a file to convert. It is not uploaded.

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

The file is read in this tab. It is not uploaded.

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