Skip to content

v1.0.0 - the format is stable

Latest
Latest

Choose a tag to compare

View all tags
@0xLeif 0xLeif released this 24 Jun 05:33
· 67 commits to main since this release
v1.0.0
b8ea548

3md is 1.0: the grammar is frozen and stable.

Spec freeze (SPEC.md 1.0)

  • The frontmatter is now a precisely specified, named flat key/value mini-format (it looks like YAML but is not: no nesting, lists, or anchors).
  • Added a "Relation to prior art" section (YAML frontmatter, CommonMark directives, reveal.js, MDX) and a Stability section: the 1.0 grammar is frozen; additive features come in future minor versions; the shared conformance suite is the contract.
  • Format marker is now 3md: 1.0. The parser is version-lenient, so existing 3md: 0.1 documents remain valid; a conformance vector pins both.

Three implementations in lockstep (Swift ThreeMD, TypeScript @corvidlabs/threemd, Rust threemd), proven equivalent by a 43-vector conformance suite. Plus a CLI, an HTML renderer with Markdown + cross-plane links, VS Code syntax highlighting, nine examples, and two live demos.

Verified: swift-format lint clean, 122 Swift tests, 76 TypeScript tests, 43 conformance vectors green in all three languages, spec-sync 7/7.

SwiftPM:

.package(url: "https://github.com/CorvidLabs/3md", from: "1.0.0")
Assets 2
Loading