# Notion building blocks

This page contains the building blocks (patterns) that can be used to create guideline pages which can then be translated into pages for the Telescope website.

Tabs: [Building blocks](/content/notion-guidelines.building-blocks.md) · [Template](/content/notion-guidelines.template.md) · [Guidelines](/content/notion-guidelines.guidelines.md)

## You can use headings of level 2

### You can also use headings of level 3

Text styling such as **bold**, *italic and* *underlined* will translate just fine into our website. It’s furthermore possible to have [a link to an external webpage](http://example.com/) and also to have [a link to another notion page](/content/notion-guidelines.template) (in this example, just another section on the page itself). If these are links to other content guideline pages, they will be transformed to a website link, pretty neat, right?

- Bullet lists
- Also work

1. And the same goes for
2. Ordered lists

## Do’s and don’ts

Provide specific, actionable instructions that team members can follow. Avoid vague language and ensure that each guideline gives clear direction on what to do or not do. Ideally, provide context and explain *why* we have this guideline.

> Note! That the images will need to have a ✅ or ❌ icons to indicate if the are a do or don’t. You can have any number of do and don’t examples (e.g. 2 do’s, 1 don’t, 1 do and two don’ts)

**Do:**

**Don't:**

### You can create columns like these

And put any content you want here.

- For instance
- A bullet list

### But! Stick with two if you can…

We don’t have that much horizontal space on the website, so try not to go overboard.

| **Tables work** | **As you would** | **Expect** |
| --------------- | ---------------- | ---------- |
| You             | Can              | Have       |
| Any             | Number           | Of         |
| Rows            | You’d            | Like       |

Toggles *can* be used as well if you need to hide some secondary content, but…

Why would you want to hide information really?

> Callouts work, but styling is controlled by the website (any emoji or icon will be replaced with a Telescope “i” icon and we only support grey “info” callouts for now).

***

A divider like the one above ☝️ can also be used, no problem!

Captions below images will also be shown on the website!

## Internal links

In Notion, it's possible to link to another section (or "block") within a page. For instance, we might want to link to [the Do’s and Don’ts heading](/content/notion-guidelines.building-blocks#1b653cae7a6680d4ab2ae5ff9c033877) on this page. We support linking to headings on the page, but not to other kinds of blocks (paragraphs, images, or similar) as this is uncommon.

## Not supported

- **Heading 1**: Technically, this works. But there should be exactly *one* `h1` tag on a webpage
- **Databases:** These will require manual setup. Consider a regular table first.
- **Quotes:** Well, you can add them, but they will be rendered same as a callout.
- **Todo lists:** Why would you?