jgm/djot

Health v2 · maintenance only

Adoption not part of the score

2033 stars · 59 forks observed · 2026-08-28

What it is AI-extracted, prompt v1, taxonomy v1, 2026-08-30, confidence not recorded

Djot is a lightweight markup language derived from CommonMark that fixes CommonMark's parsing ambiguities while adding features like footnotes, tables, math, and attributes. The repository provides the official JavaScript parser and CLI, with community implementations in Lua, Rust, Go, and other languages.

Use cases

• write documents in a simpler alternative to markdown
• convert markdown documents to djot format
• parse lightweight markup in linear time without backtracking
• convert djot documents to docx or other formats via pandoc
• get reliable syntax highlighting for a markup language
• use footnotes, tables, and math in a light markup syntax

When to choose

• you want a fuller-featured, less ambiguous alternative to Markdown
• you need deterministic, locally parseable inline syntax for tooling or highlighting
• you already use pandoc and want a cleaner authoring format

When to avoid

• you need a fully frozen, stable spec — djot syntax may still change
• your ecosystem or tooling is Markdown-only
• you need broad third-party editor support out of the box

Facets

library · maturity active

parser markdown documentation cli parsers documentation developer-tools web-development lua cli cross-platform markup-language commonmark lightweight-markup pandoc syntax nodejs

Member repositories

For agents

markdown · JSON · MCP: product_card(name="jgm/djot")