# Changelog

All notable changes to **Scriptorium** are documented in this file.

The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.1.0/), and
this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).

## [development]

### Added

-

## [1.0.1] - 2026-09-28

### Fixed

- A paragraph that follows a definition list, separated from it by a blank line, is no longer swallowed into the `dl` element: the list ends before it, and terms after the paragraph open a list of their own.
- A superscript or subscript without a base, the isotope notation of `^3He`, renders over an empty base instead of degrading to an merror.

## [1.0.0] - 2026-09-27

### Added

- `Render` renders Markdown to HTML: the full CommonMark 0.31.2 grammar, the GitHub Flavored Markdown extensions (tables, strikethrough, task lists, extended autolinks), footnotes and definition lists. Output is deterministic for the same input.
- `RenderMath` and `RenderMathDisplay` render TeX mathematics to MathML Core: the symbol tables, fractions, radicals, scripts with movable limits, stretchy delimiters, the amsmath environments, accents, styles, colours, extensible arrows and bounded macros. Constructs outside the mappable surface stay visible as their verbatim source in an merror element.
- `RenderDiagram` renders Mermaid diagrams to SVG: the flowchart grammar including the historical `graph` spelling (node shapes, edge kinds with labels, subgraphs with their own direction, classes and styles) and the sequenceDiagram grammar (participants and actors, all arrow kinds, notes, activations, the block constructs, coloured rects, autonumber and dividers). Every other diagram type is refused with an error naming it.

<!--
Rules for this file:

- The release pipeline reads the section that begins at the line matching
  `## [X.Y.Z]` and ends at the next `## [`. What follows the closing bracket on that
  line is free, so the separator is free. `## [development]` always stays at the top of
  the history.
- Categories: Added, Changed, Fixed, Removed, Security. Include only those with
  entries.
- Entries describe user-visible changes, taken from git log, not commit noise.
- No link-reference sections at the end of the file.
- Nothing in this file may use a dash as punctuation.
-->