---
title: "Writing in the Markdown editor"
description: "Write in Markdown, add blocks from the slash menu, move and copy blocks, draw diagrams, and find and replace text."
canonical: "https://www.sfora.ai/docs/write/editor"
---
# Writing in the Markdown editor

> Write in Markdown, add blocks from the slash menu, move and copy blocks, draw diagrams, and find and replace text.

Source: https://www.sfora.ai/docs/write/editor

The **editor** is where you write a doc, a post or a comment. What you type is Markdown: you can type the Markdown marks yourself, or use the menus and keys, and sfora keeps the text as plain Markdown either way.

Figure: A doc as Markdown draws it: a heading, a paragraph and a list.
- A heading. Type ## and a space at the start of a line.
- A list. Type - and a space at the start of a line.

## Type Markdown

Type these at the start of a line, then a space:

| Type | You get |
|---|---|
| `#`, `##`, `###` | A heading, from the largest down |
| `-` or `*` | A bulleted list |
| `1.` | A numbered list |
| `[ ]` | A to-do item; `[x]` for a done one |
| `>` | A quote |

Type ` ``` ` to start a code block, and `---` for a divider. Within a line, wrap text in `**two stars**` for bold, `*one star*` for italic, and `` `backticks` `` for code.

To format text you've already written, select it. A toolbar appears with **Bold**, **Italic**, **Strikethrough**, **Inline code** and **Link**.

## Add a block from the slash menu

1. Type `/`. In an empty doc, the body says "Type '/' for commands".
2. Keep typing to narrow the list, for example `/tab` for **Table**.
3. Press `enter` to insert the block.

The menu offers:

- **Text:** **Heading**, **Heading 2**, **Heading 3**.
- **Structure:** **Bulleted list**, **Numbered list**, **Todo list**, **Code block**, **Quote**, **Callout**, **Table**, **Divider**.
- **Rich blocks:** **Diagram**, **Status timeline**, **Board**, **Conversation**, **Data sheet**, **Map**.
- **Templates:** **Standup**, **Summary**, **Release notes**, **Shipped**, **Question**.

The slash menu doesn't open inside a code block.

## Move, copy and change a block

Point at a block. A handle (**⋮⋮**) appears at its left. Drag it to move the block, or click it for a menu:

- **Turn into** changes the block's kind, for example a paragraph into a heading or a list.
- **Duplicate** adds a copy below it.
- **Move up** and **Move down** move it past its neighbour.
- **Copy as Markdown** puts the block's Markdown on your clipboard, ready to paste anywhere.
- **Delete** removes it.

Each has a key, so you don't need the menu; see the table below. The keys act on the block the cursor is in.

A comment has no block handle, and `mod+D` and `mod+shift+C` don't apply there.

## Draw a diagram

A diagram is a code block in the Mermaid language, which sfora draws as a picture.

1. Type `/diagram` and press `enter`. Or start a code block with ` ```mermaid `.
2. Write the diagram, for example `graph LR` and then `Plan --> Build`.
3. In the block's header, click **Rendered** to see the picture, or **Markdown** to edit its text.

**Status timeline**, **Board**, **Conversation**, **Data sheet** and **Map** work the same way: each is a code block that sfora draws, with the same **Rendered** and **Markdown** switch. **Copy** in the header copies the block's text.

## Find and replace

In a doc's edit view, press `mod+F`. Type in **Find in document…**; the bar counts the matches. Press `enter` for the next match and `shift+enter` for the previous one. **Aa** matches case, and **ab** matches whole words only.

To replace, press `mod+alt+F` with the bar open, or click **Show replace**. Type in **Replace with…**, then press `enter` to replace one match, or `shift+enter` or **Replace all** to replace every match. Press `esc` to close the bar.

## Keyboard shortcuts

| Key | What it does |
|---|---|
| `mod+B` / `mod+I` | Bold / italic |
| `mod+E` | Inline code |
| `mod+K` | With text selected: add a link |
| `mod+alt+up` / `mod+alt+down` | Move the block up or down (`mod+shift+up` / `mod+shift+down` also work) |
| `mod+D` | Duplicate the block |
| `mod+shift+C` | Copy the block as Markdown |
| `tab` / `shift+tab` | In a list: indent or outdent the item |
| `/` | Open the slash menu |
| `mod+F` | In a doc: find |
| `mod+alt+F` | In a doc, with find open: replace |

On a phone: Works the same on a phone, apart from the keyboard shortcuts.

## Troubleshooting

### Mod+F does nothing

Find works in a doc's edit view. Switch the doc to edit (see [Docs](https://www.sfora.ai/docs/write/docs)), click into the text, and press `mod+F` again.

### The slash menu doesn't open

The cursor is inside a code block, where `/` types a slash. Move the cursor to a line below the block and type it there.

### A diagram shows as text

The block is set to **Markdown**. Click **Rendered** in its header. If it still doesn't draw, check the diagram's text for a typo.

Related: https://www.sfora.ai/docs/write/docs, https://www.sfora.ai/docs/write/links, https://www.sfora.ai/docs/write/posts
