Write on BYOK. Capture into Studio.

Use simple :: commands while writing on your BYOK device to turn ideas into Studio cards, wiki entries, outline items, notes, tasks, comments, and file details, all when you sync.

::card @plot
title: The door in the cellar
A hidden door beneath the old inn.
Mara hears something breathing behind it.
Becomes a Studio card, ready to file into your project.

Your device becomes a capture tool.

Capture ideas without leaving your draft

Stay in the flow on BYOK. Mark ideas as cards, wiki entries, outline beats, notes, or tasks while you write.

Send thoughts to the right Studio tool

A character note can become a wiki entry. A plot beat can become a card. A scene structure can become an outline.

Keep the device simple

BYOK stays distraction-free. Studio does the organizing when you sync.

Three steps, start to filed.

1

Type a command on BYOK

Use commands like ::card, ::wiki, ::outline, ::note, ::task, ::comment, and ::meta.

2

Sync to Studio

Studio recognizes the commands in your device text file.

3

File or route the result

Captures land in the Scratch Pad, or route automatically if the project has destinations set up.

What you can capture.

Write a command on its own line, then the content below it. Add an optional @handle to route it, and a title: line where a title makes sense.

Card

::card @plot
title: The betrayal
The mentor gives Mara the wrong map on purpose.
Creates a Studio card.

Wiki

::wiki @characters
title: Mara
A blacksmith's apprentice with a fear of open water.
Creates a wiki entry.

Outline

::outline @act-one
^ Opening
^^ The village burns
--- Mara escapes through the orchard
Creates outline nodes.

Note or task

::task
- Rewrite the inn scene
- Decide on Mara's last name
- Add a stronger ending
Creates a checklist in the Scratch Pad.

Comment

[the forge groaned awake] ::comment make this image stronger
Adds a comment to the synced Studio text file.

Metadata

::meta
folder: drafts
tags: @act-one, @mara
description: Scene notes from the train.
Applies file organization details during sync.

Exact syntax, edge cases, and parsing rules are in the full reference below.

Meet the Scratch Pad

The Scratch Pad is Studio's project inbox. It holds quick notes, checklists, and device captures until you're ready to move them into your project.

Drag notes or captures into card stacks, outlines, text files, manuscripts, or wiki entries. Use it as a holding place for ideas that are useful, but not ready to become part of the project yet.

Notes

Quick thoughts and loose ideas, typed in Studio or synced from your device.

Tasks

Checklists you can view on their own in the Tasks tab, pulled together from across the project.

Web-only users
No BYOK device? The Captures tab simply stays empty. Everything in the Notes tab works exactly as before. Captures is a power-tool for device users.

Routing and custom commands

Send captures where they belong

Project routing lets Studio send captures to the right destination when you sync. Map a handle like @characters to a wiki category, and ::wiki @characters goes straight there. Turn on auto-routing and resolvable captures skip the inbox entirely.

Make commands your own

Custom commands let you create shortcuts for your own workflow. For example, map ::character to ::wiki @characters:

::character
title: Mara
Stubborn, kind, hates dawn.

Now every character idea from your device lands in the right Studio wiki category. The full resolution order, default destinations, tag handles, and cleanup modes are in the reference.

Cheat sheet.

Bookmark this section or keep it open beside your device.

Captures

::card [@handle]
Create a card. Blank line ends the block; single Enter adds body lines.
::wiki [@handle]
Create a wiki entry. title: line sets the title.
::outline [@handle]
Create outline nodes. ^ / ^^ / --- or - / 1–2sp / 3sp+.
::meta
Apply folder: / tags: / description: to the source file.

Notes & comments

::note
Create a Scratch Pad note. Blank line ends the block; single Enter adds body lines.
::task
Create a checklist (- lines become items). Blank line ends the block.
[text] ::comment …
Add an anchored comment on the bracketed span.
::comment …
Add a comment to the paragraph above.
::as outline
Turn a whole file into an Outline file.

Outline syntax

Device-style                    Markdown-style
^ Header                         - Header
^^ Subheader                       - Subheader
--- Detail                           - Detail

Everything, in detail.

The mechanics behind every command, the Scratch Pad UI, routing rules, and settings. Open what you need.

Where to find the Scratch Pad

The Scratch Pad is a project-scoped workspace with two tabs: Notes for quick jots and checklists, and Captures for structured items synced from your device. There are three ways into it.

