WaywardTools

Document conversion that stays on your machine

OpenDocument Markdown Swap

OpenDocument to Markdown

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

1 · Choose a OpenDocument file

…or drop a OpenDocument file here

.odt · stays in this tab

2 · Convert

3 · Download

Choose a file to convert. It is not uploaded.

FAQ and format details
Why convert OpenDocument to Markdown?

Open-source projects and administrations that mandate ODT still want README-quality sources. ODT→Markdown is also how you extract a report for Obsidian without a cloud office suite.

How this conversion runs

content.xml → semantic HTML (including outline-level headings) → Turndown GFM. Named Strong/Emphasis spans become Markdown emphasis. Tables become pipe tables when they were real table:table elements.

Keep in mind for OpenDocument → Markdown

Writer frames, indexes, and bibliographic fields will not become Markdown directives. Images need to have been inlined; otherwise you get alt placeholders. Do not expect round-trip ODT→MD→ODT to match styles.xml.

After you have a Markdown file

Clean heading levels in the .md (Writer users mix outline levels). Commit that. Use Markdown→HTML as the preview. Keep the ODT if Writer comments still matter — they did not travel.

What about Writer comments?

Dropped. Resolve or export comments in LibreOffice before converting if they are decisions, not asides.

Do numbered headings stay numbered?

You get Markdown hashes, not '1.2.3' prefixes, unless those numbers were literal text. Numbering is a Writer style, not HTML.

This pair at a glance
Accepts
.odt
Writes
.md · text/markdown
Read fidelity
high (OpenDocument → HTML)
Write fidelity
high (HTML → Markdown)
Source size
Plan for files under 24 MB

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

Something off with this pair? Send feedback.

About OpenDocument Text and Markdown

Source 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
Read into HTML
high fidelity · implemented — Reads content.xml and styles.xml: headings, lists (ul/ol), tables, strike/sub/sup, and Pictures/ as data URLs.

What this format can hold

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

Usually dropped on the way in

  • master styles
  • tracked changes
  • draw frames as layout
  • macros

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.

Destination 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
Written from HTML
high fidelity · implemented — HTML is walked into GFM with Turndown.

What this format can hold

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

Usually dropped on the way out

  • complex css layout
  • nested tables
  • custom classes

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.
Other conversions

Other conversions from OpenDocument: HTMLWordRTFPDFEPUB

Other ways to get Markdown: HTMLWordRTFPDFEPUB