Compatibility

Markdown needs a versioned profile, not a guess.

The same punctuation can mean different things across renderers. MDLoom names the baseline and curated extensions, compares profile output before a switch, and records renderer or engine identity on paths that produce it.

Choose a profile in the editor Read the decision guide

Default profile

GitHub Extended

Friendly for README-style writing, while keeping formal GFM and each extra feature distinguishable.

Core: CommonMark
Extensions: Versioned

Profiles

Choose for the destination, not personal preference

The editor treats a profile change as a dry-run comparison with diagnostics. Confirmation changes the interpretation label but does not rewrite source or imply that a cloud revision was created.

Specified core

CommonMark 0.31.2

The smallest MDLoom profile, grounded in the CommonMark specification and examples.

Adds or covers

Headings, paragraphs, lists, quotes, links, images, emphasis, code, and HTML blocks as defined by policy.

View profile guidance

Formal extension

Strict GFM 0.29

GitHub's formal specification layered on CommonMark for repository-style documents.

Adds or covers

Tables, task list items, strikethrough, autolinks, and tag filtering.

View profile guidance

MDLoom default

GitHub Extended

Formal GFM plus a separately versioned allowlist of GitHub-documented extras.

Adds or covers

Curated math, alerts, Mermaid diagrams, footnotes, and highlighting where explicitly supported.

View profile guidance

Advanced

Pandoc Publishing

A managed profile for richer Pandoc exports, with a deliberately smaller browser-preview surface.

Adds or covers

Metadata, footnotes, math, alerts, GFM tables, and task lists. Definition lists and citations are not advertised as browser-preview features yet.

View profile guidance

Recorded identity

What the current paths actually store

The record becomes richer as a document moves from a local draft to a cloud revision or server artifact. A profile label alone is not a promise of historical replay.

Local workspace: Current text, source encoding and line endings, original bytes while unedited, and selected profile ID
Portable bundle: Profile ID, file order, inclusion state, source files, and the bundle's current manifest schema
Cloud revision: Content hash, profile ID, revision reason, lock version, and a renderer-identity field
Server artifact: Source/render/artifact hashes, managed options, engine version, warnings, format-specific preflight fields where returned, and validator results