Header Inbox icon

Sits next to the Settings gear in the top-right of any project. Opens the full Scratch Pad to whichever tab you last viewed.

Drawer Inbox icon

At the top of the project drawer. Opens the full Scratch Pad directly to Captures.

Floating notepad button

Bottom of the project view, draggable horizontally. Click to open a 320px quick-access popup focused on the Notes tab.

Entry pointWhereOpens
Floating notepad buttonBottom of the project view (draggable horizontally along the bottom edge)Quick-access popup, 320px wide, positioned above the button
Header Inbox iconTop right of the header, next to the gearFull Scratch Pad, last-used tab (Captures or Notes)
Drawer Inbox iconTop of the project drawerFull Scratch Pad opened to Captures

The floating button can be hidden via account preferences (Hide Scratchpad), shows a small badge with the count of unseen notes, and remembers its horizontal position per browser.

Notes and checklists in depth

The Notes tab is a persistent, project-scoped pile of quick notes and checklists. Capture them from anywhere in the project, drag them onto card stacks or outlines, or drop them inline into open text, manuscript, or wiki content.

Notes and checklists, auto-detected

There are exactly two stored entry types. The Scratch Pad picks which one to render from a single rule: if every non-empty line of the entry starts with -, it's a checklist; otherwise it's a note. Switching between them is just a matter of adding or removing the - prefix.

A note
Remember the inn scene needs
a transition out. Mara
crosses the orchard at dawn.
Rendered as a block of free text. Click to edit, click outside to save.
A checklist
- Finish chapter 3
- Rewrite the inn scene
- Decide on Mara's last name
Rendered as one row per item with its own checkbox. Toggling persists.

Composing a new note

  1. Click + (or use the toolbar + in the full view). A blank tile appears at the top of the list in edit mode.
  2. Type. Enter saves. Shift + Enter adds a newline. Esc discards.
  3. Clicking outside the tile saves the entry.

Where notes can come from

  • Typed in the Scratch Pad (popup or full view).
  • Synced from your device with ::note or ::task.
  • Structured device commands (::card, ::wiki, ::outline, ::comment, ::meta) go to the Captures tab or to comments instead, not Notes.

Device-synced notes show a small from FileName link on hover. Click to jump back to the original text file.

Drag onto a structured file

Every Scratch Pad entry, and every capture in the Captures tab, shares the same drag type.

Drop targetWhat happens
Card stack sectionCreates a card with the entry text
Outline nodeCreates a new outline node at that location
Text fileInserts the text inline at the drop point
Manuscript sectionInserts the text inline at the drop point, same as a text file.
Wiki entry bodyInserts the text inline at the drop point, same as a text file.

Persistence and sync

  • Saved per project. One Scratch Pad per project.
  • Real-time sync: opening the Scratch Pad in two browser tabs or on two devices keeps them in sync; new notes from a device sync appear immediately.
  • Unseen-count badge: the header Inbox button and the floating notepad button both show the number of entries created since you last viewed that tab. The badge clears as soon as the tab is open.
The Tasks tab

Both the popup and the full view have three view tabs: All, Tasks, and Notes. The Tasks tab flattens every checklist across all your notes into a single list of items. Toggling a checkbox in the Tasks view updates the original entry. Helpful for "show me everything I have to do across this project, regardless of which entry I jotted it in."

Starting a new entry while the Tasks tab is active auto-prefixes each line with -, so it saves as a checklist.

The Captures inbox

When you type a line like ::card or ::wiki @characters in a text file on your BYOK, Studio recognizes it on sync and turns the lines that follow into a structured item waiting in the inbox.

  • Inbox / Cards / Wiki / Outlines filter chips at the top. Inbox shows everything that needs action; type chips narrow by capture type.
  • Search bar filters visible captures by body text.
  • Per-type previews: card-shaped tiles for cards, structured previews for wiki entries, nested-tree previews for outlines.
  • Group tiles: consecutive cards from the same device sync collapse into one block with a single Promote all action to keep the inbox tidy after a long sync.
  • Promote opens a destination picker: pick a file, pick a section or category, confirm. Auto-routed captures skip this step entirely.
  • Drag-and-drop any capture tile onto the same targets as Notes: card sections, outline nodes, or inline into open text, manuscript, or wiki content.
  • Source-file link on each tile on hover jumps back to the original text file the capture came from.
  • Bulk select with Shift- or Ctrl-click. Bulk promote and bulk delete.
