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
# 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 or code and quotes.