features · v1.0.0

Every character does exactly one thing.

Twenty prefix characters. Pair them with keyboard shortcuts and a dozen small quality-of-life features, and you get Mudlark.

01 / basics

The eight you’ll use every day.

Heading

section

Creates a section heading. Everything below it groups under that heading on the right.

# Project Notes→Project Notes

Task

todo item

Adds an unchecked task. Tasks float to the top of their section on the right.

+ Buy groceries→☐ Buy groceries

−

Done

action

Checks off a task by fuzzy-matching its name. Also removes questions, highlights, and sections.

- buy gr→☑ Buy groceries

Highlight

emphasis

Marks a line as important. Rendered bold and prominent on the right.

! Demo is at 3pm→Demo is at 3pm

Question

open loop

Flags a line as a question. Rendered in italics on the right so open questions stay visible.

? Should we move the deadline?→Should we move the deadline?

Quote

block

Wraps a line in a styled blockquote with a left border.

" The best way to predict the future is to invent it→“The best way to predict the future is to invent it”

Bullet

list item

Creates a bullet point. Multiple bullets form a list under the nearest heading.

* Bring the good coffee→• Bring the good coffee

Image

media

Embeds an image or video from a file path, URL, or dropped file.

@ photo.jpg→[image: photo.jpg]

02 / advanced

Twelve more for power moves.

Numbered

ordered list

Creates a numbered list item. Auto-numbered on the right side.

% First step→1. First step

Code

syntax-highlighted

Starts a code line with syntax highlighting. Add a language hint for coloring (e.g. `swift or `c# Title `).

`js console.log("hello")→console.log("hello")

Math

inline eval

Evaluates a math expression inline. Unit-aware arithmetic across lengths, weights, times, and currencies (fiat and crypto). Variables and constants (pi, e) included.

= 100 USD to EUR→92.40 EUR

Timer

countdown

Starts a countdown timer. Notifies when done. Supports multi-phase timers (e.g. 5m work, 5m rest).

: 25m→25:00 ▶

;

Loop Timer

looping

Starts a looping timer that restarts automatically when it finishes.

; 5m→5:00 ↻

Table

row

Creates a table row. Use | to separate columns. First row becomes the header.

& Name | Role | Status→Name | Role | Status

Move

relocate

Moves a task or section here by fuzzy-matching. Use a pipe to send to a specific section (e.g. > +fix | Home).

> +fix bug→[moved: fix bug]

Write-to

write-to

Creates an item of a target type under a destination heading. Requires a pipe destination (e.g. < + milk | Shopping).

< + eggs | Shopping→[added to Shopping]

Comment

private

A private note that only appears on the left side. Never rendered on the right.

/ todo: revisit this later→(hidden)

Divider

separator

Draws a horizontal rule. Completions and moves cannot cross it. Add a label to center text on the rule.

~ Chapter 2→——— Chapter 2 ———

Find & Replace

Searches content above. Add | replacement to replace all matches. Add @ heading to scope to a section.

^ search | replace→[3 replaced]

Escape

literal

Makes the rest of the line plain text. Bypasses all prefix parsing.

\ + Not a task→+ Not a task

capabilities

Little things that make it feel right.

■ Quick capture

Append the clipboard from any app with ⌃⌥. No context switch.

■ Dual-pane editor

Write on the left, read the organized version on the right.

■ 15 themes

Seven light, eight dark. Every color hand-picked.

■ Export

Send notes and tasks to 12+ destinations.

■ Multiple notes

Switch between notes with titles and search.

■ Automation

Control Mudlark via mudlark:// and Apple Shortcuts.

■ Custom shortcuts

Rebind every keystroke. Change the prefix characters.

■ Reader mode

Toggle a rendered-only view of your note.

■ Named blocks

Group lines into named blocks for easier organization.

■ Window pinning

Pin above other windows to keep Mudlark visible.

■ Inline formatting

*italic*, **bold**, and `code` inside any line.

■ Print

Print the rendered pane with proper formatting.

■ Smart typography

Auto-converts arrows, symbols, fractions, smart quotes.

■ Custom callouts

Define your own line type with prefix, icon, color, style.

■ Indentation

Up to five levels of nesting for bullets and numbers.

■ Category order

Reorder or hide item categories in the rendered pane.

■ Note pinning

Pin notes to protect them from auto-cleanup.

■ Cheat sheet

Full reference for every prefix and shortcut (⌘/).

keyboard shortcuts

Your hands never leave home row.

Clipboard capture⌃⌥.

Text capture (compose)⌃⌥⇧.

New note⌘N

Browse notes⌘L

Previous note⌘[

Next note⌘]

Find in text⌘F

Cheat sheet⌘/

Toggle rendered pane⌘R

Export note⌘E

Settings⌘,

Duplicate lines⌘⇧D