Novu Handbook
    📝

    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.

    Document Comments

    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.

    image

    Formatting Tips

    Headings

    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.

    Links

    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.

    Comments

    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.

    image

    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.

    image
    đź’ˇ
    When a comment is set for a highlighted text and you need to remove the highlighted text, the comment will be removed with it. We suggest that you instead strike out the text and add the replacement next to it just so that we can refer back to the comment.

    Inline Code and Code Blocks

    To add inline comments surround the word with backticks:

    The file `Product`.
    

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

    
    ```
    console.log("Hello");
    ```

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

    image

    Notion’s Secret Tool: Backslash

    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.

    image

    Logo

    The Open Source Notifications infrastructure For Developers

    GitHubXDiscord