Lightning Jar - Web Studio Lightning Jar Wordmark
Skip to main content
Technologies

barkdown

Markdown / DOM Codec · Open Source (MIT)

barkdown is a Markdown to DOM round-trip codec, guaranteed to invert marked. Parse markdown to HTML, edit it as a live DOM (contenteditable, WYSIWYG, or programmatic transforms), and serialize back to markdown that is provably the same document. The contract is a testable mathematical property: one round trip canonicalizes any input, a second is byte-identical, footnotes survive exactly, and unknown elements pass through as raw HTML with no silent loss.

It is the sibling of barkup: barkup guards the tree's identity, barkdown guards the prose's. We extracted it from our production blog CMS, where every keystroke of the WYSIWYG editor round-trips through it, and the guarantees are enforced by a corpus suite plus property tests running about 2,000 random documents per run. Published on npm as @kevinpeckham/barkdown under the MIT license.

Visit barkdown →

How We Use It

  • Serializing WYSIWYG and contenteditable output back to clean markdown
  • Round-tripping markdown through programmatic DOM transforms without drift
  • Keeping footnotes, tables, and raw HTML intact across repeated edit cycles

Related reading: The Untested Half of Your WYSIWYG

Content Management / PIM

Why this matters: Centralizing content and product data shortens time-to-publish, lowers error rates, and keeps every channel consistent. Platforms that centralize product data, digital assets, and content, enabling omnichannel delivery, governance, and a single source of truth across websites, apps, and commerce. Preferred defaults: Pimcore for data-heavy catalogs; Sanity for bespoke editorial workflows; Hygraph for GraphQL-first federation.