<aside> <img src="/icons/info-alternate_yellow.svg" alt="/icons/info-alternate_yellow.svg" width="40px" /> This page is part of The Toolbox by Danny Smith.

</aside>

This builds on the general advice in Writing Good Evergreen Documents with some specific tips for formatting documents in Notion.

Headings & Frontmatter

Using Headers well helps readers to understand the structure of your document. Frontmatter is the stuff at the beginning of your document that helps readers understand it's purpose and how to use it.

Headings

• Use H2 as your default top-level heading. Only use H1 when you need more than two levels in your hierarchy.
• Use a divider to underline every heading.
• Default to
  • Pink for top-level (usually H2)
  • Purple for second level (usually H3)
• Avoid bold text as a psuedo-heading.
• Use sentence case in your headings.
• Always put emoji at the end of a heading, preceded by a space (unless it's a number emoji - see video).

Frontmatter

• Use callouts and TOCs to add useful front matter to your documents.
• Set an emoji and header image for long-lived documents.

Heading and Front matter conventions

Heading and Front matter conventions

Emojis

Emojis are super-powerful tools for communication. Use them a lot, but always with intention...

➡️ Don't litter your document 🎉 with 👏 random 🎯 emoji 🔥🎆. It makes reading hard.

In general, if an emoji doesn't convey some meaning or help with reader comprehension, it probably shouldn't be there. Examples of good Emoji-fu...

• Emoji in headings help with reader comprehension because they act as visual anchors. Chosen well they also give a visual indication of what the section is about. They make documents easier to scan.

• Emoji can convey emotion without the need to write lots of words.

  Eg. "Please take the time to do this now 🙏"

• Emoji can act as visual cues in the text, but you need to have some convention which you explain to the reader.

  Eg. "Stop and make a note whenever you see this (🛑) in the text"

Linking