> ## Documentation Index
> Fetch the complete documentation index at: https://docs.blocapps.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Using the Bloc Block Editor: Blocks, Formatting, and More
> Learn every block type, slash command, and formatting option in Bloc's block editor — headings, lists, tables, code blocks, images, and inline styles.
Bloc's editor is a powerful block-based writing tool. Every piece of content you write — a paragraph, a heading, a table, a checklist — lives as its own independent block. You can mix and match block types freely within a single note, reorder them by dragging, and format inline text with a floating toolbar that appears whenever you select text. Whether you're writing a quick thought or a structured document, the editor adapts to your needs.
## Slash commands
Slash commands are the quickest way to insert any block type. Place your cursor on an empty line — or anywhere in the body — and type `/` to open the block picker. Start typing to filter the list, then press **Enter** or click an item to insert the block.
On mobile, tap the **+** button in the mini toolbar at the bottom of the screen instead of typing `/`. It opens the same block picker as a sheet from the bottom of the screen.
| Block | Slash command | Description |
| --------- | -------------------------------- | ----------------------------------- |
| Paragraph | `/paragraph`, `/text`, `/p` | Plain text — the default block type |
| Heading 1 | `/h1`, `/heading 1`, `/title` | Big section title |
| Heading 2 | `/h2`, `/heading 2`, `/subtitle` | Medium section title |
| Heading 3 | `/h3`, `/heading 3` | Small section title |
| Quote | `/quote`, `/blockquote` | Blockquote callout |
| Block | Slash command | Description |
| ------------ | ------------------------------ | ------------------------------------- |
| Bullet List | `/bullet`, `/ul`, `/list` | Unordered bulleted list |
| Ordered List | `/ordered`, `/ol`, `/numbered` | Numbered list |
| Todo list | `/task`, `/todo`, `/checkbox` | Checklist with interactive tick boxes |
| Block | Slash command | Description |
| ------- | -------------------------------------- | ---------------------------------------- |
| Image | `/image`, `/file`, `/upload`, `/media` | Upload an image or file from your device |
| Divider | `/divider`, `/hr`, `/line` | Horizontal rule to separate sections |
| Block | Slash command | Description |
| ---------- | ------------------------------ | ---------------------------------------------- |
| Code Block | `/code`, `/pre`, `/code block` | Syntax-highlighted code with language selector |
| Block | Slash command | Description |
| ------- | ----------------------------- | --------------------------------------------------------------- |
| Table | `/table`, `/grid` | Resizable table, starts as 2 rows × 3 columns with a header row |
| Callout | `/callout`, `/info`, `/alert` | Highlighted info block to draw attention |
Code blocks support syntax highlighting for over 20 languages including JavaScript, TypeScript, Python, Rust, Go, Java, C, C++, SQL, HTML, CSS, JSON, YAML, Markdown, Bash, Shell, PHP, Diff, HTTP, INI, Makefile, XML, and Plaintext. Choose the language from the dropdown in the top-right corner of the block.
## Inline formatting
Select any text in the editor to reveal the **bubble menu** — a floating toolbar that appears just above your selection. Every formatting option is a single click away.
**Bold** (Ctrl/Cmd+B), *Italic* (Ctrl/Cmd+I), Underline (Ctrl/Cmd+U), and Strikethrough (Ctrl/Cmd+Shift+X) apply standard emphasis to your text.
Wrap a word or phrase in `monospace` style with the **Inline Code** button. Useful for variable names, file paths, or short commands.
Choose from 10 text colors including Red, Orange, Amber, Green, Teal, Blue, Violet, Purple, Pink, and Slate — or reset to the default foreground color.
Apply a background highlight in Yellow, Green, Blue, Pink, Red, Orange, or Purple. Click **No highlight** to remove it.
Raise text as a **superscript** (Ctrl/Cmd+.) or lower it as a **subscript** (Ctrl/Cmd+,). The two are mutually exclusive — applying one removes the other.
Click the **Link** button to open the link dialog. You can link to any external URL or to another note in your Bloc workspace by searching by title.
### Turn into
The **Turn into** button in the bubble menu (shown as the current block's icon with a chevron) lets you change the type of the selected block without retyping its content. For example, turn a Paragraph into a Heading 2, or convert a Bullet List into a Checklist. Supported conversions include:
* Paragraph, Heading 1, Heading 2, Heading 3
* Bullet List, Ordered List, Checklist
* Quote (blockquote)
* Code Block
## Drag and reorder
On desktop, every block has a **drag handle** — a six-dot grid icon that appears to the left of the block when you hover over it. Click and hold the handle, then drag the block up or down to reorder it within the note.
The drag handle is only available on desktop. On mobile, use the block action menu (long-press a block) to cut, copy, or move blocks.
## Pasting images
Paste an image directly from your clipboard into the editor body — Bloc detects the image, uploads it to cloud storage automatically, and inserts it as an Image block at the cursor position. You do not need to use the slash command for images you already have on your clipboard.
If you paste an image while offline, Bloc inserts a text placeholder (`📷 filename (image pending upload — reconnect to add)`) so your note content is not lost. The image will **not** upload automatically when you reconnect — paste it again once you are back online.