Markdown Syntax Guide

Everything you can write in OghmaNotes. Write in one clean surface: Markdown stays editable where you are typing and renders into readable blocks around it.


Headings

# Heading 1 ## Heading 2 ### Heading 3 #### Heading 4 ##### Heading 5 ###### Heading 6

Text Formatting

SyntaxResult
**bold**bold
*italic*italic
~~strikethrough~~strikethrough
**_bold italic_**bold italic
`inline code`inline code

Links & Images

[Link text](https://example.com) [Link with title](https://example.com "Title") ![Alt text](https://example.com/image.png) ![Alt text](https://example.com/image.png "Image title")

Lists

Unordered

- Item one - Item two - Nested item - Item three * Also works with asterisks + And plus signs
  • Item one
  • Item two
    • Nested item
  • Item three

Ordered

1. First item 2. Second item 3. Third item 1. Nested numbered
  1. First item
  2. Second item
  3. Third item
    1. Nested numbered

Task Lists

- [ ] Unchecked task - [x] Completed task - [ ] Another task
  • Unchecked task
  • Completed task
  • Another task

Blockquotes

> Single level quote > Nested quotes >> Second level >>> Third level
Single level quote
Nested quotes
Second level
Third level

Code

Inline

Use backticks for inline code.

Fenced Code Blocks

```javascript function hello() { console.log("Hello, world!"); } ```function hello() { console.log("Hello, world!"); }

Supported languages: javascript, typescript, python, rust, go, java, c, cpp, html, css, json, yaml, bash, sql, markdown, and more.

Mermaid (code fence)

Mermaid fences render as diagrams while preserving editable Markdown source.

```mermaid graph TD A[Upload] --> B[Extract] B --> C[Embed] ```graph TD A[Upload] --> B[Extract] B --> C[Embed]

Tables

| Header 1 | Header 2 | Header 3 | |----------|----------|----------| | Cell 1 | Cell 2 | Cell 3 | | Cell 4 | Cell 5 | Cell 6 |
Header 1Header 2Header 3
Cell 1Cell 2Cell 3
Cell 4Cell 5Cell 6

Alignment

| Left | Center | Right | |:-----|:------:|------:| | L | C | R |
LeftCenterRight
LCR

Horizontal Rules

Any of these create a horizontal line:

--- *** ___

HTML (Inline)

Raw HTML is supported inline:

<details> <summary>Click to expand</summary> Hidden content here. </details> <kbd>Ctrl</kbd> + <kbd>S</kbd> to save <mark>Highlighted text</mark> Text with <sup>superscript</sup> and <sub>subscript</sub>

Ctrl + S to save

Highlighted text

Text with superscript and subscript


Escaping

Use backslash to escape markdown characters:

\*not italic\* \# not a heading \[not a link\]

*not italic*


Editor Shortcuts

ActionShortcut
SaveCtrl+S / Cmd+S
IndentTab (inserts 2 spaces)
New line with list continuationEnter on a list item
End listEnter on empty list item

Newline Behavior

The editor automatically continues:

  • Unordered lists (-, *, +)
  • Ordered lists (1., 2., etc. auto-increments)
  • Task lists (- [ ] continues unchecked)
  • Blockquotes (>)

Press Enter on an empty list item to exit the list.


File Tree Status Colors

Like git status in your IDE:

  • Amber (M) - Modified locally, not yet saved to cloud
  • Green (U) - Newly created, not yet synced
  • Default - Synced with S3 storage.