Skip to content

Markdown profile

CommonMark: the carefully specified core.

Use MDLoom's CommonMark 0.31.2 target when a small, specified syntax surface matters more than tables, task lists, or product-specific extras.

commonmark-0.31.2

The editor stores the selected profile ID and performs a source-preserving dry-run before a profile switch. Full historical renderer replay is a separate release gate.

Good fit

Choose CommonMark for a stable, portable baseline

Portable prose

Headings, paragraphs, emphasis, quotes, lists, links, images, and code cover most durable documentation.

Testable behavior

The profile targets the named specification and has repository fixtures for representative behavior rather than relying on a vague “standard Markdown” label.

Clear boundaries

Tables, task lists, strikethrough, math, diagrams, alerts, and footnotes are not silently added.

Safe rendering

Raw HTML remains governed by MDLoom's explicit policy and sanitizer; a syntax standard is not a security boundary.

Example

Readable before and after rendering

# Field notes

A portable paragraph with **emphasis**.

1. Observe the source.
2. Keep the structure clear.

> Meaning survives a plain-text view.

```sh
printf 'hello\n'
```

Field notes

A portable paragraph with emphasis.

  1. Observe the source.
  2. Keep the structure clear.
Meaning survives a plain-text view.
printf 'hello\n'