Back to Research

TikZ Editor Turns LaTeX Figures Visual

TikZ Editor lets LaTeX authors drag figures visually while keeping source code readable and reviewable.

Panoramic View of the Ile-de-France, landscape painting by Théodore Rousseau (1830).
Rogier MullerJuly 6, 20268 min read

TikZ Editor is an open-source web and desktop editor for TikZ figures, published at tikz.dev by its maintainer as a visual companion to LaTeX drawing code. It deals with a very specific pain: academic diagrams often require hand-tuning coordinates, recompiling, and guessing where a line or label will land. The takeaway is bigger than LaTeX: visual editing is most valuable when it preserves the source humans still need to review. The lesson for ai coding for teams is the same: generated or assisted code has to remain editable after the magic moment passes.

Watch the drawing and the source together

TikZ is a LaTeX package for drawing figures with commands, coordinates, shapes, labels, loops, and styles. A tiny line can look like \draw[->] (0,0) -- (1,2);, and a real paper figure can become a dense little program.

TikZ Editor’s useful trick is not merely that you can drag a line. It shows the visual figure and the TikZ source side by side, so the author can move an element while still seeing the code that changed.

That matters because TikZ users are not trying to export a disposable PNG. They usually want a figure that lives with the paper, matches the document style, compiles in CI, and survives review comments from a co-author six months later.

The trap is assuming WYSIWYG means code stops mattering. For this kind of work, the code is the artifact. The visual surface is a better handle on it.

We covered the basic project shape in TikZ Editor Makes LaTeX Figures Draggable; the sharper point here is round-trip editing.

Keep old figures out of generated-looking soup

The most interesting objection around the project was not about whether visual drawing is nice. It was about whether TikZ Editor can touch an old hand-written figure without turning it into generated-looking soup.

That is the right fear. A visual editor that rewrites a clean file into hundreds of anonymous coordinates may save ten minutes today and cost hours later.

A good test is boring and brutal: open an existing figure, move one label, and inspect the diff. If the change is local and readable, the editor earned trust. If the whole file churns, the editor may still be useful for drafts, but not for maintained paper figures.

This is the same review muscle developers need in ai software development. Whether the code came from a visual editor, AI pair programming, or plain autocomplete, the diff should explain itself.

Notice the Typst question without dodging it

Another fair question was whether this could support CeTZ, the Typst ecosystem’s drawing package. That question says something real: many researchers like the idea of programmable figures but would rather not live in LaTeX forever.

TikZ Editor is still a TikZ project. That focus is a strength if your repository already has .tex figures and LaTeX build steps. It is less compelling if your writing system has moved to Typst and the cost is not diagram editing, but LaTeX itself.

The trap is asking one tool to become every drawing language. A focused editor can preserve idioms better than a universal converter. For teams maintaining papers, lectures, or docs, language fidelity usually beats format ambition.

Try it when the figure is the code

Try TikZ Editor when the figure already belongs in LaTeX, the source will be reviewed, and small layout changes are eating the most time. It is especially interesting for old diagrams that people avoid touching because nobody remembers which coordinate controls what.

It is overkill for throwaway whiteboard sketches, marketing diagrams, or images that will never be compiled with the document. It is also risky if your only success metric is a pretty preview and nobody checks the generated diff.

For Claude Code, Anthropic’s coding agent, the useful pattern is to keep the agent on review and cleanup, not on blindly redrawing the figure. A small slash-command workflow is enough:

/figure-review
Input: figures/system-architecture.tex
Goal: explain the diff after a visual edit
Boundary: do not rewrite the figure from scratch
Check: local coordinate changes, style reuse, compile errors, label drift
Output: short review note plus any minimal cleanup patch

If the repo uses an external document store through MCP, keep that connection read-only for this task. The agent may read the paper style guide or previous figures, but it should not mutate manuscript files during the first pass.

For broader agentic coding habits, keep the figure workflow separate from the related training topic. A drawing editor is not a codebase policy. It is a useful pressure test for whether your code review guardrails still work when the code was produced through another surface.

Try it safely: fit decision table

Use this table before you point a visual editor, an AI coding assistant, or any code generation tool at a maintained figure.

Situation Try TikZ Editor? What to check before keeping the change
A hand-written TikZ figure needs one label moved Yes The diff changes only the expected node or coordinate.
A complex paper diagram has overlapping arrows Yes Styles and named coordinates stay readable after editing.
A new figure is being sketched from nothing Maybe Decide early whether the final source must be hand-maintainable.
The repo has strict LaTeX CI Yes, carefully Compile the paper after the edit, not just the single figure preview.
The document has moved to Typst or CeTZ Probably not Use a native tool unless TikZ compatibility is the real requirement.
The figure is a one-off image export Probably overkill A general diagramming tool may be faster and simpler.
Claude Code is asked to clean the result Yes, bounded Ask for a diff review and minimal patch, not a full redraw.

The smallest safe experiment is one old figure, one visual move, one compile, and one human diff review. If that feels calm, widen the use case.

One methodology lens

One useful way to read this through our methodology is the Plan step: delegate first-pass decomposition and dependency mapping, review the sequencing and assumptions, and keep ownership of scope and priorities. If that split is still fuzzy, the workflow usually is too.

Practical starter checklist

- [ ] Name the Claude Code artifact first: a hook boundary, an MCP permission note, a slash-command workflow, a Claude skill outline, a review checklist, or a concise CLAUDE.md note when repository memory is the topic.
- [ ] Write the review checklist before generation starts: scope, owner, tests, rollback.
- [ ] Keep the first step small enough that a reviewer can inspect the receipt without replaying the whole chat.

Common questions

  • What should teams know about ai coding?

    Start by writing down one visible team rule for Claude Code, not a loose preference. That is the practical core of ai software development. That usually means a short repository convention, a review checklist, and one owner who can reject agent output when the evidence is missing.

  • Which Claude Code artifact should teams standardize first?

    Standardize the smallest artifact that reviewers already touch: a hook checklist, MCP permission rule, slash-command workflow, skill outline, or concise CLAUDE.md note. The point is not documentation volume; it is a shared place where scope, allowed tools, expected tests, and rollback notes are visible before generated code reaches review.

  • How do teams know the convention is working?

    The convention is working when reviewers can approve or reject agent output from the artifact and evidence alone. Track whether pull requests name the rule used, include the promised checks, and avoid replaying long sessions just to understand what changed.

Best ways to use this research

  • Best for: Claude Code teams deciding which hook, skill, MCP boundary, slash-command workflow, review habit, or repository-memory convention to standardize next around “TikZ Editor Turns LaTeX Figures Visual.”
  • Best first artifact: turn the named fix into a hook checklist, skill note, MCP permission note, review receipt, or concise CLAUDE.md convention when repository memory is the real topic before the next automated run.
  • Best comparison angle: compare the workflow against the current Claude Code handoff, hook behavior, and MCP scope; keep the path that leaves the shortest auditable trail.

Further reading

Where to go next

Start from the related training topic and make the first exercise prove scope, verification, and ownership in the PR body.

Related training topics

Related research

Continue through the research archive

Ready to start?

Transform how your team builds software.

Get in touch