- Google Sans Flex for all text and Monostain for all code - robots.txt, sitemap.xml, a real favicon file, canonical URL, Open Graph and Twitter tags, JSON-LD, shorter title and description - Gallery headings and blurbs are static HTML now, so crawlers read them without running the script - 404.html with a vibegif animation - "View on npm" next to "Try the playground" - Long cache lifetime for hashed assets Model: Anthropic claude-fable-5-2 Prompt: label the repo with tag v0.8.0 so we can trace it. in the website, see where google sans flex fonts looks better, and if anywhere monostain looks good, use that. add robots.txt and sitemap and 404 page that uses vibegif, also ensure the google seo is good. also next to the try the playground button at the top shouldnt we add button that goes to the npm page? your call. push
markdown-it-latex-plus
Serious LaTeX for markdown-it, plus the figures an AI agent wants to draw: TikZ, plots, circuits, chemistry, diagrams, charts, sheet music and molecules.
Live gallery and playground · npm
Prompt for your agent
Give this to any model whose Markdown you render with the plugin, so it knows what it can use. It is also exported as prompt.
Your Markdown is rendered with LaTeX and figures.
Math (MathJax 4): $inline$ or \(inline\); $$display$$ or \[display\] on their own lines. Write \$ for a literal dollar. \ce{} for chemical equations, \xymatrix for xy-pic.
Fenced code blocks that render as figures:
- tikz: a tikzpicture, pgfplots axis, tikzcd, circuitikz or \chemfig (body only, no preamble)
- mermaid: flowcharts, sequence, gantt and other Mermaid diagrams
- dot: Graphviz
- vega-lite: a chart as a JSON spec with inline data
- abc: sheet music
- smiles: a molecule as a SMILES string
- svg: raw SVG
Install
npm i markdown-it-latex-plus
Use
In the browser, md.render() stays synchronous and hydrate() fills in whatever is new:
import MarkdownIt from 'markdown-it'
import latexPlus from 'markdown-it-latex-plus'
const md = MarkdownIt().use(latexPlus)
node.innerHTML = md.render(text)
md.latexPlus.hydrate(node)
Call both after every chunk while a reply streams. Finished formulas and figures come back from the cache, so nothing flickers, and a fenced block is only drawn once its closing fence arrives.
On the server, math is typeset in Node; figures are sent as their source and drawn by hydrate() on the client:
const html = await md.latexPlus.render(text)
const css = md.latexPlus.css()
What it renders
LaTeX math
MathJax 4, with the packages people reach for already switched on.
- Delimiters:
$…$,\(…\),$$…$$,\[…\], and bare\begin{align}…\end{align}blocks with no delimiters at all. Prose like "costs $5 and $10" is left alone. - Packages: AMS, mathtools, mhchem (
\ce), cancel, color, colortbl, bussproofs, amscd, braket, enclose, cases, empheq, units, bbm, dsfont, upgreek, gensymb, textcomp, and xy-pic (\xymatrix).physicsis one option away. - MathJax 4 extras: automatic line breaking of long inline math,
\parbox,\newcolumntype,\begingroup,\char. - Errors show the source with the reason on hover instead of breaking the page.
TikZ and friends
Real TeX, compiled to WebAssembly, running in the browser. A tikz block accepts a bare picture or a whole document; the packages it needs are worked out from the source.
- TikZ pictures, pgfplots (function plots, bar charts, 3D surfaces), tikz-cd, circuitikz, chemfig, tikz-3dplot, and
tabular. - The engine (about 7 MB) is fetched the first time a figure needs it; a figure then takes roughly 0.2 to 9 seconds, and is cached.
Diagrams, charts and more
| Fence | Draws | Library |
|---|---|---|
mermaid |
flowcharts, sequence, gantt, class, state… | Mermaid |
dot |
graphs with automatic layout | Graphviz (viz-js) |
vega-lite |
charts from a JSON spec | Vega-Lite |
abc |
sheet music | abcjs |
smiles |
a molecule from one line of text | SmilesDrawer |
svg |
raw SVG, with scripts and handlers removed | DOMPurify |
Each library is fetched only when a block first needs it.
Built for model output
- Safe by default. MathJax runs with its
safeextension; every figure is sanitised before it is cached or shown; charts cannot fetch remote data. See security. - Forgiving. Whole LaTeX documents, stray
\usepackagelines and bare environments are all handled. - Streaming-friendly. One cache serves every re-render; unclosed blocks stay as code.
Options
md.use(latexPlus, {
delimiters: 'all', // 'all' | 'dollars' | 'brackets'
environments: true, // bare \begin{align}…\end{align}
blocks: { mermaid: false }, // switch individual fences off
packages: ['physics'], // extra MathJax packages
macros: { RR: '\\mathbb{R}' },
libs: { mermaid: () => import('mermaid') }, // bring your own copy instead of the CDN
})
Everything else is in the docs:
- Syntax: delimiters, rules and limits
- Figures: every fenced block, with examples
- API: options, methods, server rendering, custom blocks
- Engines: versions, sizes, licences, self-hosting
- Security: what is sanitised and how it is tested
Development
npm install && npm test # Node tests
cd site && npm install && npm run dev
node scripts/e2e.js # browser tests against the running site
node scripts/shots.js # redraw the images in this README
Licence
MIT-0: use it however you like, no attribution needed. The engines it loads at runtime keep their own licences, listed in engines.



