# Markdown basics for readable notes

Write plain text with lightweight Markdown markers. Ouros styles supported markers in the same editable page while preserving the source in the saved `.md` file.

## Start with a short note

```markdown
# Project notes

This is a paragraph with **bold** and *italic* text.

## Next steps
- Review the draft.
- Confirm the date.

See [the project page](https://example.com).
```

Use a space after heading and list markers. A blank line separates paragraphs and makes the saved source easier to read. Headings from one to six `#` characters are supported; use one main heading and smaller headings for sections.

## Edit the source

The editor applies emphasis, heading, link, quote, list and code styling in place. Syntax markers can become quiet when you leave a line and reappear when editing it. Move the caret back to the line to inspect the actual markers.

Styling does not change the underlying text into a separate rich-text document. Save with Command S, reveal the file and open it in a plain-text editor to inspect the Markdown source.

## Keep it portable

Use simple headings, paragraphs and lists first. Other Markdown readers can render details differently. Do not assume that a table, embedded HTML or an extension supported by another app has special behaviour in Ouros.

Continue with [lists and checkboxes](/docs/markdown/lists-and-checkboxes) or [code and quotes](/docs/markdown/code-and-quotes).