Files
Reactive-Resume/docs/guides/formatting-text.mdx
T
Amruth Pillai d46b4b5815 docs: rewrite the documentation for v6
Rewrite every guide for the redesigned app, add guides for new features (documents, editor modes, check, cover letters, assistant, applications, self-hosting upgrade and environment reference), remove v5-only pages with redirects, and replace every screenshot.
2026-09-30 05:07:06 +02:00

119 lines
6.1 KiB
Plaintext

---
title: "Formatting text"
description: "Use bold, italics, bulleted and numbered lists, and links in your summary and descriptions, clear old formatting, and improve a line with AI."
---
Your summary and every description field accept formatted text. Use it to make achievements scannable: a bulleted list under each job, a bold phrase where it matters, a link to a project. This page covers the formatting toolbar, Markdown shortcuts, links, and the **Improve** button.
## The formatting toolbar
Click into a summary or description and a toolbar appears under the text. It stays out of the way until the text has focus, and clicking its buttons doesn't move your cursor.
<Frame caption="The formatting toolbar under the summary">
<img
src="/images/guides/formatting-text/formatting-toolbar.webp"
alt="The formatting toolbar with Bold, Italic, Link, Bulleted list, Numbered list and Clear formatting buttons, an Improve button, and a character count underneath"
/>
</Frame>
| Button | What it does |
| --- | --- |
| **Bold** | Makes the selected text bold. |
| **Italic** | Makes the selected text italic. |
| **Link** | Adds, changes or removes a link on the selected text. |
| **Bulleted list** | Turns the current paragraph into a bulleted list, or back into a paragraph. |
| **Numbered list** | Turns the current paragraph into a numbered list, or back into a paragraph. |
| **Clear formatting** | Removes all formatting from the selected text, including lists and alignment. |
| **Improve** | Suggests a better version of the line your cursor is in. Needs an AI provider. See [Improving a line with AI](#improving-a-line-with-ai). |
A button is highlighted when its formatting applies where your cursor is. Under the toolbar, a footer shows a hint for the field and how many characters it holds.
### Keyboard and Markdown shortcuts
You can format without the toolbar:
| Type or press | Result |
| --- | --- |
| <kbd>⌘</kbd> <kbd>B</kbd> (<kbd>Ctrl</kbd> <kbd>B</kbd>) | Bold |
| <kbd>⌘</kbd> <kbd>I</kbd> (<kbd>Ctrl</kbd> <kbd>I</kbd>) | Italic |
| `- ` or `* ` at the start of a line | Starts a bulleted list |
| `1. ` at the start of a line | Starts a numbered list |
| `**text**` | Makes "text" bold |
| `*text*` | Makes "text" italic |
Press <kbd>Enter</kbd> for a new bullet, and <kbd>Enter</kbd> twice to end the list.
Inside a text field, <kbd>⌘</kbd> <kbd>Z</kbd> (<kbd>Ctrl</kbd> <kbd>Z</kbd>) undoes your typing in that field. Click outside the field to undo changes across the whole resume.
## Add a link
<Steps>
<Step title="Select the text">
Highlight the words you want to link, for example a project name.
</Step>
<Step title="Select Link">
The **Link address** dialog opens with `https://` filled in.
</Step>
<Step title="Enter the address and confirm">
Type or paste the full web address, then select **Confirm**. The text becomes a link on the page and in the PDF.
</Step>
</Steps>
<Frame caption="The Link address dialog">
<img
src="/images/guides/formatting-text/link-address-dialog.webp"
alt="The Link address dialog with an https:// field, the hint Leave it empty to remove the link, and Cancel and Confirm buttons"
/>
</Frame>
To change a link, put your cursor in it and select **Link** again. To remove it, clear the address (or leave only `https://`) and select **Confirm**.
Links don't open when you click them in the editor, so you can click into linked text to edit it.
## Formatting the toolbar doesn't offer
The toolbar keeps to formatting that reads well on a resume and survives applicant tracking systems. Text you import, or wrote in an older version of Reactive Resume, may carry other formatting, such as headings, colors, highlights, underlines or centered text. That formatting is kept and still prints.
To remove it, select the text and choose **Clear formatting**.
If a description contains a table, the editor keeps the table as it is and shows "Original table formatting is preserved. This content is read-only because it cannot be edited safely." You can still see it on the page, but you can't edit it in the text box.
## Improving a line with AI
**Improve** rewrites one line at a time: a single paragraph of your summary or a single bullet.
<Steps>
<Step title="Put your cursor in the line">
Click anywhere in the line you want to improve. **Improve** is unavailable until the cursor is in a line with text.
</Step>
<Step title="Select Improve and pick a change">
Choose **Stronger verb**, **Add a result** or **Make it shorter**, or select **Ask for something else…**, describe what should change, and select **Ask**.
</Step>
<Step title="Review the suggestion">
Select **Replace** to use it, or **Keep mine** to leave your line as it was. If the suggestion adds facts, it asks you to check they're accurate.
</Step>
</Steps>
Only that one line changes, and only when you select **Replace**. If you edit the line while the suggestion is loading, it isn't applied.
Improve needs an AI provider. If you haven't connected one, selecting **Improve** opens the assistant so you can set one up. See [Connecting an AI provider](/guides/using-ai).
## On a phone
On screens narrower than 768 pixels, such as phones and small tablets held upright, the toolbar docks to the bottom of the screen, just above the keyboard, with larger buttons. To close the keyboard, select **Done** at the right end of the toolbar, or tap outside the text box.
<Frame caption="The formatting toolbar docked above the keyboard on a phone">
<img
src="/images/guides/formatting-text/phone-formatting-toolbar.webp"
alt="A description being edited on a phone, with the formatting toolbar pinned to the bottom of the screen"
/>
</Frame>
See [Editing on a phone or tablet](/guides/editing-on-mobile) for the rest of the mobile editor.
## Related guides
- [Filling in your details](/guides/filling-in-your-details): the summary and your contact details.
- [Editing entries](/guides/editing-entries): descriptions for jobs, projects and other entries.
- [Using the assistant](/guides/using-the-assistant): larger rewrites and questions about your whole resume.