Explore
Basics
The core syntax: everything you need to write a complete document with nothing but your keyboard.
- How it works
- Headings
- Formatting
- Lists
- Images
- Links
- Code
- Quotes
- HTML markup
- Cheat sheet
- Compatibility
Tools
Our own in-browser tools: editors, converters and diagram makers, with nothing to install.
Open the tools →Extensions
Beyond the core: flavours and plugins that add tables, task lists, footnotes, diagrams, math and more.
- GitHub Flavored Markdown
- Tables
- Task lists
- Diagrams & charts
- Math & formulas
- Footnotes & callouts
- Front matter
- Table of contents
- More extensions
Apps
A directory of editors, converters and apps for writing and managing Markdown on every platform.
Open the directory →Developers
Markdown parsing and rendering libraries for building Markdown into your own software, grouped by language.
Browse libraries →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.
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.
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.