Markdown Guide

OwnSpace uses Markdown as its note format. This guide covers the syntax and special features available in the editor.

Basic Formatting

# Heading 1
## Heading 2
### Heading 3

**bold text**
*italic text*
~~strikethrough~~

- bullet list
- another item

1. numbered list
2. second item

> blockquote

`inline code`

[ [insert link] ]

Links

Wiki Links

OwnSpace supports [ [wiki-links] ] to connect notes:

[ [file-name] ]           — link to another note
[ [file-name|display] ]   — link with custom display text

Clicking a wiki-link opens the target note. Backlinks are automatically tracked — you can see which notes link to the current one.

External Links

[Google](https://google.com)
<https://example.com>

Code Blocks

Use triple backticks for code blocks:

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

Tables

| Column 1 | Column 2 |
|----------|----------|
| Cell 1   | Cell 2   |
| Cell 3   | Cell 4   |

Images

OwnSpace supports inline images in your notes. To add an image:

  • Paste (Ctrl+V / Cmd+V) an image from your clipboard into the editor
  • Drag & drop an image file from your file manager

When you add an image, OwnSpace:

  1. Validates the file — supported formats: PNG, JPEG, GIF, WebP, SVG (max 10 MB)
  2. Computes a SHA-256 hash for automatic deduplication (duplicate images are not re-uploaded)
  3. Saves the file to attachments/ folder in your local storage
  4. Inserts a markdown link:
![](/attachments/img_a1b2c3d4.png)

You can also write the link manually using the same syntax.

Manage all attached images via the Attachments page (sidebar → Attachments). It shows each image's size, type, which notes reference it, and sync status. Orphaned images (not referenced by any note) are highlighted.

WYSIWYG Editor

Press Ctrl+E / Cmd+E to switch to the visual editor (TipTap). You can:

  • Use slash commands: type / to see available blocks
  • Drag blocks using the handle on the left
  • Format text with the floating toolbar

The WYSIWYG editor saves as Markdown — you can switch between modes freely.

Source Editor

Press Ctrl+Alt+E / Cmd+Alt+E to switch to the source (plain text) editor. This gives you full control over the raw Markdown content in a textarea.

  • Type Markdown syntax directly — all features from this guide apply
  • Wiki-links are written manually: <a href="/en/help/file-name">file-name</a> or <a href="/en/help/file-name">display</a>
  • Use Ctrl+Z / Cmd+Z for undo

You can switch between visual and source editors freely — the content stays in Markdown.