Two rendering paths, one document

There are two ways a converter can turn $...$ into a formula:

  • Browser math (KaTeX or MathJax): fast, keeps a real text layer, and handles the delimiters most Markdown authors actually write.
  • A real TeX toolchain: slower, but it understands environments that browser renderers do not implement.

The practical rule: use browser math by default, and send the document to the TeX path when it needs a package-level feature. A converter that only has one of the two paths will either reject valid documents or silently degrade them.

What breaks on paper

Symptom Cause What to check
Subscripts disappear into the line Formula scaled down to fit Is the display equation measured against the printable width
Symbols render as boxes Font missing a glyph Are math fonts embedded in the PDF
Equations are images Math rasterised for speed Can you select or search the formula text

The third one matters beyond looks: an image of a formula cannot be searched, copied into a ticket, or read by a screen reader.

A display equation, unchanged

$$ \mathcal{L}(\theta)=\frac{1}{N}\sum_{i=1}^{N}\ell\left(y_i, f_\theta(x_i)\right) $$

In the exported PDF this should stay a single display block, keep its text layer, and scale as a unit if it is wider than the page.

Formula in a table cell

Symbol Meaning Value
$\lambda$ weight decay 0.01
$\alpha$ learning rate 3e-4

Cell formulas are where converters most often give up: the math renderer wants a block, the table wants an inline run. If a converter drops formulas in cells, it will also struggle with inline math in lists and headings.

A short checklist

  1. Print a page with a subscript-heavy formula. Screen rendering hides how small subscripts become.
  2. Search for a symbol in the PDF. If the find box cannot locate $\lambda$, the formula is an image.
  3. Export one over-wide equation. It should scale, not clip.
  4. Break a macro on purpose. You want a diagnostic or a TeX fallback, not raw source text.

Try it with your own equations

The formula sample below covers both rendering paths. If you want a document that already has display math, an aligned environment and a formula inside a table, open the formula sample and export it before pasting your own.

For formulas mixed with diagrams and tables, use the same editor and review the PDF feature set.

What we do not claim

Not every LaTeX package is available on the TeX path, and unsupported macros are reported instead of silently replaced. Browser math and TeX math can produce slightly different spacing; the document keeps whichever path it was exported with.

This article is one part of a wider checklist: Markdown to PDF: tables, diagrams and equations covers tables, diagrams and equations together, and how to decide what to fix first.