Understory Notes

Product Introduction

1. Definition: Understory Notes is a native macOS application that functions as a hybrid note-taking and outlining tool, specifically engineered for the research-to-writing workflow. It operates on a file-based system, storing notes as plain Markdown files in a user-designated folder (Project Notebook) or via iCloud (Personal Notebook).
2. Core Value Proposition: It exists to eliminate the friction and context-switching inherent in the academic and long-form writing process. Its primary value is providing a single, integrated environment to collect research notes, structure them into a hierarchical outline, and draft the final document, culminating in multi-format export without ever copying content between disparate apps.

Main Features

1. Hierarchical Note-Taking with Multi-Placement: Unlike traditional outliners where items are simple bullets, every item in Understory is a full-text note. Notes can be nested to create an outline (subnotes), and crucially, the same note can exist in multiple locations within the hierarchy. This allows a single research note or idea to support several different arguments or sections without duplication.
2. Project-Centric Workflow (Collect, Outline, Write, Publish): The app enforces a structured, three-stage workflow. Users first collect notes under source categories (e.g., Book/Chapter). They then outline by creating main point notes and dragging collected notes beneath them as supporting evidence. Finally, they write the draft in the main point notes, with supporting research visible directly below. The publish function renders the final outline sequence into PDF, Rich Text, Markdown, or a static website.
3. Local-First, Vendor-Lock-In-Free Data Management: Understory uses no proprietary cloud service or account system. Data is stored either as plain Markdown files in a user-controlled folder on the Mac's filesystem or in the user's own iCloud Drive. This ensures full data portability, longevity, and privacy, as notes are always accessible outside the app.

Problems Solved

1. Pain Point: The "scattered tools" problem where writers use one app for note-taking (e.g., Apple Notes, Obsidian), another for outlining (e.g., OmniOutliner, Workflowy), a word processor for drafting (e.g., Word, Pages), and manual copy-pasting to compile everything, leading to lost context and workflow fragmentation.
2. Target Audience: The primary user personas are academic researchers and students writing papers and theses, non-fiction authors and bloggers developing long-form articles or books, and content creators scripting videos or podcasts who require a structured research-to-draft process.
3. Use Cases: Essential for writing a literature review where notes from dozens of sources must be thematically organized and woven into an argument; drafting a book chapter where plot points or concepts need to be rearranged in an outline with supporting quotes attached; producing a long-form investigative article where research notes must be directly tied to specific claims in the draft.

Unique Advantages

1. Strengths & Limitations (Pros & Cons):

   • Pros: Uniquely integrated workflow from capture to publish; non-destructive, multi-placement outlining preserves note context; strong commitment to user data ownership and privacy via local Markdown files; one-time purchase model with a generous free tier.
   • Cons: Currently macOS-only, excluding Windows, Linux, and mobile users (iOS/iPadOS not yet available); the structured "Collect, Outline, Write" paradigm may feel restrictive for freeform thinkers; as a newer, niche tool, it lacks the extensive plugin ecosystems of established apps like Obsidian.

2. Key Alternatives & Differentiation:

   • vs. Obsidian: Obsidian is a general-purpose, powerful knowledge base with graph views and vast plugins. Understory differentiates by being opinionated and purpose-built specifically for writing, with baked-in publishing and a linear outline-focused workflow, whereas Obsidian requires configuration and multiple plugins to achieve a similar end-to-end process.
   • vs. Scrivener: Scrivener is the industry standard for long-form writing and also combines research, outline, and draft. Understory differentiates with a cleaner, more modern UI, a simpler flat-rate pricing model (vs. Scrivener's paid upgrades), and a foundational philosophy of storing notes as plain files without a proprietary project bundle.
   • vs. Traditional Outliners (OmniOutliner, Workflowy): These are superior for pure hierarchical idea manipulation but treat each node as a line of text. Understory differentiates by making each node a full-document note, blending the depth of a word processor with the structure of an outliner.

Frequently Asked Questions (FAQ)

1. Is Understory a Zettelkasten app? While it shares concepts like note-linking and atomicity, Understory is not a pure Zettelkasten implementation. It is better described as a project-based writing app that uses Zettelkasten-like principles (unique, connectable notes) within the context of a specific writing project's outline, rather than as a lifelong, interconnected knowledge base.
2. Can I use Understory for tasks other than writing, like project management? It is technically possible but not ideal. The app's core architecture—notes, subnotes, and a publish function geared for linear documents—is optimized for narrative and argument construction. For task and project management, dedicated tools like Todoist or Notion offer more suitable features like dates, assignments, and kanban boards.
3. How does the free trial work and what are the limits? Understory operates on a freemium model. The app is free to download and use indefinitely with all features enabled, including publishing. The sole limitation in the free tier is a cap on the total number of notes per notebook. This allows users to fully test the workflow on a real project. A single, one-time in-app purchase permanently removes this note limit.
4. What happens to my notes if I stop using Understory? Your notes remain fully accessible. If you use a Project Notebook, your notes are just Markdown (.md) files in a folder on your Mac, readable by any text editor. If you use a Personal Notebook via iCloud, the files are stored in a dedicated iCloud Drive folder. There is no vendor lock-in.
5. Does Understory support backlinks or a graph view? No, not in its current version. The app's primary navigation and relationship model is the hierarchical outline and the ability to place a note in multiple parent locations. It emphasizes a linear, purposeful structure for a writing project over a non-linear, emergent network of ideas.