thoughtasylumTOOLBOX Preview Guides Use offline Automate Feedback

Tools › Text

Markup Converter

Convert between HTML, Markdown, AsciiDoc and plain text in any direction, as you type, or open a Word document (.docx) to convert it.

About this tool What it's for, how to use it and an example

What it's for

Move text between the three markup languages most documentation is written in, without retyping it. HTML is what web pages are made of, Markdown is what README files, GitHub and many note apps use, and AsciiDoc is a richer plain-text format used for books and technical documentation. Plain text is words with no markup at all.

For example, when you’re moving a project’s docs from Markdown to AsciiDoc, or want a web page’s text as Markdown for your notes, or need a README’s words without the # and ** marks.

How to use it

Choose the format you have under From and the one you want under To, then type or paste. The result updates as you type. Swap turns the result into the new source, so you can convert back and check what survived. Both choices are remembered in this browser.

Open a Word document reads a .docx (chosen or dropped on the page) into Source as HTML and converts it, to Markdown unless you’ve chosen another format. Word’s Title and Heading styles become headings.

Headings, bold, italic, code, links, images, lists (including nested lists and task lists), quotes, code blocks with their language, and tables all carry across. AsciiDoc’s notes and warnings (NOTE:, TIP: and so on) become quotes in Markdown, and its description lists become a bold term with its description below.

As plain text, paragraphs are separated by a blank line, list items start with - or a number, nested lists are indented, table cells are separated by tabs, and a link’s address follows its text in brackets. Plain text read in becomes one paragraph per blank-line-separated block, with single line breaks kept.

Example

With From set to HTML and To set to Markdown, paste:

<h2>Shopping</h2>
<p>Buy <strong>milk</strong> and <a href="https://example.com/shop">bread</a>.</p>
<ul><li>Apples</li><li>Pears</li></ul>

The result is:

## Shopping

Buy **milk** and [bread](https://example.com/shop).

- Apples
- Pears

Change To to AsciiDoc and it becomes == Shopping, Buy *milk* and https://example.com/shop[bread]. and a list of * Apples and * Pears. Change it to Plain text and the link’s address moves into brackets: Buy milk and bread (https://example.com/shop).

Good to know

Everything passes through HTML on the way, so anything the target format has no way to write is simplified or dropped: Markdown has no underline, admonitions or description lists, and HTML’s colours, classes and layout don’t survive in Markdown or AsciiDoc. Plain text keeps only the words, so headings, bold and quotes are lost, and a code block’s language is dropped. Markdown joins lines that have no blank line between them, so they run together in plain text, as they do on a web page. A Markdown table needs a header row, so a table without one stays as HTML. AsciiDoc include:: lines become a link to the file, since nothing is read from outside the page. Text that happens to contain AsciiDoc marks, such as a pair of * or #, isn’t escaped and may turn into formatting.

From Word, headings come only from Word’s heading styles, not from large bold text. Pictures, comments, footnotes, text boxes and deleted tracked changes are left out, and colours, fonts and underlining aren’t kept. Older .doc files aren’t read.

Guides: Cleaning up text copied from a PDF, email or web page · Turning notes or a Word document into a polished PDF report · Publishing an ebook that stores accept

Markdown is GitHub-flavoured, read by marked and written by Turndown. AsciiDoc is read by Asciidoctor.js.

Built with The third-party code and data this tool uses, and their licences

This tool runs on the following open-source work, copied onto this site and served from it:

Asciidoctor.js 4.1.0
Copyright
Copyright (C) 2014-present Dan Allen, Guillaume Grossetie, Anthonny Quérouil and the Asciidoctor Project
Licence
MIT License
Source
github.com/asciidoctor/asciidoctor.js
marked 15.0.12
Copyright
Copyright (c) 2011-2025, Christopher Jeffrey
Licence
MIT License
Source
github.com/markedjs/marked
Turndown, with turndown-plugin-gfm 1.0.2 7.2.4
Copyright
Copyright (c) 2017 Dom Christie
Licence
MIT License
Source
github.com/mixmark-io/turndown

Every page also uses Montserrat (SIL Open Font License 1.1).
Everything the site uses is on Credits and licences.

Private: this tool runs in your browser. Nothing you type, paste or choose leaves this page.

Saved you a few minutes? Say thanks with a coffee.

Something wrong with this tool, or missing from it? Report a bug or suggest a feature.

↑ ↓ move↵ openesc close