(((meta (@ (content . "Zettelmarkup: Math-mode Blocks") (name . "title"))) (meta (@ (content . "manual") (name . "role"))) (meta (@ (content . "#manual #zettelmarkup #zettelstore") (name . "tags"))) (meta (@ (content . "zmk") (name . "syntax"))) (meta (@ (content . "00001007030000 00001012920513") (name . "back"))) (meta (@ (content . "00001007030000 00001012920513") (name . "backward"))) (meta (@ (content . "1") (name . "box-number"))) (meta (@ (content . "(c) 2020-present by Detlef Stern <ds@zettelstore.de>") (name . "copyright"))) (meta (@ (content . "20220311173226") (name . "created"))) (meta (@ (content . "00001007031300 00001007050000 00001008000000 00001012920516") (name . "forward"))) (meta (@ (content . "en") (name . "lang"))) (meta (@ (content . "EUPL-1.2-or-later") (name . "license"))) (meta (@ (content . "20230109105340") (name . "modified"))) (meta (@ (content . "20230109105340") (name . "published"))) (meta (@ (content . "public") (name . "visibility")))) (p "Math-mode blocks are used to enter mathematical formulas / equations in a display style mode." " " "Similar to a " (a (@ (href . "00001007031300")) "evaluation blocks") ", the block content will be interpreted by either Zettelstore or an external software." " " "They begin with at least three dollar sign characters (" (@L (@H "&ldquo;") (kbd "$") (@H "&rdquo;")) ", U+0024) at the first position of a line.") (p "You can add some " (a (@ (href . "00001007050000")) "attributes") " on the beginning line of a verbatim block, following the initiating characters." " " "A math-mode block supports the default attribute" (sup (@ (id . "fnref:1")) (a (@ (class . "zs-noteref") (href . "#fn:1") (role . "doc-noteref")) "1")) ": 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 " (a (@ (href . "00001008000000")) "syntax") " value to evaluate its content." " " "Alternatively, you could provide an attribute with the key " (@L (@H "&ldquo;") "syntax" (@H "&rdquo;")) " and use the value to specify the syntax." " " "Not all syntax values are supported by Zettelstore." (sup (@ (id . "fnref:2")) (a (@ (class . "zs-noteref") (href . "#fn:2") (role . "doc-noteref")) "2")) " " "External software might support several values via the " (a (@ (href . "00001012920516")) "sz encoding") ".") (p "Any other character in this line will be ignored") (p "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.") (p "For example:") (pre (code (@ (class . "language-zmk")) "$$$$\n$$$\n$$$$")) (p "will be rendered in HTML as:") (div (@ (class . "example")) (pre (code (@ (class . "zs-math")) "$$$"))) (pre (code (@ (class . "language-zmk")) "$$${-}\nThis is  some\ntext with no \n  real sense.\n$$$$")) (p "will be rendered as:") (div (@ (class . "example")) (pre (code (@ (class . "zs-math")) "This is  some\ntext with no \n  real sense."))) (p "In the future, Zettelstore might somehow support mathematical formulae with a " (code (@ (class . "zs-math")) "\\TeX") "-like syntax." " " "Until then,") (pre (code (@ (class . "language-zmk")) "$$$\n\\begin{align*}\n  f(x) &= x^2\\\\\n  g(x) &= \\frac{1}{x}\\\\\n  F(x) &= \\int^a_b \\frac{1}{3}x^3\n\\end{align*}\n$$$")) (p "is rendered as:") (div (@ (class . "example")) (pre (code (@ (class . "zs-math")) "\\begin{align*}\n  f(x) &= x^2\\\\\n  g(x) &= \\frac{1}{x}\\\\\n  F(x) &= \\int^a_b \\frac{1}{3}x^3\n\\end{align*}"))))