Command syntax and per-command rules

A capture command lives on a line by itself, in the form ::command optionally followed by an @handle. The body starts on the next line and ends at the first blank line, the next command, or the end of the file. Commands are case-insensitive: ::Card, ::card, and ::CARD are all equivalent.

Capture commands are only processed for device text files as they sync into Studio. Typing them in a web-side text file in Studio does nothing. Handles can be any combination of letters, digits, -, and _, and may start with a digit (so @2024 is valid).

When a capture block ends

Use a single Enter for another line inside the same capture. Leave a blank line when the capture is finished and your manuscript prose resumes.

::card
The betrayal happens at the river.

Mara never trusted him after that night.

Only the first sentence becomes the card. The blank line ends the capture, so the last line stays in your source file. ::task has one extra rule: it also ends at the first line that is not a - bullet.

::card

A card destined for a card stack

Body text becomes the card body. Add a title: line on the first line to set the card title. Blank lines end the block; use a singleEnter between lines for multi-line cards. Multiple ::card blocks in one file produce multiple card captures, in source order. Consecutive cards from the same file collapse into one group in the inbox with a single Promote all button.

::card
A magic forge that only works at dawn.
Bound to the smith's bloodline.

With a title and handle, the capture routes to a configured destination:

::card @worldbuilding
title: The world-tree
Its roots reach into every dream.

::wiki

A wiki entry destined for a wiki file

Add a title: line on the first line to set the entry title; everything after becomes the entry body until a blank line. Wiki captures route to a category, not the wiki root.

::wiki @characters
title: Mara
A blacksmith's apprentice with a stubborn streak.

::outline

Outline nodes appended to an outline file

Two syntaxes are accepted, mixable. The first is friendly to type on a device:

  • ^ text → header (level I)
  • ^^ text → subheader (level II)
  • --- text → detail (level III)
::outline @plot
^ Act I
^^ The village burns
--- Mara escapes through the orchard
^^ Mara meets the smith

The second is markdown-style bullets, useful on the web or in Device Mimic mode:

  • - text → level I
  • 1–2 spaces before the bullet → level II (e.g. - text)
  • 3 or more spaces before the bullet → level III (e.g. - text)

* works the same as -. Tabs count as 2 spaces. Anything indented 3+ spaces collapses to level III. There is no level IV.

::meta

Apply metadata to the source file at sync time

::meta does not create an inbox entry. It applies metadata to the source file the block appears in, and the ::meta block is stripped from the file's content on sync so the editor stays clean.

::meta
folder: drafts
tags: @worldbuilding, @act-one
description: Notes from the train, scene draft for chapter 4.
  • folder:: moves the source file into the named folder, created on demand inside the project. The @ prefix is optional.
  • tags:: adds comma-separated tags to the source file. Resolves through the project's Tag Handle mappings before creating any new tag rows.
  • description:: sets the source file's description, truncated to 200 characters.

::note · ::task

Scratch Pad notes synced from your device

These go to the Notes tab, not Captures. ::note creates a text note; ::task creates a checklist. Blank lines end the block; use a single Enter between lines for multi-line notes.

::note
Remember the inn scene needs
a transition out.

With ::task, lines starting with - become checklist items. Use ::note when you want dash lines to stay plain text instead. A blank line ends the checklist and lets your manuscript continue.

::task
- Finish chapter 3
- Rewrite the inn scene
- Decide on Mara's last name
::task
- Finish chapter 3
- Rewrite the inn scene

She crossed the orchard at dawn.

Only the - lines become checklist items; the line after the blank line stays in your file.

Routing, handle mappings & defaults

Every project has its own routing rules. Open them from Scratch Pad → Captures → Settings (the gear icon). Three layers of routing exist; Studio walks them top to bottom when a capture comes in.

1. Default destinations

For each capture type, you can set a default destination for this project. ::card captures without a matching handle land in the default card stack; ::wiki captures land in the default wiki category; ::outline captures append to the root of the default outline.

2. Handle mappings

A handle mapping binds a device-side @handle to a specific destination, so ::card @worldbuilding routes to a specific card stack and section, ::wiki @characters routes to a specific wiki category, etc.

@handle  +  capture type  +  destination file  +  section / category

