Notes → PNG (KaTeX + headless Brave)#

Core rule#

• Default: reply as normal text
• Render a PNG only when explicitly requested ("as an image", "KaTeX skill", "нормально записанное решение") or when high-quality formula layout is needed
• If using this skill → write formulas in LaTeX ( $...$, $$...$$), not ASCII approximations
• Inside the PNG: Markdown headings ( #, ##) are NOT parsed. Use --title="..." for the page title; use plain text for section headers (e.g., 1) ...)

Input format#

• Save a UTF-8 text file (e.g. out/_scratch/notes/note.md)
• Inline math: $...$
• Display math: blocks between lines containing $$

Details: references/formatting.md

Render to PNG#

Scripts:

• scripts/render_note_png.js — single-page PNG
• scripts/render_note_pages.sh — multi-page (splits into multiple PNGs)

Single-page steps:

1. Write your note (e.g. out/_scratch/notes/note.md)

2. Render (keep outputs in out/ to avoid cluttering repo root):

   • node skills/math-notes-katex/scripts/render_note_png.js out/_scratch/notes/note.md out/katex/note.png --title="Topic" --brave=/usr/bin/brave-browser

3. Send out/katex/note.png

Multi-page (when the note does not fit well into one image):

bash

skills/math-notes-katex/scripts/render_note_pages.sh \
  out/_scratch/notes/note.md out/katex/note_pages "Topic" /usr/bin/brave-browser

This produces:

• out/katex/note_pages/page-001.png, page-002.png, ...

Important: KaTeX CSS/fonts#

• KaTeX needs katex.min.css + fonts ( fonts/...)
• This skill links KaTeX CSS via a local file:///.../katex.min.css path so relative fonts/ resolve correctly

If formulas look broken: references/troubleshooting.md