---
title: Headings
slug: docs/CH1E-headings
docTags: 
createdAt: 2024-07-24T11:13:26.935Z
---

![](https://api.archbee.com/api/optimize/bNBm7nPJgXjbjLyfbHNh2/1K2W3i4w60YhVxCpsYQNW-20250918-122230.png)

Headings are essential building blocks for organizing and structuring your documentation. They help break down your content into clear sections and subsections, making it easy for readers to navigate and understand.

## Why to use headings?

- **Improve readability**
  Headings guide readers through your content, making it easier to follow the flow of information.
- **Enhance visual hierarchy**
  Different heading levels create a clear hierarchy, emphasizing important points.
- **Improve SEO**
  Search engines use headings to understand your content's structure, which can help with search rankings.

## How to add a heading

You have **four** ways to add a heading:

### WYSIWYG Menu

Highlighting the text and choosing the heading options from [WYSIWYG Menu](docId\:WBvFMF8cfYoJgkqNrJVIG)

![](https://api.archbee.com/api/optimize/bNBm7nPJgXjbjLyfbHNh2/wphnxf0xVg9tyKWTJ24Vm-20250918-120750.gif)

***

### Add Block Menu

Insert the heading from blocks menu. Type `/` and select the heading block

![](https://api.archbee.com/api/optimize/bNBm7nPJgXjbjLyfbHNh2/-s0dghVDQC-uzIKoQICUp-20250918-121306.gif)

***

### Markdown Shorcuts

Use markdown shortcuts to insert it:

- `#` + `space` for Heading 1
- `##` + `space` for Heading 2
- `###` + `space` for Heading 3
- Check the [Use Markdown shortcuts](docId:9aaCRqJMq9JnYvzSgNOfs) page for more markdown shortcuts

***

### Keyboard Shorcuts

Using keyboard shortcuts to toggle paragraphs into:

::::Tabs
:::Tab{title="On Mac"}
- **Heading 1:** `⌘ Command` + `⌥ Option` + `1` 
- **Heading 2:** `⌘ Command` + `⌥ Option` + `2`
- **Heading 3:** `⌘ Command` + `⌥ Option` + `3` 
- Check the [Editor Keyboard Shortcuts](docId\:XLeyegxM6wsarhL5e-Wgp) page for more keyboard shortcuts
:::

:::Tab{title="On Windows"}
- **Heading 1: **`Control` + `Shift` + `1` 
- **Heading 2:** `Control` + `Shift` + `2`
- **Heading 3: **`Control` + `Shift` + `3`
- Check the [Editor Keyboard Shortcuts](docId\:XLeyegxM6wsarhL5e-Wgp) page for more keyboard shortcuts
:::
::::

***

## Customizable Heading Links 

You can assign custom URLs (aliases) to any heading in Archbee, making it easier to share direct links to specific sections of a page.

Below is a clear, step‑by‑step guide:

### How to Set a Custom Heading Link

1. **Hover over the heading** you want to link to.
2. Click the** Anchor Link **bubble that appears.
3. In the popup, switch **Auto-generate** off if needed.
4. Enter your **custom alias** (URL-friendly text).
5. Press **Set**.

::Image[]{src="https://i.postimg.cc/CLpn5n7T/Screenshot-2026-03-02-at-17-06-52.png" size="60" width="1280" height="886" position="center" darkWidth="1280" darkHeight="886" showCaption="false"}

### Why Customize Heading Links?

- Create short, clean, human-readable URLs.
- Establish consistent naming conventions across your documentation.
- Improve navigation for users who need deep-link access.

:::hint{type="warning"}
Be careful when setting custom aliases for heading links. Duplicated aliases can lead to multiple headings or documents sharing the same URL, causing navigation conflicts.
:::

***

::::LinkArray{contentSource="CUSTOM"}
:::LinkArrayItem{headerType="IMAGE" headerImage="https://api.archbee.com/api/optimize/K_JWZranXy1tD6qvlG2v6-C1IcmVcG0rx4ZLHX6X7V7-20250911-192557.png"}
:FontAwesome[]{icon="fa-solid fa-cubes"}  ** Find other blocks**

Discover new ways and blocks to create stunning and functional documentation pages.

[Check out all blocks](docId:6B0VTQTVUnMP93e-SZQ2p) 
:::

:::LinkArrayItem{headerType="IMAGE" headerImage="https://api.archbee.com/api/optimize/K_JWZranXy1tD6qvlG2v6-YRyGGWKsNS1ZZJa5XJy0z-20250911-192608.png"}
:FontAwesome[]{icon="fa-solid fa-headset"}**  Need help?  ⬇️**

Use the **blue** **chat bubble **from bottom right corner.

Or try **AI Chat** (from search box) for quick answers.
:::

:::LinkArrayItem{headerType="IMAGE" headerImage="https://api.archbee.com/api/optimize/K_JWZranXy1tD6qvlG2v6-MS_ubDHlXgoktt4svD2rL-20250911-192619.png"}
:FontAwesome[]{icon="fa-solid fa-hand-holding-heart"}**   Your opinion matters**

Use the below feedback form, anonymously.

Or ask a question in **Q\&A section** and our team or AI will give you a solution.
:::
::::