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’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 BookWant 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!