Write readable equations in Markdown

Use inline and display math, define variables and units, then inspect the result in Read, Split and PDF.

Keep the formula beside its explanation and a small numerical check. A correct equation can still be a poor explanation if the symbols are undefined.

Use inline math for a short expression

The mean temperature is $\bar{x}$, measured in °C.
We collected $n = 3$ readings.

Use a short inline expression inside a sentence. If it is tall, wide or central to the argument, give it a display block.

Use display math for a full formula

$$
\bar{x} = \frac{1}{n} \sum_{i=1}^{n} x_i
$$

Here xᵢ is reading i and n is the number of readings. For 18.2, 18.6 and 18.4 °C, the mean is 18.4 °C. Check the units and the numerical example against the expression.

Download the equation and worked readings

Inspect the rendered equation

iPad: a display equation below a sequence diagram in the Midnight theme.
iPad: a display equation below a sequence diagram in the Midnight theme.

Use Read for the finished page and Split to compare source with output. Keep a display equation between matching $$ lines. Fenced equations remain available in both parsing modes; ordinary Markdown grammar differs between the two modes.

Reduce an equation that fails

Check matching delimiters and braces first. Try x^2, then restore one command at a time. Supported LaTeX notation is not the same as a full TeX document processor: packages, custom macros and document layout instructions may not apply. A code block may simply display literal source.

Check the final destination

Preview the PDF at its final paper size, especially for long aligned expressions. When sharing Markdown, check the recipient’s math syntax support. Keep definitions in prose so the argument is understandable even where a renderer does not display the formula.

Try it in Telescopo

Explore the included sample documents for free. Opening and reading your own Markdown files, diagrams, and equations is free. Writing, conversion on supported hardware, and export require paid access. See access and subscription details.

Download Telescopo