Stencila Markdown (.smd) is Stencila's native Markdown flavor. It extends CommonMark with block and inline syntax to represent Stencila-specific document elements that standard Markdown cannot express.

Block extensions use ::: fenced markers (similar to Pandoc divs), while inline extensions use [[ ... ]] bracket syntax. Code blocks can be made executable by adding an exec flag after the language identifier (e.g. ```python exec).

Stencila Markdown is the recommended format for authoring documents in Stencila when you want Markdown readability with full access to Stencila Schema features.

To convert to/from Stencila Markdown, use the .smd file extension, or the --to smd or --from smd options e.g.

Stencila supports bi-directional conversion between Stencila documents and Stencila Markdown. Parsing and encoding are implemented in the Rust crate codec-markdown, with per-node-type Markdown encoding derived via codec-markdown-trait and codec-markdown-derive. See the CommonMark documentation for details on the underlying Markdown parser.