Help

Urth keeps notes as plain text files, written in Markdown, in a folder in your iCloud Drive (or one you choose). The Mac and iPhone apps show the same folder. This page is the whole manual.

Writing

Type Markdown and Urth styles it as you go, keeping the marks visible but quiet. The first line is the note's title, and the file is named after it.

Tables are edited as tables: tap or click one. Tidy Up (the sparkle icon) straightens lists, numbering, blank lines and quotes. Smart quotes and dashes are on unless you turn them off.

Finding things

• Search or create. One box at the top: type to search every note; press Return to open the note with that exact name, or create it.
• Tags. #tag anywhere. Type # in the search box to browse them. is:untagged finds notes without one.
• Links and backlinks. [[Note name]] links to a note (type [[ for suggestions). Backlinks lists every note that mentions this one.
• Find & Contents (in the ⋯ menu): the note's headings, and find within it.
• Tasks. Search "[ ]" for every unchecked box.

Daily notes

Today opens today's note, making it if needed, with your weather and the day's events if you've turned those on, and the notes you edited today listed at the end.

• Daily tasks and habits (Settings → Daily Notes) appear in each new day. Once the day is over, the ones left unchecked become plain list items, so the day keeps a record without piling up.
• Move a task to another day. On any unfinished task: right-click it (Mac) or select a word in it (iPhone), then Move to Tomorrow or Move to Date…. It waits, and goes into that day's note when the note is made, with a link back to where it came from. Settings → Daily Notes → Waiting shows what's waiting; you can reschedule or put a task back.
• Previous and next day, and a calendar, from the ⋯ menu or ⌥⌘[ ⌥⌘].

Looking at a note

• Preview: the note as a finished page, in your theme, in SF Pro or New York. Boxes check off and links work. ⌥⌘P.
• Arrange: the note as cards, to drag into a new order. A heading brings its section.
• History: slide back through a note's earlier versions and restore one. Versions are kept for a month.
• Images: paste or drop one in (Mac), or pick one from the formatting bar (iPhone). The file is saved beside the note in an Attachments folder.

Sharing

• Share Urth Link. The whole note is shared inside an encoded link. Someone with Urth sees the note, ready to add. Anyone else sees the note on this site, in your theme. Your data stays private: the note is within the link, stored after a # and rendered by your web browser. Your note never reaches our site. Notes up to about 20,000 words fit.
• Share a bundle of notes. If your note links to others, you can choose to bundle them in the same share link.
• Send it back. On the shared page, Edit lets the reader change the note; Save makes a new link for them to send you. Open it in Urth and it shows what changed next to your copy, with Replace Mine, Combine or Add as Copy. Collaboration by passing links, no accounts.
• Themes. Make your own from five colors (Settings → Themes) and share it with a simple link. Your chosen theme also travels with the notes you share. The themes page gives some options and lets you create your own theme.
• Present. View a note as slides. The title slide comes first, then one for each heading in your note. iPhone: ⋯ → Share & Export → Present; Mac: View → Present (⌥⌘↩). Arrows, space, a tap or a swipe move; Esc, ✕ or a swipe down leave.
• Export as PDF or HTML, copy as rich text. Or just open the file with another app — it’s plain text.
• From other apps. Share a page from Safari and Urth saves it as a clean note. From any browser on the Mac, use the bookmarklet.

Quick Capture, Siri and Shortcuts

• Mac: ⌃⌥⌘N from anywhere opens a Quick Capture box. What you type goes into today’s note.
• iPhone: press and hold the icon for Quick Capture, Today’s Note and New Note. Or add the Quick Capture widget.
• Siri: “Quick capture in Urth”, “Add to today in Urth”, “Open today in Urth”, “Open Groceries in Urth”, “Create a note in Urth”.
• Shortcuts app: offers the same actions, plus Append to Note, Find Notes, Get Note Text, Get Link to Note (the Share Urth Link link, for automations) and Archive Done Tasks.

Keyboard

On the Mac, Help → Cheatsheet (⇧⌘/) lists everything. On iPhone, Settings → Markdown & Shortcuts. The most used:

With a keyboard on an iPad or iPhone, the same shortcuts work.

Your files

Notes are .txt (or .md) files in your notes folder. Urth’s workings live in a hidden .urth subfolder: deleted notes (kept 30 days), history, pins, themes and settings. Move the folder, back it up, open it in another app: it’s all just files.

On this site

Two small tools, no account and no upload — everything stays in your browser: Write (Markdown styled as you type, or a dropped file; a link that holds the text, slides, a PDF) and Themes (Urth's themes, a few more, and a maker).

Support

Questions, problems or ideas: send them through the contact form.