Editor

← Back to Table of Contents

5. Editor: Visual & Raw

The heart of mrkdwn. Two modes, many helpers.

---

Switch Visual & Raw

Toggle via the editor menu:

• Visual — formatted live preview (WYSIWYG). Write and see the result instantly.
• Raw — the plain Markdown source. Full control over every character.

Both modes share the same content; switching is lossless.

---

Writing

• In Visual mode, Markdown patterns convert live: # → heading, - → list, > → quote, `code` etc.
• In Raw mode, you type Markdown directly.
• Auto-save keeps everything saved (see below).

---

Context Menu (Text Selection)

Select text to open the selection context menu: bold, italic, strikethrough, code, link and more — applied right to the selection.

---

Formatting

mrkdwn supports the full Markdown spectrum:

Element	Syntax
Heading	# H1 … ###### H6
Bold	**bold**
Italic	*italic* or _italic_
Strikethrough	~~gone~~
Inline code	`code`
Code block	```language … ```
List	- or 1.
Task list	- [ ] / - [x]
Quote	>
Table	| Column | Column |
Link	[Text](https://…)
Image	
Divider	---
Page break	Markdown keyboard (scissors icon) – print/PDF only
Footnote	[^1] … [^1]: Text

Table example:

| Task | Status |
|---|---|
| Docs | open |
| Sync | done |

Callouts

Highlighted info blocks (Note, Tip, Warning …):

> [!NOTE]
> This is a note.

> [!WARNING]
> Careful, important!

Available types and labels: Settings → Editor → Callouts.

Page break (print/PDF)

The scissors icon in the Markdown keyboard (5th row) inserts a page break. In the editor a slim placeholder appears (about one line tall); tapping it removes it again. In Markdown the break is stored as an invisible marker (<!-- pagebreak -->) — it stays ineffective in other Markdown tools. When printing and in the PDF export it forces a page break.

---

Keyboard

mrkdwn provides an enhanced Markdown keyboard with five rows: formatting, lists, headings, code, tables, links and footnotes, plus undo/redo. The 5th row contains [[ (wiki link), /date, /time and the scissors icon for the page break. On iPad there are additional keyboard shortcuts (e.g. for bold/italic/save).

---

Quick Bar

Above the keyboard sits the quick bar with the most common actions: heading, lists, code, quote, table, image, link and more — one tap each.

---

Slash Commands, Callouts & Wiki Links

Slash Commands

Type / in the editor:

Command	Effect
/date	Current date
/time	Current time
/cal	Calendar to pick a date

Date/time format: Settings → Editor → Slash Commands.

Wiki Links [[ … ]]

Quick linking between documents:

1. Type [[ — a list of all documents appears.
2. Each letter/number filters (case-insensitive).
3. Tap to insert [[Title]].
4. The link is colored; tapping opens the target document.

When “Hide images in list” is on, images do not appear in the suggestions.

---

OCR — Recognize Text from Images

Turn photos/images into Markdown — fully on-device, no cloud.

Start:

• New document: FAB (⊕) → Recognize Text (OCR).
• Into existing document: editor menu (…) → Recognize Text.
• Source: Take Photo or Choose from Photos.

Processing:

• Local recognition via Apple Vision.
• Optional AI enhancement via Apple Intelligence (Foundation Models) — toggle in the preview dialog (supported devices only).
• Output text formatted: On = headings/lists detected; Off = plain text.
• Multi-column (e.g. newspaper) is merged in reading order.
• Illegible regions are flagged, never guessed.

Camera permission status: Settings → Security & Diagnostics.

---

Encryption

• PDF password protection: set a password during PDF export. The PDF only opens with the password.
• Nextcloud AES encryption: files are encrypted before upload → see Sync → AES .

Keep passwords safe — without them there is no access.

---

Auto-save

Enabled by default. Configure under Settings → Editor:

• on/off, interval.
• Also saves when leaving the editor and when switching apps.

← Back · Next: Remote Server →