Format guide
Markdown
Markdown
Markdown is plain text with simple punctuation conventions for formatting, # for headings, * for lists, ** for bold, links as [text](url). Created by John Gruber in 2004 and now the default for GitHub READMEs, documentation sites, and modern note-taking apps (Obsidian, Notion-export, Bear).
How to open a Markdown file
Any text editor (raw). Rendered: GitHub, GitLab, VS Code preview, Obsidian, Bear, Notion (importable), Typora, MarkText, Markdown Editor.
Primary use
Documentation, READMEs, notes, blog posts.
Convert other formats to Markdown
Looking for something else? Browse the full list of 192 converters.