Where the toolbar is
The formatting toolbar sits in a fixed strip above the writing area, in three rows: text formatting, then headings and lists, then things you insert. It is always visible — you do not have to select text first. Put the cursor where you want the change, or select the words you want to format, and click the button. (New to the Brand → Knowledge menu? See what a brand is in Yaplet.)
Text formatting
- Bold — emphasise key terms or warning phrases.
- Italic — for titles of other articles, product names, or light emphasis.
- Underline and
strikethrough— use sparingly. - Highlight — draw attention to a critical note inside a paragraph.
- Subscript and superscript — for footnote markers and formulas.
- Text colour — a colour picker, and next to it a font-size dropdown running from 10 px to 32 px.
- Clear formatting — strips every mark off the selection, which is the quickest way to rescue text pasted in from somewhere else.
Headings and structure
Use headings to break long articles into scannable sections. The article's own title is already rendered as the page heading, so start your body sections at Heading 2 even though a Heading 1 button exists.
- Heading 2 — major sections (2–6 per article).
- Heading 3 — sub-sections within a Heading 2.
- Table of contents — the toolbar button drops a table of contents at the very top of the article. It fills itself in from your headings. Worth adding once an article has five or more Heading 2 sections.
Lists and alignment
- Bullet list — parallel items with no natural order (features, prerequisites, options).
- Numbered list — sequential steps where order matters.
- Task list — checklist items with tick boxes, useful for setup checklists.
Nest a list by pressing Tab at the start of a list item. The four alignment buttons — left, center, right, justify — apply to headings and paragraphs.
Tables
Click the table button to insert a three-by-three table with a header row. Put the cursor inside any cell and a second set of buttons appears in the same toolbar: add or delete a column, add or delete a row, turn the header row or header column on and off, and merge or split cells. Column widths can be dragged. Wide tables are safe — they are wrapped in a horizontal scroll area when the article is read on a narrow screen.
Code blocks
For multi-line snippets, use a code block (the code-block button in the toolbar). Code blocks render in a monospace font and keep all their whitespace. For a single short literal inside a sentence, use inline code instead.
Images
Click the image button and choose a file. PNG, JPEG and WebP are accepted — other formats, including GIF and SVG, are not. The file is uploaded and inserted at its own proportions. Drag the small handle at the bottom-right corner of an image to resize it. When a visitor clicks an image in the published article, the full-size file opens in a new browser tab. See Add images and screenshots for sizing and screenshot tips.
Links and links to your other articles
Select some text and click the link button to turn it into a link; the editor asks you for the address. For a link to another article in the same knowledge base, use the Cross Link button instead: it lists every other published article in this knowledge base, you pick one and give the link its text, and Yaplet inserts a permanent link that keeps working even if the article is later renamed or moved. Those are the same permanent links the Share button offers, and when a visitor clicks one inside the chat widget, the article opens right there in the widget.
Preview, Insert HTML and Import Word
Three more buttons sit at the right-hand end of the toolbar. Preview shows the article exactly as a visitor will see it. Insert HTML lets you paste raw HTML in. Import Word takes a .docx file and converts it into the article, re-hosting the images it contains — images in formats the editor cannot take are skipped, and it tells you how many.