Skip to content

Word to Markdown

Turn a .docx into Markdown for docs, wikis and static sites.

How to convert Word to Markdown

Three steps, all in your browser.

  1. 1

    Add your document

    Drop or open a file, or paste text straight into the box.

  2. 2

    Check the preview

    The converted result updates as you type or change a setting.

  3. 3

    Download

    Save the converted file, or copy the text.

Word to Markdown: what to know

Markdown is the plain-text format behind README files, wikis, documentation sites and note apps like Obsidian. This converter reads a Word document in your browser and writes Markdown: # headings from Word's heading styles, - bullets and numbered lists with nesting, **bold**, _italic_, ~~strikethrough~~, [links](url) and fenced code blocks.

Tables become GitHub Flavored Markdown pipe tables. Markdown tables always have a header row, so the first row of each Word table is used as the header. A cell can only hold one line in a pipe table, so paragraphs inside a cell are joined with spaces, and any pipe character in a cell is escaped so it doesn't break the table.

Images are kept as data: URIs by default, which makes a self-contained file but long lines. Many people prefer to leave images out and add them as separate files. Underline, highlighting, colors and fonts have no Markdown syntax, so that text arrives plain.

Popular uses

  • Moving documentation from Word into a Git repository
  • Publishing Word content on a static site such as Hugo, Jekyll or Astro
  • Importing notes into Obsidian, Notion or another Markdown editor
  • Reviewing document changes with plain-text diffs

Tips for the best result

  • Apply Word's real heading styles before converting so each heading gets the right number of # signs.
  • Keep tables simple: merged cells and lists inside cells don't fit pipe tables.
  • Code formatted with a paragraph style named Code becomes a fenced code block.

Read how JustYourConvert works and our privacy details. Keep your original files and check a converted file before you replace anything.

Frequently asked questions

CommonMark with GitHub Flavored Markdown tables and strikethrough: # headings, - bullets, numbered lists, **bold**, _italic_, [links](url) and fenced code blocks. It reads well in GitHub, GitLab, Obsidian, static site generators and most documentation tools.

Each table becomes a pipe table, with the first row as the header row because Markdown tables need one. Everything inside a cell is joined onto one line, since pipe tables can't hold paragraphs or lists, and pipe characters in cells are escaped.

By default they're embedded in the Markdown as data: URIs. That keeps everything in one file, but the file gets long and some editors show the code instead of the picture. Leave images out if you'd rather add them yourself.

Colors, fonts, font sizes, underline, highlighting, text alignment, page layout, headers, footers and comments. Markdown has no syntax for them, so that text comes through plain.

No. Every live tool on JustYourConvert opens and converts your files inside your browser, on your own device. Nothing is sent to our servers, and the result is saved straight from your browser.

Yes. Every tool is free, with no sign-up, no watermark and no daily limit. Clearly labeled ads keep it that way.

Only your device's memory. Because the work happens in your browser, very large files can be slow on phones and older computers. Each tool says its practical limit under the drop area.