Writing Tips for Notion

This guide will show our writers how to navigate and use Notion to write and format their work. It will only focus on the aspects of Novu that apply to your writing, though be aware it is much more flexible.

Every Notion document has a section to add comments to before the content of the document. Generally speaking, this will be intentionally left blank. This might also hold any general comments for your article, if our editing team wishes to leave feedback. If you have any general comments of your own as well, you’re free to input them here.

In the article, you should use only 2 headings: Heading 2 and Heading 3.

If you’re familiar with Markdown syntax, you can easily add Heading 2 by entering ## on a new line and following it with a space. For Heading 3 use ###.

Otherwise, you can set headers with Notion’s slash feature, using /h2 and /h3 respectively.

You can easily add links to text by selecting the text you want to add the link to and pasting the link on your clipboard.

If you want to add your own comments to leave for the reviewers and editors, highlight the text you want to add a comment to and press the comment button.

Comments are one of the main reasons we use Notion with our writers. So, during the review and editing process you’ll be seeing a lot of comments on your article. When you fix the issue addressed in the comment, you can click on the resolve button.

To add inline comments surround the word with backticks:

To add code blocks, surround the code with 3 backticks:

For code blocks, you can choose the language of the code block (like Bash or JavaScript).

To get access to all formatting options and blocks, you can use Notion’s backslash system. Whenever you type a / in Notion, a drop-down menu will appear. You can navigate it with your mouse or continue typing to have Notion create the element you need.

For example, to upload an image, you can type /image and press enter and you’ll have an image block.