Frequently asked questions

What is Markdown?

Markdown is a simple way, using normal text characters, to add formatting to basic plain text files. It is a lightweight markup language with a simple syntax that does not get in the way of your text. Read more in What is Markdown?

What is a .md file?

A .md file is a plain text file written in Markdown. The .md extension, short for Markdown, tells editors and tools to treat the file as Markdown so they can show it with formatting. Because it is just text, it opens in any editor and works cleanly with version control. See how to open a .md file.

What is Markdown used for?

Markdown is commonly used for writing documentation. It also turns up in README files, notes, blog posts, static websites, wikis, chat messages, forum posts and academic writing. It is useful wherever you want the convenience of editing plain text but want to add just a little bit of formatting and structure to your documents.

Why use Markdown?

Because it is just text. It is readable before it is rendered, it works in any editor, and it diffs cleanly in version control. Your writing stays portable and future-proof, and the same simple syntax carries across README files, documentation, notes, static sites and chat alike, so you learn it once and write anywhere.

How do I use Markdown?

You can create a new text file with a .md extension and just start writing text using the simple Markdown format. There are many tools and apps that help you with editing and can show you a fully formatted version.

What can I add to Markdown files?

Beyond text, you can add tables, task lists, images and code, and with extensions you can drop in diagrams such as flowcharts and ER diagrams, along with math and charts. See the extensions for the full list.

How can I edit Markdown files?

Any text editor works, but a dedicated Markdown editor gives you a live preview as you type. We have a range of online editors, including a Markdown editor, a table editor and a diagram maker, or you can pick a desktop or mobile app.

How can I convert Markdown files?

Markdown converts cleanly to other formats. You can turn it into PDF, HTML or a Word (.docx) document, and convert the other way too. See all the converters.