# jgm/djot

A light markup language

Repository: https://github.com/jgm/djot
Canonical: https://ross.abutalabs.com/products/djot
Homepage: https://djot.net
Language: Emacs Lisp
License: MIT
License Family: permissive
Topics: commonmark, lua, markdown, markup-language, pandoc
Last push: 2026-07-01T11:53:19+00:00

## Health v2 (maintenance only)
Score: 63/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 90, release rhythm 8, longevity 100
- inputs: {"age_days": 1514, "days_push": 63, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 2033, forks 59 (observed 2026-08-28T04:06:07.824961+00:00)

## What it is
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
- artifact type: library
- maturity: active
- function: parser, markdown, documentation, cli
- domain: parsers, documentation, developer-tools, web-development
- platform: lua, cli, cross-platform
- tags: markup-language, commonmark, lightweight-markup, pandoc, syntax, nodejs

## Member repositories
- jgm/djot (main) score 63

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:06:07.824961+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T02:59:27.431704+00:00, confidence not recorded.
  - readme: https://github.com/jgm/djot (fetched 2026-08-28T04:06:07.824961+00:00, sha 313387fe33fd)
  - homepage: https://djot.net (fetched 2026-08-29T10:39:06.833636+00:00, sha c9f7e4ecf1b6)
- Data as of 2026-08-30T08:39:29.467469+00:00.