Basics

Format text

Select text in Visual mode to make it bold, italic, struck through, or inline code. Use the link control to add or change a destination. A link’s text remains editable in the document.

Organize the document

Use headings for sections, bullet lists for related items, numbered lists for sequences, and quotes for quoted text. Horizontal rules and hard breaks are also preserved. Type / to find supported blocks, or edit the Markdown in Source.

## Before publishing

Review **important changes** and check [the guide](/docs/).

- Check the title
- Check the links

1. Save the draft
2. Review the diff

> Publication writes content to Git.

Check the saved format

Switch to Source to inspect the Markdown. The generic profile covers these basics without framework-specific components. Raw HTML and custom MDX expressions stay source-only when a profile cannot safely render them. For checkboxes, see Task List; for structured rows and columns, see Table; for diagrams, math, and references, see Mermaid, Math, and Footnotes.

Edit in Visual

Try the same Markdown in the editor with the Generic profile, then switch to Source to inspect the saved syntax.

markdown.md

Generic

VisualSource

Reset example

Loading editor…

An interactive example. Changes stay on this page.