Skip to content

3md documentation

3md is Markdown with a Z axis. A .3md file is ordinary Markdown stacked into planes along one named axis, and you tell the reader what the depth means: time for a planner, frames for an animation, layers for annotations, space for a scene. These docs cover the format, the viewer, the CLI, and the conformance-checked parsers.

Getting started

  • What is 3md? - Markdown extended along one named Z axis: stack content into planes and say what the depth means.
  • Quickstart - Write your first .3md file and open it in the viewer in a few minutes.

The format

  • The format - Frontmatter, the Z axis, @plane directives, attributes, and cross-plane links.
  • Viewer and web component - The <three-md> web component and its view modes (stack, play, map, blend, and more).

Reference

  • CLI reference - The threemd CLI: validate, info, html, links. Install with Homebrew.
  • Parsers and conformance - Conformance-checked parsers in Swift, TypeScript, and Rust, kept in lockstep.
  • Specification - The authoritative 3md format specification.