Skip to content
Tutorials Center
My learning

Topics

Lesson 5 of 36 ยท Pages and Blocks

Block Types and Text Formatting

Tour the basic Notion blocks (text, headings, quotes, code, dividers), format text with bold, links and colors, and convert one block type into another.

Everything on a Notion page is a block, and a small set of basic blocks covers most writing. This lesson tours them, shows how to style text inside them and explains how to convert between types without retyping. Once you are comfortable here, the structural blocks in the next lessons feel natural.

The basic blocks

  • Text: a plain paragraph, the default block.
  • Heading 1, 2, 3: three levels of titles. Heading 1 is largest.
  • Quote: indented text with a vertical bar, for citations and pull quotes.
  • Divider: a thin horizontal line to separate sections.
  • Code: monospace text with a language selector (JavaScript, Python, SQL, and many more) and optional wrapping and a copy button.
  • Equation: block or inline math written in KaTeX syntax, for example E = mc^2.

Create any of them with / and the block's name, or with the Markdown markers from the previous lesson.

Basic blocks at a glance

Text The everyday paragraph.
Headings Three levels of structure.
Quote Set citations apart.
Code Pick a language, keep spacing.
1 / 2

Formatting selected text

Select some text and a small toolbar appears above it. It offers:

  • Turn into (change the block type) and Link.
  • Comment (discuss the selection).
  • Bold, italic, underline, strikethrough, inline code, equation.
  • Color: a palette of text colors and background highlights.
  • Ask AI, if your plan includes Notion AI.

Keyboard shortcuts for the common styles are Ctrl+B, Ctrl+I, Ctrl+U, Ctrl+Shift+S and Ctrl+E (inline code). Pasting a URL over selected text turns the selection into a link.

Colors

Colors help scanning, not decoration. A sensible pattern: use a background color for one or two key phrases per page, and a text color for status words such as red for blocked. Avoid coloring whole paragraphs; the page becomes noisy and loses meaning. Remember too that color alone is not accessible; pair it with a word or icon.

Turn into

Click the drag handle of any block and choose Turn into to convert it. A paragraph becomes a heading; a bullet becomes a to-do; a toggle becomes plain text. Content is kept, and children are generally kept too (except where a type cannot hold them). This is the correct fix when you typed a thought as plain text and later realise it is a task.

Code blocks in practice

A code block has a language menu at the top left. Choosing a language enables syntax highlighting. Use it for commands, configuration, snippets and even small data samples. Inside a code block, Enter makes a new line within the same block; press Shift+Enter/arrow out or click below to leave it.

JavaScript
function greet(name) {
  return "Hello, " + name;
}

Because Notion cannot run code, this is read-only illustration. The block is for storing and sharing code, not executing it.

Modelling formatting as data

Rich text in Notion is stored as pieces of text with annotations such as bold or color. This stand-in parses a tiny Markdown subset into such pieces to show the idea. It is not Notion's real parser.

JS Rich text as annotated pieces (stand-in)

Press Run (or Ctrl + Enter) to see the console output here.

No output.

JS Turn into: change a block type (stand-in)

Press Run (or Ctrl + Enter) to see the console output here.

No output.

The key point: the text survives the conversion because the block's content and its type are separate.

Common mistakes

  1. Using Heading 1 for body emphasis. Reserve headings for structure; they power the table of contents.
  2. Skipping heading levels (a Heading 3 straight after a title) makes outlines confusing.
  3. Overusing color until nothing stands out.

Check your understanding

Quick check ยท 4 questions

of 4 answered You scored / 4 ยท perfect!

  1. 1. Which action converts a paragraph into a to-do without retyping?

    Turn into changes the block type and keeps the content.
  2. 2. What is the shortcut for inline code on selected text?

    Ctrl+E (Cmd+E on Mac) formats the selection as inline code.
  3. 3. What does pasting a URL over selected text do?

    Notion links the selected text to the pasted URL.
  4. 4. Can a Notion code block run the code?

    Code blocks are for display and sharing; they do not execute.

Summary

  • Basic blocks: text, headings, quote, divider, code and equation.
  • The selection toolbar formats text, links it, comments and colors it.
  • Turn into changes a block's type without losing content.
  • Use headings for structure and color sparingly.

Next: Lists, Toggles and Callouts