Notion is an innovative application that bills itself as an all-in-one knowledge management solution for individuals and teams. You could think of it as a note-taking app or a wiki, but those descriptions don’t really do it justice. You really have to try it to get a sense of what it’s capable of. Some organizations use Notion for project management and task tracking, among other things. The application can even function as a database of sorts.

Notion has desktop and mobile apps available, as well as a web-based interface. You create an account for yourself and your organization — the accounts are used to sync everything with Notion’s servers.

Notion Markdown application

Notion’s Markdown support is hit or miss. Copying and pasting Markdown-formatted text into Notion generally works the way you’d expect, but using Notion’s live editor to write using Markdown doesn’t always work. You can, for instance, use asterisks to make text bold, but trying to use brackets to create a link or pipes to create a table doesn’t work — which is strange considering that those syntax elements do work when you copy and paste them in. It’s also difficult to edit Markdown-formatted text that you’ve copied and pasted in Notion.

Notion Markdown Support

Notion provides support for the following Markdown elements.

Element Support Notes
Headings Yes
Paragraphs Yes
Line Breaks Yes When copying and pasting Markdown-formatted text, you can also use a trailing backslash or press the Return key once to achieve the same result. When typing in Notion, press Shift-Return.
Bold Yes
Italic Yes
Blockquotes Partial Nested blockquotes are not supported.
Ordered Lists Yes
Unordered Lists Yes
Code Yes
Horizontal Rules Yes
Links Partial Copying and pasting Markdown-formatted links works, but you can’t type them in Notion’s editor. Use the /link slash command instead (only works for internal links to other pages in Notion).
Images Partial Copying and pasting Markdown-formatted images works, but you can’t use that format in Notion’s editor. Use the /images slash command instead.
Tables Partial Copying and pasting Markdown-formatted tables works, but you can’t type them in Notion’s editor. Use the /table-inline slash command instead.
Fenced Code Blocks Yes
Syntax Highlighting Partial Must pick the programming language to highlight using the GUI.
Footnotes No
Heading IDs No
Definition Lists No
Strikethrough Partial Use only one tilde symbol before and after the phrase. Doesn’t work when copying and pasting Markdown-formatted text into Notion.
Task Lists Yes Copying and pasting Markdown-formatted task lists works. You can generate todo boxes with [] or use the /todo slash command instead.
Emoji (copy and paste) Yes
Emoji (shortcodes) Yes The second colon isn’t needed. Type : followed by the name of the emoji e.g. :fire
Highlight No
Subscript No
Superscript No
Automatic URL Linking Yes
Disabling Automatic URL Linking No
HTML No

See Also

Take your Markdown skills to the next level.

Learn Markdown in 60 pages. Designed for both novices and experts, The Markdown Guide book is a comprehensive reference that has everything you need to get started and master Markdown syntax.

Get the Book
Want to learn more Markdown?

Don't stop now! 🚀 Star the GitHub repository and then enter your email address below to receive new Markdown tutorials via email. No spam!