Keep the explanation beside the system
Use prose to state intent and constraints, code to demonstrate exact behavior, tables to compare alternatives, Mermaid to show structure or interaction, and equations when precision matters.
Use the right editing surface
Write ordinary prose in Visual, inspect exact syntax in Source, and use Split when the relationship between source and result matters. Reader gives you the same document from the audience’s position.
Link decisions to their evidence
Connect a specification to its research, an architecture decision to the rejected options, and a runbook to the system it operates. The outline handles structure inside a document; links handle structure across the library.
Keep source portable
Telescopo Flavored Markdown builds on CommonMark and GitHub Flavored Markdown. Extensions for diagrams, equations, callouts, wiki links, and page breaks remain visible in plain text even when another tool does not render them.
Deliver the right artifact
Share Markdown for review, version control, and reuse. Export PDF for a stable reading experience. Export Mermaid as PNG or SVG when the diagram belongs in an issue, presentation, or another document.
A portable Markdown structure for problem, constraints, system, alternatives, and validation.
Bring your thinking into focus.
Start with one real note and follow it as far as it needs to go.
Included reading, paid workflows, and existing purchases