Zettelmarkup: Math-mode Blocks

00001007031400 · Info · (manual) · #manual #zettelmarkup #zettelstore

Math-mode blocks are used to enter mathematical formulas / equations in a display style mode. Similar to a evaluation blocks, the block content will be interpreted by either Zettelstore or an external software. They begin with at least three dollar sign characters ($, U+0024) at the first position of a line.

You can add some attributes on the beginning line of a verbatim block, following the initiating characters. A math-mode block supports the default attribute1: when given, all spaces in the text are rendered in HTML as open box characters (U+2423). If you want to give only one attribute and this attribute is the generic attribute, you can omit the most of the attribute syntax and just specify the value. It will be interpreted as a syntax value to evaluate its content. Alternatively, you could provide an attribute with the key syntax and use the value to specify the syntax. Not all syntax values are supported by Zettelstore.2 External software might support several values via the ZJSON encoding.

Any other character in this line will be ignored

Text following the beginning line will not be interpreted, until a line begins with at least the same number of the same characters given at the beginning line. This allows to enter some dollar-sign characters in the text that should not be interpreted.

For example:

$$$$
$$$
$$$$

will be rendered in HTML as:

$$$
$$${-}
This is  some
text with no 
  real sense.
$$$$

will be rendered as:

This is  some
text with no 
  real sense.

In the future, Zettelstore might somehow support mathematical formulae with a \TeX-like syntax. Until then,

$$$
\begin{align*}
  f(x) &= x^2\\
  g(x) &= \frac{1}{x}\\
  F(x) &= \int^a_b \frac{1}{3}x^3
\end{align*}
$$$

is rendered as:

\begin{align*}
  f(x) &= x^2\\
  g(x) &= \frac{1}{x}\\
  F(x) &= \int^a_b \frac{1}{3}x^3
\end{align*}
  1. Depending on the syntax value. ↩︎
  2. Currently: none. ↩︎