Open Format

Documents with superpowers.

Notes that actually do things. Specs that track themselves. 35 block types, AI chat, and an open format you own forever.

35Block types
378Tests passing
4Render targets

Typed documents

35 block types with schema validation. Decisions, data tables, tasks, conversations — not just prose. Structure your thinking, not just your words.

AI chat modes

Research. Plan. Build. Three AI modes that understand your documents and help you write, organize, and ship — from a single chat interface.

Multi-target rendering

Same source file renders to HTML, PDF, terminal, and Markdown. Write once. Publish anywhere. No export plugins, no conversion tools.

Built for teams. Built for you.

For software teams

Typed specs and decision docs replace scattered wikis. Automatic time-per-status tracking means no timers to start and no time to log. Knowledge docs, task management, and AI chat in one workspace.

For individuals

Quick capture notes with 35 block types — not just text paragraphs. Search everything instantly. Own your files forever as plain text on disk. AI chat helps you research, plan, and write. VS Code extension included.

How it works

    FeatureSurfDocMarkdownHTMLNotionObsidian
    Typed blocks
    Open format
    Tasks built-inPartial
    AI chat modesPartialPartial
    Multi-target renderPartial
    No vendor lock-in
    VS Code extension

    Open format. Your files. Forever.

    SurfDoc files are plain text. They live on disk, in git, in any filesystem. No cloud dependency. No vendor lock-in. A .surf file without a renderer is still readable markdown.

    View on GitHubRead the Spec

    Who uses SurfDoc

    WaveSite

    AI chat-to-website builder. Every generated website is a SurfDoc rendered by surf-parse.

    wave.site →

    cloudsurf.com

    Corporate landing page rendered from a `.surf` file with hero, features, and stats blocks.

    cloudsurf.com →

    surfcontext.org

    The ARDS specification website. Landing page is a SurfDoc file.

    surfcontext.org →

    Start writing documents that do things.

    Free for individuals. Free for teams up to 3. No credit card required.

    Sign up freeRead the Spec