Documents

Documents Overview

Stable Baseline documents are rich, structured files that combine Markdown with embedded diagrams, images, data visualizations, and AI-powered editing — all inside a collaborative, versioned workspace.

More Than Markdown

Every document in Stable Baseline is written in CDMD (CloudDocs Markdown) — an extended Markdown format that supports everything you'd expect from a modern documentation platform:

Rich Text

  • Headings, lists, tables
  • Bold, italic, strikethrough
  • Colored text & highlights
  • Keyboard shortcut badges

Code & Data

  • Fenced code blocks with syntax highlighting
  • Inline code
  • Data tables
  • Vega/Vega-Lite chart attachments

Visual Content

  • 37 diagram types (Mermaid, PlantUML, BPMN, D2, …)
  • Embedded images (PNG, SVG, WebP, …)
  • Captioned & aligned media
  • Architecture diagrams with icons

Structure

  • Callout panels (info, warning, tip, …)
  • YAML frontmatter
  • Version history
  • Line-based collaborative editing

The Editor Experience

Documents open in a split-view editor with a live preview pane that renders your CDMD in real time. The editor provides:

  • Inline toolbar — select text to see formatting options (bold, italic, heading, list, code, link, colored highlight).
  • Diagram insertion — click the diagram button to add any of 37 diagram types. A modal guides you through selecting a type and writing (or AI-generating) the DSL.
  • Image upload — drag & drop or click to upload images up to 10 MB. They are stored, served via CDN, and embedded with captions.
  • Version history — every save creates a version with a change summary. You can view, compare, and restore any previous version.

What Can You Document?

Documents are designed for technical and business documentation. Common use cases include:

System ArchitectureC4 context/container/component diagrams, deployment topologies, infrastructure layouts.
API DocumentationEndpoint references, request/response examples, authentication guides.
Business ProcessesBPMN process flows, decision models, swimlane diagrams.
Database SchemasERD diagrams (Mermaid or DBML), migration guides, data dictionaries.
Runbooks & PlaybooksStep-by-step operational procedures with decision trees and flowcharts.
Product RequirementsPRDs, user stories, requirement traceability matrices.
Knowledge BasesOnboarding guides, FAQs, team wikis, decision logs.

37 Diagram Types

Every document supports embedded diagrams rendered from text-based DSLs. Choose the right diagram for the job — from flowcharts and ERDs to C4 architecture and waveform timing.

Explore the full Diagram Gallery →

Process

Model business processes, decision flows, and user journeys.

BPMN Process (pools/lanes)
Flowchart / Decision Tree
Workflow / Swimlanes (UML Activity)
Activity Diagram (compact DSL)
User Journey Map

Engineering

Sequence diagrams, state machines, class models, and more.

Sequence Diagram
Sequence Diagram (PlantUML)
Class Diagram
State Machine
Use Case Diagram
Component Diagram (UML)
Deployment Diagram (UML)
Git Graph
Requirements Diagram
Mind Map

Architecture

System architecture, C4 models, network topologies, and infrastructure.

System Architecture (icon-based)
C4 Context Diagram
C4 Container Diagram
C4 Component Diagram
Architecture-as-Code (Structurizr DSL)
Network Topology (icon-based)
Network Diagram (compact DSL)
Rack Diagram

Data

Entity-relationship diagrams, graphs, and flow visualizations.

ERD (DBML)
ERD (Mermaid ER)
Generic Graph (DOT)
Sankey Diagram

Charts

Bar charts, timelines, Gantt charts, and data visualizations.

Charts (Vega-Lite)
Charts (Vega)
Pie Chart (simple)
XY Chart (simple bar/line)
Timeline
Gantt Chart (simple)
Kanban Board

Specialized

Waveforms, packet layouts, ASCII art, cable diagrams, and sketches.

Digital Waveform / Timing
Bytefield / Packet Layout
Packet Diagram
Wiring Harness / Cable Diagram
Block Diagram (simple)
ASCII Box Diagrams (SvgBob)
ASCII Diagrams (Ditaa)
Text Diagrams (Pikchr)
UML (nomnoml)
Sketch Diagram (Excalidraw)

Next Steps