# Rich Text Editing Zaphiri's rich text editor powers task descriptions, personal Notes, and Project Docs, so formatting works the same everywhere you write. > [!quote] Format without breaking flow > A good editor gets out of your way. Style text, drop in an image or fix a link without leaving the keyboard. --- ## Toolbar formatting Select any text in a task description, personal Note, or Project Doc and a compact formatting toolbar appears right above it, with the tools you use most in one row: - **Lists** - start a bulleted list, or choose Bulleted, Numbered, or Checklist from the list menu - **Text style** - switch between regular text, Heading 1 through Heading 4, a code block, or a quote - **Text color** - colour selected text from a curated palette - **Bold, italic, underline, and strikethrough** - **Inline code and links** - **Panels** - wrap text in an Info, Success, Warning, Error, or Note panel, and Zaphiri remembers the panel type you used last - **More** - highlight, tables, and anything that does not fit in the row ![[description-toolbar.png]] On narrower screens, the toolbar keeps the essentials in view and moves the rest into **More**, including your lists and headings, so everything stays within reach. Press **Escape** to close an open toolbar menu without leaving your task. When you select a longer passage in a task description, **Improve** appears at the start of the toolbar. See [[AI Writing Assistant]] for how it works. No markdown syntax is required. Select text and apply the style. --- ## Inline images Images become part of the content, not just an attachment list: - **Paste or drag** an image into any task description, personal Note, or Project Doc and it embeds inline, right where you dropped it - **Automatically saved as an attachment** - the image is preserved with the task, Note, or Project Doc even if you edit the surrounding text later - **Gallery viewer** - select any inline image to open the full gallery viewer for a closer look --- ## Hyperlinks Links carry over instead of getting lost: - **Preserved on paste** - copy rich text from a doc, webpage, or another app, and any hyperlinks in that text stay intact when you paste them into Zaphiri - **Hover popup** - hover over any link in a task description, personal Note, or Project Doc to see a small popup with three actions: - **Copy** - grab the link URL - **Edit** - change the destination - **Remove** - unlink the text, keeping the words but stripping the link --- ## List editing Bullet and numbered lists follow the shortcuts you'd expect: - **`Tab`** - indent a list item to create a sub-list - **`Shift+Tab`** - outdent a list item, stepping it back out until it exits the list entirely --- ## Tables If a task description, personal Note, or Project Doc contains a markdown table, you can rework its layout without touching markdown syntax: - **Row and column handles** - hover a row or column to reveal a drag handle - **Drag to reorder** - drag the handle to move that row or column to a new position --- ## Code blocks Code blocks get real syntax highlighting instead of a plain grey box: - **Language auto-detection** - start typing or pasting code and the block detects the language, shown in a dropdown you can override manually - **Wide language support** - includes Go, Svelte, and ColdFusion alongside the common web languages - **Line numbers** - on by default, toggle them off per block from the toolbar - **Wrap toggle** - wrap long lines instead of scrolling horizontally - **Copy button** - grab the block's contents in one click - **Light and dark theme** - highlighting adapts to whichever theme you're using - **Stable editing layout** - the block toolbar floats over the editor instead of pushing the following paragraph down > [!tip] Type your way in > Type three backticks to start a code block, same as [[Use Markdown|markdown shortcuts]] elsewhere in the editor. ## Selecting text Temporary text selection uses an explicit high-contrast background and white text across light, dark, and mixed themes. The treatment applies to paragraphs, inline code, and code blocks, so the range selected for copying stays easy to recognise across supported browsers. ![[rich-text-selection.png]] This temporary browser selection is separate from persistent text highlighting applied through the editor toolbar. --- ## Callouts Callouts are panels that hold real content, not just a one-line label: - **Five named types** - Info, Note, Success, Warning, and Error, each with its own icon, switchable from a floating toolbar - **Custom panels** - pick any emoji as the icon (or remove it entirely) and any background colour from a swatch grid - **Full block content** - paragraphs, lists, and headings all fit inside a panel, so longer content stays readable instead of getting cramped into a single line - **Floating controls** - the callout toolbar appears over the editor without shifting the content below it --- ## Where rich text editing works - **Personal task descriptions** - **Personal notes** - **Team tasks and Project Docs** The same toolbar, images, links and list behaviour apply everywhere you write in Zaphiri. --- **Next:** Pair toolbar formatting with markdown shortcuts in [[Use Markdown]].