Documents your agent can write, check and typeset without TeX.

Read https://sophiaxt.com/texwright/AGENTS.md and use texwright to make PDFs from Markdown or LaTeX.

Install from this page

npm installs straight from the tarball here. Nothing to register, nothing else to download.

npm install -g https://sophiaxt.com/texwright/texwright-latest.tgz

texwright doc.md -o doc.pdf

Or unzip and run

The zip is the same package. Unzip it anywhere with Node.js 20 or later and run it in place.

node texwright/dist/cli.mjs doc.md -o doc.pdf

As an MCP server

Nine tools: render, check, fix, repair in one call, outline, preview a page as PNG, the schema, the guide, and new documents from templates.

{
  "mcpServers": {
    "texwright": { "command": "texwright", "args": ["mcp"] }
  }
}

A fenced mermaid block becomes a numbered figure. texwright reads Mermaid's syntax with its own parsers and lays the diagram out itself: no browser, a few milliseconds per diagram, labels set in the sans companion of Computer Modern so they match the page. A mistake comes back as DIAG001 at its line, with a hint and usually the fix.

• Flowcharts
• Sequence
• Class
• State
• ER
• Gantt
• Pie
• XY charts
• Quadrant
• Timeline
• Mindmap
• Journey

```{.mermaid #fig:flow caption="Request handling"}
flowchart LR
  client([Client]) --> api[API] -->|query| db[(Database)]
```

TikZ and pgfplots go through texwright's own interpreter: paths, nodes and shapes, styles, \foreach, positioning and calc, automata, and axes with plots, bars, legends and log scales. Labels use the document's math, so they match the equations around them.

doc.md:3:5 E REF001 Reference to undefined label "sec:intr" | Did you mean "sec:intro"? | fix "sec:intr" -> "sec:intro" safe

01 · Check

Every stage but page layout, in milliseconds. One line per problem, with a code, a position and a hint.

texwright check doc.md --diagnostics compact

02 · Fix

Most diagnostics carry their fix as an edit. The unambiguous ones apply in one go.

texwright check doc.md --fix

03 · Render

The result says which page each heading, figure and table landed on.

texwright doc.md -o doc.pdf

04 · Look

The page as a PNG from texwright's own rasterizer, so the agent can see what it made.

texwright preview doc.md --page 2