Docs

User guide

Everything you need to know about Scriptorium's features.

Accounts

New account registrations are currently disabled. Existing users can still sign in and continue using Scriptorium.

• All notes and projects are private to your account.
• Update your name, email, or password any time from Profile in the sidebar.
• Upload a profile picture (up to 2 MB) or let the app use your initials.
• You can permanently delete your account and all data from Profile → Delete account.

Notes

A note is a markdown document with a title, body, tags, and optional frontmatter metadata.

• Create — Click the New note button in the top bar or the sidebar.
• Edit — Select a note from the list to open it in the editor. Edits autosave after a short pause.
• Title — Edit the title field at the top of the editor. The slug is generated automatically.
• Tags — Type a tag and press Enter or comma in the tag input. Remove tags by clicking the × on each chip.
• Pin — Click the pin icon on a note card to keep it at the top of the list.
• Delete — Use the trash icon on the note card or the delete button inside the editor. A confirmation dialog prevents accidental deletion.
• Sort — Use the sort dropdown in the notes panel to order by last updated, creation date, or title.
• Search — Type in the search box in the notes panel to filter notes by title or content.

Frontmatter

Each note includes YAML frontmatter with these fields:

---
id: <uuid>
title: My note title
createdAt: 2026-06-06T10:00:00.000Z
updatedAt: 2026-06-06T10:42:00.000Z
slug: my-note-title
isPinned: false
tags: ["writing", "draft"]
---

Note body starts here.

Frontmatter is generated and kept in sync by the app. You do not need to edit it manually.

Workflow modes

The top tab bar switches between four modes. See the Workflow guide for a full walkthrough.

• Collect — Write and capture new notes quickly.
• Connect — Browse by tag, multi-select notes, and bulk-edit tags.
• Combine — Build an ordered project stack from your notes.
• Write — Edit the compiled project draft in a distraction-free editor.

Projects

A project is an ordered collection of notes that you can compile into a single draft.

• Create — Click New project in the Combine panel.
• Add notes — Use the Add to project button on any note card, or the stack controls inside Combine mode.
• Reorder — Drag note cards within the project stack to rearrange them.
• Compile — Click Compile to merge all notes in the stack into the project body, separated by headings and horizontal rules.
• Edit draft — Switch to Write mode to edit the compiled text.
• Delete — Use the trash icon on the project card.

Import & export

Export

Click the download button in the top bar. Scriptorium downloads a zip file containing:

• manifest.json — full snapshot of all notes and projects.
• notes/<slug>.md — one markdown file per note with frontmatter.

Import

Click the upload button in the top bar and select a .zip export or a .json manifest file. Notes and projects are upserted by their id field, so re-importing is safe and idempotent.

Import limits: zip archives up to 20 MB, up to 2,000 files.

Feedback & support tickets

Use the Feedback link in the sidebar to submit bug reports, feature requests, or general questions. You can track the status of your tickets (Open → In Progress → Resolved) and add replies to an ongoing thread.

Keyboard shortcuts

Most actions are accessible via buttons. The editor supports standard CodeMirror shortcuts for text editing. Press Ctrl+S (or Cmd+S) to manually trigger a save at any time.

Data & privacy

All data is stored server-side in your account. No third-party cloud sync is used. See the Privacy Policy for full details.