Resolution order at sync time (when auto-route is on):

  1. Handle on the command line + matching mapping → route there.
  2. No handle, or unmapped handle → project default for that capture type.
  3. No project default → the capture waits in the inbox for manual triage.
A worked example
You map @characters → your Characters wiki, Lore category. From then on, every time you type ::wiki @characters on your device followed by a title: Name line, the synced entry arrives in the Lore category of your Characters wiki, already filed, no inbox triage needed.

3. Tag handles

Tag handles are a separate but parallel idea. In Capture Settings → Tag handles, you bind a handle like @t-mara to an existing tag. After that, tags: @t-mara inside a ::meta block applies the right tag instead of creating a fresh one literally named t-mara.

Auto-route toggle

A switch in Capture Settings controls whether captures with a resolvable destination route automatically on sync. With the toggle off (the default), all captures wait in the inbox for manual triage. With it on, captures that resolve to a destination skip the inbox entirely.

A separate Source-file cleanup mode picks what happens to the original device text file: Leave (default: keep the :: lines as written), or Strip (remove processed :: lines after extraction, leaving only the prose). With Strip enabled, the cleaned file syncs back to your BYOK on the next device sync.

Custom commands

In Capture Settings → Custom commands, you can map any non-reserved ::token to a built-in capture type, with an optional default handle.

For example, map ::character wiki + default handle @characters. Now, on the device, writing:

::character
title: Mara
Stubborn, kind, hates dawn.

…has the same effect as writing ::wiki @characters followed by the same body.

Reserved tokens that can never be overridden: card, wiki, outline, note, task, comment, meta, as.

File Mode (whole-file captures)

Sometimes a whole text file is the structured item. If the first non-blank line of a device text file is ::as outline, the entire file is treated as a single outline rather than parsed for capture blocks.

::as outline
title: Act I beat sheet

^ Opening
^^ The village burns
--- Mara escapes
^ Rising action
^^ Meeting the smith

What happens on sync:

  • A new Outline file is created in your project, named from the title: line, or the source file name if no title is given.
  • The original text file is consumed, hidden from the drawer so you don't see two copies. It still exists in the database; the outline keeps a reference to it.
  • Re-syncing the same source updates the outline in place.
  • If you've edited the outline in Studio and then re-sync the source, the next sync creates a sibling outline rather than overwriting your Studio edits. Your work is never silently replaced.

Only outline is supported as a File Mode type today.

Comments

Comments are a sibling to captures, not a sub-feature. Captures populate the inbox. Comments anchor to text file content and live in a column beside the text (Google Docs style).

What it looks like in Studio

  • Open a text file that had ::comment lines on its last device sync. Bracketed sections are highlighted in the body.
  • A column on the right shows comment cards aligned to their highlights.
  • Click a highlight → the matching card scrolls into view. Resolve, edit, or delete from the card.
  • Web users can add comments directly in Studio (select text → comment). No device required.

How comments survive edits

  • Anchored highlights (bracketed […] ::comment) re-anchor by snippet match on every re-sync, so editing surrounding prose on the device doesn't break the link.
  • Positional comments (::comment on its own line) re-attach to the preceding paragraph by snippet match.
  • Orphaned comments (anchors lost after a big rewrite) pile in their own section at the bottom of the column so they're not lost. You can re-anchor them by hand.
Settings reference

Everything in Scratch Pad → Captures → Settings (the gear), in one list.

SettingWhat it does
Default card stackWhere ::card captures land if no matching handle mapping exists. File + optional section.
Default wikiWhere ::wiki captures land if no matching handle mapping exists. File + category path.
Default outlineWhere ::outline captures append by default. File only. They append at the root.
Default folder for new device text filesWhere new text files created on the device land if no ::meta folder: line is provided.
Auto-route structured capturesWhen on, captures with a resolvable destination skip the inbox and route directly on sync. Off by default.
Source-file cleanup modeLeave (default: keep :: lines in the file) or Strip (remove processed :: lines after extraction, leaving only prose). With Strip enabled, the cleaned file syncs back to your BYOK on the next sync.
Handle mappings@handle → file + section/category bindings. Resolves at sync time before falling back to defaults.
Tag handles@handle → existing tag bindings, applied through ::meta tags: lines.
Custom commandsMap any non-reserved ::token to a built-in capture type, with an optional default handle.