summaryrefslogtreecommitdiff
path: root/macros/generic
diff options
context:
space:
mode:
Diffstat (limited to 'macros/generic')
-rw-r--r--macros/generic/markdown/CHANGES.md104
-rw-r--r--macros/generic/markdown/README.md112
-rw-r--r--macros/generic/markdown/VERSION2
-rw-r--r--macros/generic/markdown/docstrip.cfg6
-rw-r--r--macros/generic/markdown/examples/optex.tex7
-rw-r--r--macros/generic/markdown/markdown.dtx4540
-rw-r--r--macros/generic/markdown/markdown.html8854
-rw-r--r--macros/generic/markdown/markdown.ins9
-rw-r--r--macros/generic/markdown/markdown.pdfbin1114115 -> 1156338 bytes
-rw-r--r--macros/generic/witharrows/witharrows-french.pdfbin279271 -> 531626 bytes
-rw-r--r--macros/generic/witharrows/witharrows-french.tex1641
-rw-r--r--macros/generic/witharrows/witharrows.dtx1580
-rw-r--r--macros/generic/witharrows/witharrows.ins4
-rw-r--r--macros/generic/witharrows/witharrows.pdfbin559985 -> 1135701 bytes
14 files changed, 9363 insertions, 7496 deletions
diff --git a/macros/generic/markdown/CHANGES.md b/macros/generic/markdown/CHANGES.md
index 922aadff91..1b32517f09 100644
--- a/macros/generic/markdown/CHANGES.md
+++ b/macros/generic/markdown/CHANGES.md
@@ -1,5 +1,109 @@
# Changes
+## 3.7.1 (2024-09-30)
+
+Development:
+
+- Remove dependency on `UnicodeData.txt`. (#400, #458 #486, #492, #499)
+
+ This change improves the speed of parsing markdown input by up to 25%
+ for a cold conversion run and makes life easier for users of TeX
+ distributions other than TeX Live, such as MikTeX and ConTeXt Standalone,
+ where `UnicodeData.txt` may not be as easily available. This change also
+ adds a new file `markdown-unicode-data.lua`, which must be properly
+ installed with the rest of the Markdown package.
+
+- Add renderers `warning` and `error` that represent warnings and errors
+ produced by the markdown parser. (#452, #473, #496)
+
+Fixes:
+
+- Properly load LaTeX themes when `theme` or `import` is used in
+ `\usepackage[...]{markdown}`. (#471, #498)
+
+- Prevent endless loop when setting deprecated `jekyllDataString` (renderer)
+ prototype. (#500)
+
+- Correctly handle backslashes in `\markdownOptionOutputDir` on Windows.
+ (#492, #500, reported by @l0th3r)
+
+- Fix hard line breaks in blockquotes.
+ (#494, #495, reported by @l0th3r, #496, contributed by @lostenderman)
+
+Deprecation:
+
+- Soft-deprecate the `hybrid` option. (#470, #504, 546faa87)
+
+ Soft-deprecated features will never be removed but using them prints a
+ warning and is discouraged. Instead of the `hybrid` option, consider one of
+ the following better alternatives for mixing TeX and markdown:
+
+ - With the `contentBlocks` option, authors can move large blocks of TeX
+ code to separate files and include them in their markdown documents as
+ external resources.
+
+ - With the `rawAttribute` option, authors can denote raw text spans and
+ code blocks that will be interpreted as TeX code.
+
+ - With options `texMathDollars`, `texMathSingleBackslash`, and
+ `texMathDoubleBackslash`, authors can freely type TeX commands between
+ dollar signs or backslash-escaped brackets.
+
+ For more information, see the user manual at
+ <https://witiko.github.io/markdown/>.
+
+## 3.7.0 (2024-08-30)
+
+Development:
+
+- Add renderer `jekyllDataProgrammaticString` for processing YAML
+ string scalars that do not contain markdown markup and are not
+ intended for typesetting.
+ (istqborg/istqb_product_base#46, #440, #451, sponsored by @istqborg)
+- Add option `ensureJekyllData` for processing standalone YAML files.
+ (#452, #473, sponsored by @istqborg)
+- Support user-defined LaTeX environments with LaTeX markup.
+ (#20, #477, suggested by @cdupont)
+
+Fixes:
+
+- Produce more meaningful error message when KPathSea fails to
+ locate a file. (#458, #472, 33e6eef2, reported by @Yggdrasil128)
+- Fix soft line breaks in citation prenotes and postnotes.
+ (#483, #484, contributed by @lostenderman)
+
+Speed improvements:
+
+- Precompile snippets to improve the speed of setting them.
+ (#467, #479, inspired by the TUG 2024 talk by @josephwright)
+- Use an optimized parser to determine Unicode punctuation.
+ (#458, #474, #482, 4c1a7de2, co-authored by @Yggdrasil128,
+ sponsored by @istqborg)
+ This improves the speed of parsing markdown input by up to 500%.
+- Enable option `eagerCache` by default. (#468, #490, sponsored by @istqborg)
+ This improves the speed by up to 25% for large documents with many
+ markdown fragments that require multiple compilation runs.
+- Prevent loading the full Markdown package when converting cached markdown
+ fragments. (#487, #491, 40f0803f, 6609d43d, sponsored by @istqborg)
+ This significantly improves the speed for large documents with many
+ markdown fragments that require multiple compilation runs in pdfTeX.
+
+Deprecation:
+
+- Deprecate `jekyllDataString` renderer and renderer prototype.
+ (istqborg/istqb_product_base#46, #440, #451, sponsored by @istqborg)
+ Users should use `jekyllDataTypographicString` instead.
+
+Continuous Integration:
+
+- Ensure that all code lines are shorter than 72 characters.
+ (#478, e7160d60, 3ac95efe)
+
+Experiments:
+
+- Measure the speed of the Markdown package across recent versions.
+ (249552e5, 55ede824, efeaecbe, #474, 7b2b2431, fcf0064c)
+
## 3.6.2 (2024-07-14)
Fixes:
diff --git a/macros/generic/markdown/README.md b/macros/generic/markdown/README.md
index 2a02ee9736..fc65a0b689 100644
--- a/macros/generic/markdown/README.md
+++ b/macros/generic/markdown/README.md
@@ -1,5 +1,5 @@
-Markdown
-========
+The Markdown Package for TeX
+============================
[![license](https://img.shields.io/github/license/witiko/markdown)](LICENSE)
[![ci](https://github.com/witiko/markdown/actions/workflows/main.yml/badge.svg)][ci]
@@ -94,7 +94,7 @@ jobs:
container:
image: witiko/markdown:latest
steps:
- - uses: actions/checkout@v2
+ - uses: actions/checkout@v4
- run: latexmk -lualatex document.tex
- uses: marvinpinto/action-automatic-releases@latest
permissions:
@@ -115,52 +115,6 @@ In fact, this is how we automatically produce
[github-actions]: https://docs.github.com/actions "GitHub Actions Documentation"
-Peek under the hood
--------------------
-
-Remember how we said that the Markdown package converts markdown markup to
-TeX commands? Let's see what that means and what we can do with this knowledge.
-
-Using a text editor, create an empty text document named `document.md` with
-the following markdown content:
-
-``` markdown
-Hello *Markdown*! $a_x + b_x = c_x$
-```
-
-Next, run [the Lua command-line interface (CLI)][lua-cli] from
-[our official Docker image][docker-witiko/markdown] on `document.md`:
-
- docker run --rm -i witiko/markdown markdown-cli hybrid=true < document.md
-
-We will receive the following output, where the markdown markup has been
-replaced by TeX commands:
-
-``` tex
-\markdownDocumentBegin
-Hello \markdownRendererEmphasis{Markdown}!
-$a\markdownRendererEmphasis{x + b}x = c_x$
-\markdownDocumentEnd
-```
-
-We can see right away that the Markdown package has incorrectly interpreted
-`_x + b_` as an emphasized text. We can fix this by passing in the
-`underscores=false` option:
-
- docker run --rm -i witiko/markdown markdown-cli hybrid=true underscores=false < document.md
-
-``` tex
-\markdownDocumentBegin
-Hello \markdownRendererEmphasis{Markdown}!
-$a_x + b_x = c_x$
-\markdownDocumentEnd
-```
-
-Much better! If the Markdown package ever surprises you, use the Lua CLI to
-peek under the hood and inspect the results of the conversion.
-
- [lua-cli]: https://mirrors.ctan.org/macros/generic/markdown/markdown.html#lua-command-line-interface "Markdown Package User Manual"
-
Further information
-------------------
@@ -194,7 +148,7 @@ For further information, consult one of the following:
- [Attributes in Markdown][tb136],
- [Markdown 3 at TUG 2023: Reflections from the Q&A session][tb138],
- Fast Regression Testing of TeX Packages: The Unreasonable Effectiveness of Batching ([preprint][tb139]), and
- - Markdown Themes in Practice ([preprint][tb140]).
+ - Markdown Themes in Practice ([preprint][tb140-preprint], [work in progress][tb140]).
5. Journal articles published by [CSTUG Bulletin][csbul] (in Czech and Slovak):
- [Rendering Markdown inside TeX Documents][10.5300/2016-1-4/78],
- [Markdown 2.8.1: Boldly Unto the Throne of Lightweight Markup in TeX][10.5300/2020-1-2/48],
@@ -204,11 +158,12 @@ For further information, consult one of the following:
- [Markdown 3: What's New, What's Next?][10.5300/2023-3-4/111].
6. Talks:
- [Five Years of Markdown in LaTeX: What, Why, How, and Whereto][pv212-fall2020] (in Czech),
- - [Markdown 2.10.0: LaTeX Themes & Snippets, Two Flavors of Comments, and LuaMetaTeX][tb131-video] ([slides][tb131-slides]),
+ - [Markdown 2.10.0: LaTeX Themes & Snippets, Two Flavors of Comments, and LuaMetaTeX][tb131-video] ([mirror][tb131-video-mirror], [slides][tb131-slides]),
- [A Self-Publisher's Take on Markdown and TeX][tb134-01-video] ([slides][tb134-01-slides]),
- [A Gentle Introduction to Markdown for Writers][tb134-02-video] ([slides][tb134-02-slides], [example][tb134-02-example]),
- - [Markdown 3: What's New, What's Next?][tb137-video] ([slides][tb137-slides]), and
- - An Implementation of the CommonMark Standard and new Syntax Extensions to the Markdown Package for TeX ([slides][gencur-defense-slides]).
+ - [Markdown 3: What's New, What's Next?][tb137-video] ([mirror][tb137-video-mirror], [slides][tb137-slides]),
+ - An Implementation of the CommonMark Standard and new Syntax Extensions to the Markdown Package for TeX ([slides][gencur-defense-slides]), and
+ - [Markdown Themes in Practice][tb140-video] ([preprint][tb140-preprint], [slides][tb140-slides])
7. Theses:
- [Generic TeX Writer for the Pandoc Document Converter][thesis-umhg5]
- [An implementation of the CommonMark standard into the Markdown package for TeX][thesis-r7z7l]
@@ -220,26 +175,31 @@ For further information, consult one of the following:
[overleaf-5]: https://www.overleaf.com/latex/examples/writing-posters-with-markdown/jtbgmmgqrqmh "Writing Posters with Markdown"
[overleaf-6]: https://www.overleaf.com/latex/examples/using-markdown-in-latex-documents/whdrnpcpnwrm "Using Markdown in LaTeX documents"
- [tb119]: https://www.tug.org/TUGboat/tb38-2/tb119novotny.pdf "Using Markdown inside TeX documents"
- [tb124]: https://www.tug.org/TUGboat/tb40-1/tb124novotny-markdown.pdf "Markdown 2.7.0: Towards lightweight markup in TeX"
- [tb129]: https://www.tug.org/TUGboat/tb41-3/tb129novotny-frozen.pdf "Making Markdown into a Microwave Meal"
- [tb131]: https://www.tug.org/TUGboat/tb42-2/tb131novotny-markdown.pdf "Markdown 2.10.0: LaTeX Themes & Snippets, Two Flavors of Comments, and LuaMetaTeX"
- [tb133]: https://www.tug.org/TUGboat/tb43-1/tb133novotny-markdown.pdf "Markdown 2.15.0: What's New?"
- [tb135]: https://www.tug.org/TUGboat/tb43-3/tb135novotny-markdown.pdf "Markdown 2.17.1: What's New, What's Next?"
- [tb136]: https://www.tug.org/TUGboat/tb44-1/tb136novotny-markdown-attr.pdf "Attributes in Markdown"
- [tb138]: https://www.tug.org/TUGboat/tb44-3/tb138starynovotny-markdown-qa.pdf "Markdown 3 at TUG 2023: Reflections from the Q&A session"
- [tb139]: https://github.com/Witiko/fast-regression-testing/releases/download/latest/tb139starynovotny-testing.pdf "Fast Regression Testing of TeX Packages: The Unreasonable Effectiveness of Batching"
- [tb140]: https://www.tug.org/tug2024/preprints/starynovotny-markdown-themes.pdf "Markdown Themes in Practice"
-
- [tb131-slides]: https://tug.org/tug2021/assets/pdf/tug2021-novotny-slides.pdf "Markdown 2.10.0: LaTeX Themes & Snippets, Two Flavors of Comments, and LuaMetaTeX"
- [tb131-video]: https://youtu.be/i2GJMnLCZls "Markdown 2.10.0: LaTeX Themes & Snippets, Two Flavors of Comments, and LuaMetaTeX"
- [tb134-01-slides]: https://tug.org/tug2022/assets/served/Lloyd_Prentice-TUG2022-prentice-selfpub-slides.pdf "A Self-Publisher's Take on Markdown and TeX"
- [tb134-01-video]: https://youtu.be/OhwzT3TcLj8 "A Self-Publisher's Take on Markdown and TeX"
- [tb134-02-slides]: https://tug.org/tug2022/assets/pdf/Tereza_Vrabcová-TUG2022-slides.pdf "A Gentle Introduction to Markdown for Writers"
- [tb134-02-example]: https://tug.org/tug2022/assets/pdf/Tereza_Vrabcová-TUG2022-example.pdf "A Gentle Introduction to Markdown for Writers"
- [tb134-02-video]: https://youtu.be/FhN_x9rsR4M "A Gentle Introduction to Markdown for Writers"
- [tb137-slides]: https://tug.org/tug2023/files/sa-03-novotny-markdown3/novotny-markdown3-slides.pdf "Markdown 3: What's New, What's Next?"
- [tb137-video]: https://youtu.be/U8XjTOhJkg0 "Markdown 3: What's New, What's Next?"
+ [tb119]: https://www.tug.org/TUGboat/tb38-2/tb119novotny.pdf "Using Markdown inside TeX documents"
+ [tb124]: https://www.tug.org/TUGboat/tb40-1/tb124novotny-markdown.pdf "Markdown 2.7.0: Towards lightweight markup in TeX"
+ [tb129]: https://www.tug.org/TUGboat/tb41-3/tb129novotny-frozen.pdf "Making Markdown into a Microwave Meal"
+ [tb131]: https://www.tug.org/TUGboat/tb42-2/tb131novotny-markdown.pdf "Markdown 2.10.0: LaTeX Themes & Snippets, Two Flavors of Comments, and LuaMetaTeX"
+ [tb133]: https://www.tug.org/TUGboat/tb43-1/tb133novotny-markdown.pdf "Markdown 2.15.0: What's New?"
+ [tb135]: https://www.tug.org/TUGboat/tb43-3/tb135novotny-markdown.pdf "Markdown 2.17.1: What's New, What's Next?"
+ [tb136]: https://www.tug.org/TUGboat/tb44-1/tb136novotny-markdown-attr.pdf "Attributes in Markdown"
+ [tb138]: https://www.tug.org/TUGboat/tb44-3/tb138starynovotny-markdown-qa.pdf "Markdown 3 at TUG 2023: Reflections from the Q&A session"
+ [tb139]: https://github.com/Witiko/fast-regression-testing/releases/download/latest/tb139starynovotny-testing.pdf "Fast Regression Testing of TeX Packages: The Unreasonable Effectiveness of Batching"
+ [tb140]: https://github.com/Witiko/markdown-themes-in-practice/releases/download/latest/tb140starynovotny-markdown-themes.pdf "Markdown Themes in Practice"
+
+ [tb131-slides]: https://tug.org/tug2021/assets/pdf/tug2021-novotny-slides.pdf "Markdown 2.10.0: LaTeX Themes & Snippets, Two Flavors of Comments, and LuaMetaTeX"
+ [tb131-video]: https://youtu.be/i2GJMnLCZls "Markdown 2.10.0: LaTeX Themes & Snippets, Two Flavors of Comments, and LuaMetaTeX"
+ [tb131-video-mirror]: https://youtu.be/THmPkAncMnc "Markdown 2.10.0: LaTeX Themes & Snippets, Two Flavors of Comments, and LuaMetaTeX (mirror)"
+ [tb134-01-slides]: https://tug.org/tug2022/assets/served/Lloyd_Prentice-TUG2022-prentice-selfpub-slides.pdf "A Self-Publisher's Take on Markdown and TeX"
+ [tb134-01-video]: https://youtu.be/OhwzT3TcLj8 "A Self-Publisher's Take on Markdown and TeX"
+ [tb134-02-slides]: https://tug.org/tug2022/assets/pdf/Tereza_Vrabcová-TUG2022-slides.pdf "A Gentle Introduction to Markdown for Writers"
+ [tb134-02-example]: https://tug.org/tug2022/assets/pdf/Tereza_Vrabcová-TUG2022-example.pdf "A Gentle Introduction to Markdown for Writers"
+ [tb134-02-video]: https://youtu.be/FhN_x9rsR4M "A Gentle Introduction to Markdown for Writers"
+ [tb137-slides]: https://tug.org/tug2023/files/sa-03-novotny-markdown3/novotny-markdown3-slides.pdf "Markdown 3: What's New, What's Next?"
+ [tb137-video]: https://youtu.be/U8XjTOhJkg0 "Markdown 3: What's New, What's Next?"
+ [tb137-video-mirror]: https://youtu.be/W15bBpVTA-c "Markdown 3: What's New, What's Next? (mirror)"
+ [tb140-preprint]: https://www.tug.org/tug2024/preprints/starynovotny-markdown-themes.pdf "Markdown Themes in Practice"
+ [tb140-video]: https://youtu.be/d7vTW7PR0B4?t=5h3m10s "Markdown Themes in Practice"
+ [tb140-slides]: https://www.tug.org/tug2024/slides/starynovotny-markdown-themes.pdf "Markdown Themes in Practice"
[10.5300/2016-1-4/78]: https://www.doi.org/10.5300/2016-1-4/78 "Rendering Markdown inside TeX Documents"
[10.5300/2020-1-2/48]: https://www.doi.org/10.5300/2020-1-2/48 "Markdown 2.8.1: Boldly Unto the Throne of Lightweight Markup in TeX"
@@ -276,7 +236,7 @@ Acknowledgements
| [<img width="150" src="https://www.fi.muni.cz/images/fi-logo.png">][fimu] | I gratefully acknowledge the funding from the [Faculty of Informatics][fimu] at the [Masaryk University][mu] in Brno, Czech Republic, for the development of the Markdown package in projects [MUNI/33/12/2015][], [MUNI/33/1784/2020][], [MUNI/33/0776/2021][], [MUNI/33/1654/2022][], and [MUNI/33/1658/2022][]. |
| [<img width="150" src="https://cdn.overleaf.com/img/ol-brand/overleaf_og_logo.png">][overleaf] | Extensive user documentation for the Markdown package was kindly written by [Lian Tze Lim][liantze] and published by [Overleaf][]. |
| [<img width="150" src="https://pbs.twimg.com/profile_images/1004769879319334912/6Bh1UthD.jpg">][omedym] | Support for content slicing (Lua options [`shiftHeadings`][option-shift-headings] and [`slice`][option-slice]) and pipe tables (Lua options [`pipeTables`][option-pipe-tables] and [`tableCaptions`][option-table-captions]) was graciously sponsored by [David Vins][dvins] and [Omedym][]. |
-| [<img width="150" src="https://www.istqb.org/static/istqb-logo-1b043e800a580724ad223567f9ea57c0.png">][istqb] | Fixes for issues [#359][issue-359], [#368][issue-368], [#401][issue-401], and [#424][issue-424] were graciously sponsored by the [International Software Testing Qualifications Board (ISTQB)][istqb]. |
+| [<img width="150" src="https://www.istqb.org/static/istqb-logo-1b043e800a580724ad223567f9ea57c0.png">][istqb] | Fixes for issues [#359][issue-359], [#368][issue-368], [#401][issue-401], [#424][issue-424], [#440][issue-440], [#468][issue-468], [#474][issue-474], and [#487][issue-487] were graciously sponsored by the [International Software Testing Qualifications Board (ISTQB)][istqb]. |
[dvins]: https://github.com/dvins "David Vins"
[fimu]: https://www.fi.muni.cz/index.html.en "Faculty of Informatics, Masaryk University"
@@ -288,6 +248,10 @@ Acknowledgements
[issue-368]: https://github.com/witiko/markdown/issues/368 "Tables nested in list items have empty lines"
[issue-401]: https://github.com/witiko/markdown/issues/401 "Create an unnumbered section"
[issue-424]: https://github.com/witiko/markdown/issues/424 "E-mail addresses are incorrectly interpreted as bracketed citations"
+ [issue-440]: https://github.com/witiko/markdown/issues/440 "Support programmatic text in YAML metadata values"
+ [issue-468]: https://github.com/witiko/markdown/issues/468 "Enable option eagerCache by default"
+ [issue-474]: https://github.com/witiko/markdown/issues/474 "Improve the speed of the Markdown package"
+ [issue-487]: https://github.com/witiko/markdown/issues/487 "Prevent loading the full Markdown package when converting cached markdown fragments"
[option-pipe-tables]: https://mirrors.ctan.org/macros/generic/markdown/markdown.html#pipe-tables "Markdown Package User Manual"
[option-shift-headings]: https://mirrors.ctan.org/macros/generic/markdown/markdown.html#option-shiftheadings "Markdown Package User Manual"
diff --git a/macros/generic/markdown/VERSION b/macros/generic/markdown/VERSION
index c2b2c7e0ab..95d6c0a328 100644
--- a/macros/generic/markdown/VERSION
+++ b/macros/generic/markdown/VERSION
@@ -1 +1 @@
-3.6.2-0-g6c30af7e (2024-07-14)
+3.7.1-0-g8e726800 (2024-09-30)
diff --git a/macros/generic/markdown/docstrip.cfg b/macros/generic/markdown/docstrip.cfg
index 959a3a21c3..44429e7b97 100644
--- a/macros/generic/markdown/docstrip.cfg
+++ b/macros/generic/markdown/docstrip.cfg
@@ -11,12 +11,12 @@
-- permit persons to whom the Software is furnished to do so, subject to^^J%
-- the following conditions:^^J%
--^^J%
--- The above copyright notice and this permission notice shall be included^^J%
--- in all copies or substantial portions of the Software.^^J%
+-- The above copyright notice and this permission notice shall be^^J%
+-- included in all copies or substantial portions of the Software.^^J%
--^^J%
-- THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,^^J%
-- EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF^^J%
--- MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.^^J%
+-- MERCHANTABILITY, FITNESS FOR PARTICULAR PURPOSE AND NONINFRINGEMENT.^^J%
-- IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY^^J%
-- CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,^^J%
-- TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE^^J%
diff --git a/macros/generic/markdown/examples/optex.tex b/macros/generic/markdown/examples/optex.tex
index d39369f6b3..afdcc70dad 100644
--- a/macros/generic/markdown/examples/optex.tex
+++ b/macros/generic/markdown/examples/optex.tex
@@ -226,9 +226,14 @@
\_let \markdownRendererJekyllDataSequenceEnd \_relax
\_def \markdownRendererJekyllDataBoolean #1#2{}
\_def \markdownRendererJekyllDataNumber #1#2{}
-\_def \markdownRendererJekyllDataString #1#2{}
+\_def \markdownRendererJekyllDataProgrammaticString #1#2{}
+\_def \markdownRendererJekyllDataTypographicString #1#2{}
\_def \markdownRendererJekyllDataEmpty #1{}
+%% Warning and Error Renderers
+\_def \markdownRendererWarning #1#2#3#4{}
+\_def \markdownRendererError #1#2#3#4{}
+
% Load the Markdown module and set TeX macros for the Markdown module
\_directlua{
kpse = require("kpse")
diff --git a/macros/generic/markdown/markdown.dtx b/macros/generic/markdown/markdown.dtx
index 97fa8d6b56..cced9c9460 100644
--- a/macros/generic/markdown/markdown.dtx
+++ b/macros/generic/markdown/markdown.dtx
@@ -2,7 +2,8 @@
%<*driver>
\documentclass{ltxdockit}
\usepackage[american]{babel}
-\usepackage{amsmath,btxdockit,doc,fancyvrb,graphicx,hologo,microtype,minted}
+\usepackage{amsmath,btxdockit,doc,fancyvrb,graphicx,hologo,microtype}
+\IfFileExists{minted2.sty}{\usepackage{minted2}}{\usepackage{minted}}
% Set up the style.
\usepackage{xcolor}
@@ -814,7 +815,9 @@ abbr {
},
jekyllDataRenderers = {
/authors/* = {%
- \expandafter\gdef\expandafter\ltd@title@author\expandafter{\ltd@title@author, #1}%
+ \expandafter\gdef
+ \expandafter\ltd@title@author
+ \expandafter{\ltd@title@author, #1}%
},
title = {%
\gdef\ltd@title@title{#1}%
@@ -923,13 +926,15 @@ documentation][techdoc].
(A Markdown Interpreter for TeX)
%</manual>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader,lua-unicode-data>
% \fi
% \begin{macrocode}
local metadata = {
version = "(((VERSION)))",
- comment = "A module for the conversion from markdown to plain TeX",
- author = "John MacFarlane, Hans Hagen, Vít Starý Novotný, Andrej Genčur",
+ comment = "A module for the conversion from markdown "
+ .. "to plain TeX",
+ author = "John MacFarlane, Hans Hagen, Vít Starý Novotný, "
+ .. "Andrej Genčur",
copyright = {"2009-2016 John MacFarlane, Hans Hagen",
"2016-2024 Vít Starý Novotný, Andrej Genčur"},
license = "LPPL 1.3c"
@@ -937,7 +942,7 @@ local metadata = {
% \end{macrocode}
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader,lua-unicode-data>
%<*lua>
% \fi
% \begin{macrocode}
@@ -989,7 +994,7 @@ make base
Either of the two abovelisted approaches should produce the following files:
-* `markdown.lua`: The Lua module
+* `markdown.lua`, `markdown-parser.lua`, and `markdown-unicode-data.lua`: The Lua module
* `libraries/markdown-tinyyaml.lua`: An external library for reading \acro{yaml}
* `markdown-cli.lua`: The Lua command-line interface
* `markdown.tex`: The plain \TeX{} macro package
@@ -1010,6 +1015,8 @@ directory structure. This is generally where the individual files should be
placed:
* `⟨TEXMF⟩/tex/luatex/markdown/markdown.lua`
+* `⟨TEXMF⟩/tex/luatex/markdown/markdown-parser.lua`
+* `⟨TEXMF⟩/tex/luatex/markdown/markdown-unicode-data.lua`
* `⟨TEXMF⟩/tex/luatex/markdown/markdown-tinyyaml.lua`
* `⟨TEXMF⟩/scripts/markdown/markdown-cli.lua`
* `⟨TEXMF⟩/tex/generic/markdown/markdown.tex`
@@ -1036,6 +1043,8 @@ portably typeset on legacy \TeX{} distributions.
This is where the individual files should be placed:
* `./markdown.lua`
+* `./markdown-parser.lua`
+* `./markdown-unicode-data.lua`
* `./markdown-tinyyaml.lua`
* `./markdown-cli.lua`
* `./markdown/markdown.tex`
@@ -1076,6 +1085,10 @@ The file `markdown.tex` *must* be placed in a directory named `markdown`.
% Live${}\geq{}2013$).
%
% \end{markdown}
+% \iffalse
+%</lua>
+%<*lua,lua-unicode-data>
+% \fi
% \begin{macrocode}
local lpeg = require("lpeg")
% \end{macrocode}
@@ -1090,6 +1103,10 @@ local lpeg = require("lpeg")
% Lua\TeX{} (\TeX Live${}\geq{}2008$).
%
% \end{markdown}
+% \iffalse
+%</lua,lua-unicode-data>
+%<*lua,lua-unicode-data-generator>
+% \fi
% \begin{macrocode}
local unicode = require("unicode")
% \end{macrocode}
@@ -1104,9 +1121,17 @@ local unicode = require("unicode")
% Live${}\geq{}2008$).
%
% \end{markdown}
+% \iffalse
+%</lua,lua-unicode-data-generator>
+%<*lua,lua-loader>
+% \fi
% \begin{macrocode}
-local md5 = require("md5");
+local md5 = require("md5")
% \end{macrocode}
+% \iffalse
+%</lua,lua-loader>
+%<*lua,lua-unicode-data-generator>
+% \fi
% \begin{markdown}
%
% \pkg{Kpathsea}
@@ -1116,7 +1141,7 @@ local md5 = require("md5");
%
% \end{markdown}
% \begin{macrocode}
-(function()
+;(function()
% \end{macrocode}
% \begin{markdown}
%
@@ -1150,7 +1175,7 @@ end)()
%
% \end{markdown}
% \iffalse
-%</lua>
+%</lua,lua-unicode-data-generator>
%<*depends>
% \fi
% \begin{macrocode}
@@ -1181,7 +1206,7 @@ local uni_algos = require("lua-uni-algos")
%<*depends>
% \fi
% \begin{macrocode}
-# hard lua-tinyyaml # TODO: Uncomment after TeX Live 2022 has been deprecated.
+# hard lua-tinyyaml # TODO: Uncomment after TeX Live 2022 deprecation.
% \end{macrocode}
% \iffalse
%</depends>
@@ -1871,7 +1896,7 @@ module and a command-line interface (CLI).
(Lua library for conversion between markup formats)
%</manual-interfaces>
-%<*lua>
+%<*lua,lua-loader,lua-unicode-data>
% \fi
% \begin{markdown}
%
@@ -1886,6 +1911,10 @@ module and a command-line interface (CLI).
% \begin{macrocode}
local M = {metadata = metadata}
% \end{macrocode}
+% \iffalse
+% \fi
+%</lua,lua-loader,lua-unicode-data>
+%<*lua>
% \par
% \begin{markdown}
%
@@ -2162,7 +2191,7 @@ In this section, I will describe all the options recognized by the Markdown
package.
%</manual-options>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
local defaultOptions = {}
@@ -2171,7 +2200,7 @@ local defaultOptions = {}
% \markdownSetup{snippet=lua-options}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
### Lua
@@ -2205,7 +2234,9 @@ interfaces and all the way up to the \LaTeX{} and \Hologo{ConTeXt} interfaces.
\prop_new:N \g_@@_default_lua_options_prop
\seq_new:N \g_@@_option_layers_seq
\tl_const:Nn \c_@@_option_layer_lua_tl { lua }
-\seq_gput_right:NV \g_@@_option_layers_seq \c_@@_option_layer_lua_tl
+\seq_gput_right:NV
+ \g_@@_option_layers_seq
+ \c_@@_option_layer_lua_tl
\cs_new:Nn
\@@_add_lua_option:nnn
{
@@ -2282,21 +2313,50 @@ interfaces and all the way up to the \LaTeX{} and \Hologo{ConTeXt} interfaces.
\cs_generate_variant:Nn
\msg_error:nnnn
{ nnnV }
-\seq_new:N \g_@@_option_types_seq
-\tl_const:Nn \c_@@_option_type_clist_tl { clist }
-\seq_gput_right:NV \g_@@_option_types_seq \c_@@_option_type_clist_tl
-\tl_const:Nn \c_@@_option_type_counter_tl { counter }
-\seq_gput_right:NV \g_@@_option_types_seq \c_@@_option_type_counter_tl
-\tl_const:Nn \c_@@_option_type_boolean_tl { boolean }
-\seq_gput_right:NV \g_@@_option_types_seq \c_@@_option_type_boolean_tl
-\tl_const:Nn \c_@@_option_type_number_tl { number }
-\seq_gput_right:NV \g_@@_option_types_seq \c_@@_option_type_number_tl
-\tl_const:Nn \c_@@_option_type_path_tl { path }
-\seq_gput_right:NV \g_@@_option_types_seq \c_@@_option_type_path_tl
-\tl_const:Nn \c_@@_option_type_slice_tl { slice }
-\seq_gput_right:NV \g_@@_option_types_seq \c_@@_option_type_slice_tl
-\tl_const:Nn \c_@@_option_type_string_tl { string }
-\seq_gput_right:NV \g_@@_option_types_seq \c_@@_option_type_string_tl
+\seq_new:N
+ \g_@@_option_types_seq
+\tl_const:Nn
+ \c_@@_option_type_clist_tl
+ { clist }
+\seq_gput_right:NV
+ \g_@@_option_types_seq
+ \c_@@_option_type_clist_tl
+\tl_const:Nn
+ \c_@@_option_type_counter_tl
+ { counter }
+\seq_gput_right:NV
+ \g_@@_option_types_seq
+ \c_@@_option_type_counter_tl
+\tl_const:Nn
+ \c_@@_option_type_boolean_tl
+ { boolean }
+\seq_gput_right:NV
+ \g_@@_option_types_seq
+ \c_@@_option_type_boolean_tl
+\tl_const:Nn
+ \c_@@_option_type_number_tl
+ { number }
+\seq_gput_right:NV
+ \g_@@_option_types_seq
+ \c_@@_option_type_number_tl
+\tl_const:Nn
+ \c_@@_option_type_path_tl
+ { path }
+\seq_gput_right:NV
+ \g_@@_option_types_seq
+ \c_@@_option_type_path_tl
+\tl_const:Nn
+ \c_@@_option_type_slice_tl
+ { slice }
+\seq_gput_right:NV
+ \g_@@_option_types_seq
+ \c_@@_option_type_slice_tl
+\tl_const:Nn
+ \c_@@_option_type_string_tl
+ { string }
+\seq_gput_right:NV
+ \g_@@_option_types_seq
+ \c_@@_option_type_string_tl
\cs_new:Nn
\@@_get_option_type:nN
{
@@ -2518,20 +2578,23 @@ interfaces and all the way up to the \LaTeX{} and \Hologo{ConTeXt} interfaces.
#### Option `eagerCache`
-`eagerCache` (default value: `false`)
+`eagerCache` (default value: `true`)
% \fi
% \begin{markdown}
%
-% \Optitem[false]{eagerCache}{\opt{true}, \opt{false}}
+% \Optitem[true]{eagerCache}{\opt{true}, \opt{false}}
%
: true
: Converted markdown documents will be cached in \Opt{cacheDir}. This can be
useful for post-processing the converted documents and for recovering
- historical versions of the documents from the cache. However, it also
- produces a large number of auxiliary files on the disk and obscures the
- output of the Lua command-line interface when it is used for plumbing.
+ historical versions of the documents from the cache. Furthermore, it can
+ also significantly improve the processing speed for documents that require
+ multiple compilation runs, since each markdown document is only converted once.
+ However, it also produces a large number of auxiliary files on the disk
+ and obscures the output of the Lua command-line interface when it is
+ used for plumbing.
This behavior will always be used if the \Opt{finalizeCache} option is
enabled.
@@ -2540,7 +2603,11 @@ interfaces and all the way up to the \LaTeX{} and \Hologo{ConTeXt} interfaces.
: Converted markdown documents will not be cached. This decreases the number
of auxiliary files that we produce and makes it easier to use the Lua
- command-line interface for plumbing.
+ command-line interface for plumbing. However, it makes it impossible to
+ post-process the converted documents and recover historical versions of
+ the documents from the cache. Furthermore, it can significantly reduce
+ the processing speed for documents that require multiple compilation
+ runs, since each markdown document is converted multiple times needlessly.
This behavior will only be used when the \Opt{finalizeCache} option is
disabled.
@@ -2602,18 +2669,18 @@ Hello \markdownRendererEmphasis{world}!\relax
\@@_add_lua_option:nnn
{ eagerCache }
{ boolean }
- { false }
+ { true }
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
-defaultOptions.eagerCache = false
+defaultOptions.eagerCache = true
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `singletonCache`
@@ -2641,12 +2708,11 @@ defaultOptions.eagerCache = false
: Every call to the function \luamref{new}`(options)` will produce a new
conversion function that will not be cached. This is slower than
caching conversion functions and may expose bugs related to memory
- leaks in the creation of conversion functions, see also issue
- [#226][issue-226].
+ leaks in the creation of conversion functions, see also [#226 (comment)][226-comment].
This was the default behavior until version 3.0.0 of the Markdown package.
- [issue-226]: https://github.com/witiko/markdown/pull/226#issuecomment-1599641634
+ [226-comment]: https://github.com/witiko/markdown/pull/226#issuecomment-1599641634
% \end{markdown}
% \iffalse
@@ -2695,13 +2761,13 @@ conversion function.
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.singletonCache = true
% \end{macrocode}
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*lua>
% \fi
% \begin{macrocode}
@@ -2750,14 +2816,14 @@ local singletonCache = {
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.unicodeNormalization = true
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `unicodeNormalizationForm`
@@ -2806,14 +2872,14 @@ defaultOptions.unicodeNormalization = true
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.unicodeNormalizationForm = "nfc"
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
% \fi
% \begin{markdown}
@@ -2982,14 +3048,14 @@ option.
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.cacheDir = "."
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `contentBlocksLanguageMap`
@@ -3146,14 +3212,14 @@ following text:
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.contentBlocksLanguageMap = "markdown-languages.json"
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `debugExtensionsFileName`
@@ -3195,14 +3261,14 @@ defaultOptions.contentBlocksLanguageMap = "markdown-languages.json"
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.debugExtensionsFileName = "debug-extensions.json"
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `frozenCacheFileName`
@@ -3437,14 +3503,14 @@ the markdown document from “Hello *world*!” to “Hi *world*!” was not ref
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.frozenCacheFileName = "frozenCache.tex"
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
% \fi
% \begin{markdown}
@@ -3494,14 +3560,14 @@ See also the option \Opt{gfmAutoIdentifiers}.
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.autoIdentifiers = false
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `blankBeforeBlockquote`
@@ -3718,14 +3784,14 @@ following text:
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.blankBeforeBlockquote = false
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `blankBeforeCodeFence`
@@ -3975,14 +4041,14 @@ following text:
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.blankBeforeCodeFence = false
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `blankBeforeDivFence`
@@ -4058,14 +4124,14 @@ following text:
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.blankBeforeDivFence = false
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `blankBeforeHeading`
@@ -4298,14 +4364,14 @@ following text:
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.blankBeforeHeading = false
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `blankBeforeList`
@@ -4524,14 +4590,14 @@ following text:
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.blankBeforeList = false
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `bracketedSpans`
@@ -4620,14 +4686,14 @@ following text:
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.bracketedSpans = false
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `breakableBlockquotes`
@@ -4854,14 +4920,14 @@ following text:
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.breakableBlockquotes = true
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `citationNbsps`
@@ -4948,14 +5014,14 @@ following text, where the middot (`·`) denotes a non-breaking space:
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.citationNbsps = true
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `citations`
@@ -5051,14 +5117,14 @@ following text:
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.citations = false
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `codeSpans`
@@ -5277,14 +5343,14 @@ following text:
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.codeSpans = true
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `contentBlocks`
@@ -5451,14 +5517,14 @@ following text:
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.contentBlocks = false
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `contentLevel`
@@ -5588,14 +5654,14 @@ following text:
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.contentLevel = "block"
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `debugExtensions`
@@ -5743,14 +5809,14 @@ inserted to the grammar of markdown.
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.debugExtensions = false
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `definitionLists`
@@ -5882,14 +5948,60 @@ following text:
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.definitionLists = false
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
+%<*manual-options>
+
+#### Option `ensureJekyllData`
+
+`ensureJekyllData` (default value: `false`)
+
+% \fi
+% \begin{markdown}
+%
+% \Optitem[false]{ensureJekyllData}{\opt{true}, \opt{false}}
+%
+: false
+
+ : When the \Opt{jekyllData} and \Opt{expectJekyllData} options are
+ enabled, then a markdown document may begin directly with \acro{yaml}
+ metadata and may contain nothing but \acro{yaml} metadata. Otherwise,
+ the markdown document is processed as markdown text.
+
+: true
+
+ : When the \Opt{jekyllData} and \Opt{expectJekyllData} options are
+ enabled, then a markdown document must begin directly with \acro{yaml}
+ metadata and must contain nothing but \acro{yaml} metadata. Otherwise,
+ an error is produced.
+
+% \end{markdown}
+% \iffalse
+%</manual-options>
+%<*tex>
+% \fi
+% \begin{macrocode}
+\@@_add_lua_option:nnn
+ { ensureJekyllData }
+ { boolean }
+ { false }
+% \end{macrocode}
+% \iffalse
+%</tex>
+%<*lua,lua-cli,lua-loader>
+% \fi
+% \begin{macrocode}
+defaultOptions.ensureJekyllData = false
+% \end{macrocode}
+% \par
+% \iffalse
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `expectJekyllData`
@@ -6006,14 +6118,14 @@ following text:
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.expectJekyllData = false
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `extensions`
@@ -6157,14 +6269,14 @@ following text:
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.extensions = {}
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `fancyLists`
@@ -6259,14 +6371,14 @@ following text:
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.fancyLists = false
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `fencedCode`
@@ -6426,14 +6538,14 @@ following text:
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.fencedCode = true
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `fencedCodeAttributes`
@@ -6526,14 +6638,14 @@ following text:
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.fencedCodeAttributes = false
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `fencedDivs` {#fenced-divs}
@@ -6605,14 +6717,14 @@ following text:
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.fencedDivs = false
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `finalizeCache`
@@ -6769,14 +6881,14 @@ the markdown document from “Hello *world*!” to “Hi *world*!” was not ref
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.finalizeCache = false
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `frozenCacheCounter`
@@ -6838,14 +6950,14 @@ requested using the `frozenCacheCounter` option.
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.frozenCacheCounter = 0
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `gfmAutoIdentifiers`
@@ -6887,14 +6999,14 @@ See also the option \Opt{autoIdentifiers}.
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.gfmAutoIdentifiers = false
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `hashEnumerators`
@@ -7018,14 +7130,14 @@ following text:
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.hashEnumerators = false
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `headerAttributes` {#header-attributes}
@@ -7067,14 +7179,14 @@ defaultOptions.hashEnumerators = false
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.headerAttributes = false
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `html`
@@ -7339,14 +7451,14 @@ following text:
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.html = true
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `hybrid`
@@ -7373,6 +7485,58 @@ defaultOptions.html = true
encouraged when typesetting automatically generated content or
markdown documents that were not prepared with this package in mind.
+The \Opt{hybrid} option makes it difficult to untangle \TeX{} input from
+markdown text, which makes documents written with the \Opt{hybrid} option
+less interoperable and more difficult to read for authors. Therefore, the
+option has been soft-deprecated in version 3.7.1 of the Markdown package:
+It will never be removed but using it prints a warning and is discouraged.
+
+Consider one of the following better alternatives for mixing \TeX{} and
+markdown:
+
+- With the \Opt{contentBlocks} option, authors can move large blocks of TeX
+ code to separate files and include them in their markdown documents as
+ external resources:
+
+ ``` md
+ Here is a mathematical formula:
+
+ /math-formula.tex
+ ```
+
+- With the \Opt{rawAttribute} option, authors can denote raw text spans and
+ code blocks that will be interpreted as \TeX{} code:
+
+ `````` md
+ `$H_2 O$`{=tex} is a liquid.
+
+ Here is a mathematical formula:
+ ``` {=tex}
+ \[distance[i] =
+ \begin{dcases}
+ a & b \\
+ c & d
+ \end{dcases}
+ \]
+ ```
+ ``````
+
+- With options \Opt{texMathDollars}, \Opt{texMathSingleBackslash}, and
+ \Opt{texMathDoubleBackslash}, authors can freely type \TeX{} commands between
+ dollar signs or backslash-escaped brackets:
+
+ ``` md
+ $H_2 O$ is a liquid.
+
+ Here is a mathematical formula:
+ \[distance[i] =
+ \begin{dcases}
+ a & b \\
+ c & d
+ \end{dcases}
+ \]
+ ```
+
% \end{markdown}
% \iffalse
@@ -7565,14 +7729,14 @@ following text:
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.hybrid = false
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `inlineCodeAttributes`
@@ -7661,14 +7825,14 @@ following text:
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.inlineCodeAttributes = false
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `inlineNotes`
@@ -7762,14 +7926,14 @@ following text:
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.inlineNotes = false
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `jekyllData`
@@ -7929,14 +8093,14 @@ following text:
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.jekyllData = false
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `linkAttributes`
@@ -8026,14 +8190,14 @@ image (from [Martin Scharrer's mwe package][mwe]) displayed at size 5cm × 4cm.
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.linkAttributes = false
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `lineBlocks`
@@ -8161,14 +8325,14 @@ following text:
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.lineBlocks = false
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `mark`
@@ -8232,14 +8396,14 @@ following text:
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.mark = false
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `notes`
@@ -8395,14 +8559,14 @@ following text:
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.notes = false
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `pipeTables` {#pipe-tables}
@@ -8504,14 +8668,14 @@ following text:
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.pipeTables = false
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `preserveTabs`
@@ -8544,14 +8708,14 @@ defaultOptions.pipeTables = false
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.preserveTabs = true
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `rawAttribute`
@@ -8639,14 +8803,14 @@ following text:
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.rawAttribute = false
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `relativeReferences`
@@ -8728,14 +8892,14 @@ following text:
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.relativeReferences = false
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `shiftHeadings`
@@ -8868,14 +9032,14 @@ following text:
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.shiftHeadings = 0
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `slice`
@@ -9086,14 +9250,14 @@ following text:
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.slice = "^ $"
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `smartEllipses`
@@ -9301,14 +9465,14 @@ following text:
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.smartEllipses = false
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `startNumber`
@@ -9437,14 +9601,14 @@ following text:
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.startNumber = true
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `strikeThrough`
@@ -9559,14 +9723,14 @@ following text:
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.strikeThrough = false
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `stripIndent`
@@ -9672,14 +9836,14 @@ text “Hello *world*!”
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.stripIndent = false
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `subscripts`
@@ -9764,14 +9928,14 @@ following text:
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.subscripts = false
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `superscripts`
@@ -9856,14 +10020,14 @@ following text:
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.superscripts = false
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `tableAttributes`
@@ -9981,14 +10145,14 @@ following text:
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.tableAttributes = false
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `tableCaptions` {#table-captions}
@@ -10111,14 +10275,14 @@ following text:
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.tableCaptions = false
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `taskLists`
@@ -10224,14 +10388,14 @@ following text:
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.taskLists = false
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `texComments`
@@ -10340,14 +10504,14 @@ text “Hello *world*!”
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.texComments = false
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `texMathDollars`
@@ -10551,14 +10715,14 @@ following text:
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.texMathDollars = false
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `texMathDoubleBackslash`
@@ -10762,14 +10926,14 @@ following text:
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.texMathDoubleBackslash = false
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `texMathSingleBackslash`
@@ -10973,14 +11137,14 @@ following text:
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.texMathSingleBackslash = false
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `tightLists`
@@ -11094,14 +11258,14 @@ following text:
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.tightLists = true
% \end{macrocode}
% \par
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*manual-options>
#### Option `underscores`
@@ -11237,14 +11401,14 @@ following text:
% \end{macrocode}
% \iffalse
%</tex>
-%<*lua,lua-cli>
+%<*lua,lua-cli,lua-loader>
% \fi
% \begin{macrocode}
defaultOptions.underscores = true
% \end{macrocode}
% \endgroup
% \iffalse
-%</lua,lua-cli>
+%</lua,lua-cli,lua-loader>
%<*lua-cli>
% \fi
% \par
@@ -11330,7 +11494,8 @@ Copyright (C) ]] .. table.concat(metadata.copyright,
License: ]] .. metadata.license
local function warn(s)
- io.stderr:write("Warning: " .. s .. "\n") end
+ io.stderr:write("Warning: " .. s .. "\n")
+end
local function error(s)
io.stderr:write("Error: " .. s .. "\n")
@@ -11421,8 +11586,8 @@ for i = 1, #arg do
if default_type == "nil" then
warn('Option "' .. key .. '" not recognized.')
else
- warn('Option "' .. key .. '" type not recognized, please file ' ..
- 'a report to the package maintainer.')
+ warn('Option "' .. key .. '" type not recognized, ' ..
+ 'please file a report to the package maintainer.')
end
warn('Parsing the ' .. 'value "' .. value ..'" of option "' ..
key .. '" as a string.')
@@ -11757,7 +11922,9 @@ pdftex --shell-escape document.tex
% \begin{macrocode}
\prop_new:N \g_@@_plain_tex_option_types_prop
\prop_new:N \g_@@_default_plain_tex_options_prop
-\seq_gput_right:NV \g_@@_option_layers_seq \c_@@_option_layer_plain_tex_tl
+\seq_gput_right:NV
+ \g_@@_option_layers_seq
+ \c_@@_option_layer_plain_tex_tl
\cs_new:Nn
\@@_add_plain_tex_option:nnn
{
@@ -12302,6 +12469,15 @@ A PDF document named `document.pdf` should be produced and contain the text
}
\ExplSyntaxOff
\input lt3luabridge.tex
+% \end{macrocode}
+% \begin{markdown}
+%
+% Use the \pkg{lt3luabridge} library to determine the default value of the
+% \mref{markdownOptionOutputDir} macro by using the environmental variable
+% `TEXMF_OUTPUT_DIRECTORY` that is available since TeX~Live 2024.
+%
+% \end{markdown}
+% \begin{macrocode}
\ExplSyntaxOn
\cs_new:Nn
\@@_define_option_command_output_dir:
@@ -12322,12 +12498,25 @@ A PDF document named `document.pdf` should be produced and contain the text
)
}
{
+% \end{macrocode}
+% \begin{markdown}
+%
+% Set most catcodes to category 12 (other) to ensure that special characters in
+% `TEXMF_OUTPUT_DIRECTORY` such as backslashes (`\`) are not interpreted as
+% control sequences.
+%
+% \end{markdown}
+% \begin{macrocode}
+ \group_begin:
+ \cctab_select:N
+ \c_str_cctab
\luabridge_tl_set:Nn
\l_tmpa_tl
{ print(os.getenv("TEXMF_OUTPUT_DIRECTORY") or ".") }
\tl_gset:NV
\markdownOptionOutputDir
\l_tmpa_tl
+ \group_end:
}
{
\tl_gset:Nn
@@ -12828,10 +13017,14 @@ options locally.
{ redefined-snippet }
\l_tmpa_tl
}
- \prop_gput:NVn
+ \keys_precompile:nnN
+ { markdown/options }
+ { #2 }
+ \l_tmpb_tl
+ \prop_gput:NVV
\g_@@_snippets_prop
\l_tmpa_tl
- { #2 }
+ \l_tmpb_tl
}
\cs_gset_eq:NN
\markdownSetupSnippet
@@ -12897,7 +13090,7 @@ options locally.
\g_@@_snippets_prop
\l_tmpa_tl
\l_tmpb_tl
- \@@_setup:V
+ \tl_use:N
\l_tmpb_tl
}
{
@@ -12912,9 +13105,6 @@ options locally.
{ markdown }
{ undefined-snippet }
{ Can't~invoke~undefined~snippet~#1 }
-\cs_generate_variant:Nn
- \@@_setup:n
- { V }
\ExplSyntaxOff
% \end{macrocode}
% \iffalse
@@ -15699,8 +15889,8 @@ following text:
% \begin{markdown}
#### Fenced Code Attribute Context Renderers
-The following macros are only produced, when the \Opt{fencedCode} option is
-enabled.
+The following macros are only produced, when the \Opt{fencedCode} and
+\Opt{fencedCodeAttributes} options are enabled.
The \mdef{markdownRendererFencedCodeAttributeContextBegin} and
\mdef{markdownRendererFencedCodeAttributeContextEnd} macros represent the
@@ -19956,6 +20146,59 @@ following text:
%
% \begin{markdown}
+#### Warning and Error Renderers
+
+The \mdef{markdownRendererWarning} and \mdef{markdownRendererError} macros
+represent warnings and errors produced by the markdown parser. Both macros
+receive four parameters:
+
+1. The fully escaped text of the warning or error that can be directly typeset
+2. The raw text of the warning or error that can be used outside typesetting
+ for e.g. logging the warning or error.
+3. The fully escaped text with more details about the warning or error that
+ can be directly typeset. Can be empty, unlike the first two parameters.
+4. The raw text with more details about the warning or error that can be used
+ outside typesetting for e.g. logging the warning or error. Can be empty,
+ unlike the first two parameters.
+
+% \end{markdown}
+%
+% \iffalse
+%</manual-tokens>
+%<*tex>
+% \fi
+%
+% \begin{macrocode}
+\def\markdownRendererWarning{%
+ \markdownRendererWarningPrototype}%
+\def\markdownRendererError{%
+ \markdownRendererErrorPrototype}%
+\ExplSyntaxOn
+\seq_gput_right:Nn
+ \g_@@_renderers_seq
+ { warning }
+\prop_gput:Nnn
+ \g_@@_renderer_arities_prop
+ { warning }
+ { 4 }
+\seq_gput_right:Nn
+ \g_@@_renderers_seq
+ { error }
+\prop_gput:Nnn
+ \g_@@_renderer_arities_prop
+ { error }
+ { 4 }
+\ExplSyntaxOff
+% \end{macrocode}
+% \par
+%
+% \iffalse
+%</tex>
+%<*manual-tokens>
+% \fi
+%
+% \begin{markdown}
+
#### YAML Metadata Renderers {#yamlmetadatarenderers}
The \mdef{markdownRendererJekyllDataBegin} macro represents the beginning of a
@@ -20230,12 +20473,24 @@ following \acro{yaml} serialization rules.
%
% \begin{markdown}
-The \mdef{markdownRendererJekyllDataString} macro represents a string scalar
-value in a \acro{yaml} document. This macro will only be produced when the
-\Opt{jekyllData} option is enabled. The macro receives two arguments: the
+The \mdef{markdownRendererJekyllDataTypographicString} and
+\mdef{markdownRendererJekyllDataProgrammaticString} macros represent string
+scalar values in a \acro{yaml} document. This macro will only be produced when
+the \Opt{jekyllData} option is enabled. The macro receives two arguments: the
scalar key in the parent structure, cast to a string following \acro{yaml}
serialization rules, and the scalar value.
+For each string scalar value, both macros are produced. Whereas
+\mref{markdownRendererJekyllDataTypographicString} receives the scalar value
+after all markdown markup and special \TeX{} characters in the string have been
+replaced by \TeX{} macros, \mref{markdownRendererJekyllDataProgrammaticString}
+receives the raw scalar value. Therefore, whereas the
+\mref{markdownRendererJekyllDataTypographicString} macro is more appropriate
+for texts that are supposed to be typeset with \TeX{}, such as document titles,
+author names, or exam questions, the
+\mref{markdownRendererJekyllDataProgrammaticString} macro is more appropriate
+for identifiers and other programmatic text that won't be typeset by \TeX{}.
+
% \end{markdown}
%
% \iffalse
@@ -20244,11 +20499,83 @@ serialization rules, and the scalar value.
% \fi
%
% \begin{macrocode}
-\def\markdownRendererJekyllDataString{%
- \markdownRendererJekyllDataStringPrototype}%
+\def\markdownRendererJekyllDataTypographicString{%
+ \markdownRendererJekyllDataTypographicStringPrototype}%
+\def\markdownRendererJekyllDataProgrammaticString{%
+ \markdownRendererJekyllDataProgrammaticStringPrototype}%
\ExplSyntaxOn
\seq_gput_right:Nn
\g_@@_renderers_seq
+ { jekyllDataTypographicString }
+\prop_gput:Nnn
+ \g_@@_renderer_arities_prop
+ { jekyllDataTypographicString }
+ { 2 }
+\seq_gput_right:Nn
+ \g_@@_renderers_seq
+ { jekyllDataProgrammaticString }
+\prop_gput:Nnn
+ \g_@@_renderer_arities_prop
+ { jekyllDataProgrammaticString }
+ { 2 }
+\ExplSyntaxOff
+% \end{macrocode}
+% \par
+%
+% \iffalse
+%</tex>
+%<*manual-tokens>
+% \fi
+%
+% \begin{markdown}
+
+Before Markdown 3.7.0, the \mref{markdownRendererJekyllDataTypographicString}
+macro was named \mref{markdownRendererJekyllDataString} and the
+\mref{markdownRendererJekyllDataProgrammaticString} macro was not produced.
+The \mref{markdownRendererJekyllDataString} has been deprecated and will be
+removed in Markdown 4.0.0.
+
+% \end{markdown}
+%
+% \iffalse
+%</manual-tokens>
+%<*tex>
+% \fi
+%
+% \begin{macrocode}
+\ExplSyntaxOn
+\cs_gset:Npn
+ \markdownRendererJekyllDataTypographicString
+ {
+ \cs_if_exist:NTF
+ \markdownRendererJekyllDataString
+ {
+ \markdownWarning
+ {
+ The~jekyllDataString~renderer~has~been~deprecated,~
+ to~be~removed~in~Markdown~4.0.0
+ }
+ \markdownRendererJekyllDataString
+ }
+ {
+ \cs_if_exist:NTF
+ \markdownRendererJekyllDataStringPrototype
+ {
+ \markdownWarning
+ {
+ The~jekyllDataString~renderer~prototype~
+ has~been~deprecated,~
+ to~be~removed~in~Markdown~4.0.0
+ }
+ \markdownRendererJekyllDataStringPrototype
+ }
+ {
+ \markdownRendererJekyllDataTypographicStringPrototype
+ }
+ }
+ }
+\seq_gput_right:Nn
+ \g_@@_renderers_seq
{ jekyllDataString }
\prop_gput:Nnn
\g_@@_renderer_arities_prop
@@ -20308,7 +20635,7 @@ following content:
``` tex
\input markdown
\def\markdownOptionJekyllData{true}
-\def\markdownRendererJekyllDataString#1#2{\gdef\name{#2}}
+\def\markdownRendererJekyllDataTypographicString#1#2{\gdef\name{#2}}
\def\markdownRendererJekyllDataNumber#1#2{\gdef\age{#2}}
\def\markdownRendererJekyllDataEnd{%
\name{} is \age{} years old.}
@@ -20338,7 +20665,7 @@ following content:
\usepackage[jekyllData]{markdown}
\markdownSetup{
renderers = {
- jekyllDataString = {\gdef\name{#2}},
+ jekyllDataTypographicString = {\gdef\name{#2}},
jekyllDataNumber = {\gdef\age{#2}},
jekyllDataEnd = {\name{} is \age{} years old.},
}
@@ -20370,7 +20697,7 @@ following content:
``` tex
\usemodule[t][markdown]
\setupmarkdown[jekyllData = yes]
-\def\markdownRendererJekyllDataString#1#2{\gdef\name{#2}}
+\def\markdownRendererJekyllDataTypographicString#1#2{\gdef\name{#2}}
\def\markdownRendererJekyllDataNumber#1#2{\gdef\age{#2}}
\def\markdownRendererJekyllDataEnd{%
\name{} is \age{} years old.}
@@ -20412,9 +20739,12 @@ following text:
\ExplSyntaxOn
\cs_new:Nn \@@_define_renderers:
{
- \seq_map_function:NN
+ \seq_map_inline:Nn
\g_@@_renderers_seq
- \@@_define_renderer:n
+ {
+ \@@_define_renderer:n
+ { ##1 }
+ }
}
\cs_new:Nn \@@_define_renderer:n
{
@@ -20478,6 +20808,24 @@ following text:
\l_@@_renderer_definition_tl
},
}
+% \end{macrocode}
+% \par
+% \begin{markdown}
+%
+% If the token renderer macro has been deprecated, we undefine it.
+%
+% The \mref{markdownRendererJekyllDataString} macro has been deprecated and
+% will be removed in Markdown 4.0.0.
+%
+% \end{markdown}
+% \begin{macrocode}
+ \str_if_eq:nnT
+ { #1 }
+ { jekyllDataString }
+ {
+ \cs_undefine:N
+ #2
+ }
}
% \end{macrocode}
% \par
@@ -21130,9 +21478,12 @@ following text:
\ExplSyntaxOn
\cs_new:Nn \@@_define_renderer_prototypes:
{
- \seq_map_function:NN
+ \seq_map_inline:Nn
\g_@@_renderers_seq
- \@@_define_renderer_prototype:n
+ {
+ \@@_define_renderer_prototype:n
+ { ##1 }
+ }
}
\cs_new:Nn \@@_define_renderer_prototype:n
{
@@ -21198,21 +21549,30 @@ following text:
},
}
% \end{macrocode}
+% \par
% \begin{markdown}
%
-% Unless the token renderer prototype macro has already been defined,
-% we provide an empty definition.
+% Unless the token renderer prototype macro has already been defined or unless,
+% it has been deprecated, we provide an empty definition.
+%
+% The \mref{markdownRendererJekyllDataStringPrototype} macro has been
+% deprecated and will be removed in Markdown 4.0.0.
%
% \end{markdown}
% \begin{macrocode}
- \cs_if_free:NT
- #2
+ \str_if_eq:nnF
+ { #1 }
+ { jekyllDataString }
{
- \cs_generate_from_arg_count:NNnn
+ \cs_if_free:NT
#2
- \cs_set:Npn
- { #3 }
- { }
+ {
+ \cs_generate_from_arg_count:NNnn
+ #2
+ \cs_set:Npn
+ { #3 }
+ { }
+ }
}
}
\cs_generate_variant:Nn
@@ -21612,9 +21972,10 @@ pdflatex --shell-escape document.tex
% \LaTeX{} environments, and redefines the \mref{markinline} and
% \mref{markdownInput} commands.
%
+%#### The `markdown` and `markdown*` \LaTeX{} environments
% The \envmref{markdown} and \envmref{markdown*} \LaTeX{} environments are used
% to typeset markdown document fragments. Both \LaTeX{} environments accept
-% \LaTeX{} interface options (see ection <#sec:latex-options>) as the only
+% \LaTeX{} interface options (see Section <#sec:latex-options>) as the only
% argument. This argument is optional for the \envmref{markdown} environment
% and mandatory for the \envmref{markdown*} environment.
%
@@ -21651,6 +22012,52 @@ pdflatex --shell-escape document.tex
% \end{document} \end{document}
% ```````
%
+% You can't directly extend the \envmref{markdown} \LaTeX{} environment by
+% using it in other environments as follows:
+%
+% ``` tex
+% \newenvironment{foo}\%
+% {code before \begin{markdown}[some, options]}\%
+% {\end{markdown} code after}
+% ```
+%
+% This is because the implementation looks for the literal string
+% `\end{markdown}` to stop scanning the markdown text. However, you can work
+% around this limitation by using the \mref{markdown} and \mref{markdownEnd}
+% macros directly in the definition as follows:
+%
+% \markdownEnd
+% \begin{markdown}
+%
+% ``` tex
+% \newenvironment{foo}\%
+% {code before \markdown[some, options]}\%
+% {\markdownEnd code after}
+% ```
+%
+% Specifically, the \mref{markdown} macro must appear at the end of the
+% replacement text and must be followed by text that has not yet been ingested
+% by \TeX's input processor. Furthermore, using the \mref{markdownEnd} macro is
+% optional and only makes a difference if you redefined it to produce special
+% effects before and after the \envmref{markdown} \LaTeX{} environment. Lastly,
+% you can't nest the other environments. For example, the following definition
+% is incorrect:
+%
+% ``` tex
+% \newenvironment{bar}{\begin{foo}}{\end{foo}}
+% ```
+%
+% In this example, you should use the \mref{markdown} macro directly in the
+% definition of the environment `bar`:
+%
+% ``` tex
+% \newenvironment{bar}{\markdown[some, options]}{\markdownEnd}
+% ```
+%
+% \end{markdown}
+% \markdownBegin
+%
+%#### The `\markinline` and `\markdownInput` macros
% The \mref{markinline} macro accepts a single mandatory parameter containing
% inline markdown content and expands to the result of the conversion of the
% input markdown document to plain \TeX{}. Unlike the \mref{markinline} macro
@@ -22395,14 +22802,14 @@ Built-in \Hologo{ConTeXt} themes provided with the Markdown package include:
% \end{markdown}
% \iffalse
%</manual-options>
-%<*themes-witiko-markdown-defaults-context>
+%<*themes-witiko-markdown-defaults-ctx>
% \fi
% \begin{macrocode}
\startmodule[markdownthemewitiko_markdown_defaults]
\unprotect
% \end{macrocode}
% \iffalse
-%</themes-witiko-markdown-defaults-context>
+%</themes-witiko-markdown-defaults-ctx>
%<*manual-options>
% \fi
% \begin{markdown}
@@ -22463,9 +22870,17 @@ local P, R, S, V, C, Cg, Cb, Cmt, Cc, Ct, B, Cs, Cp, any =
% `lunamark/util.lua` file in the Lunamark Lua module.
%
% \end{markdown}
+% \iffalse
+%</lua>
+%<*lua,lua-loader>
+% \fi
% \begin{macrocode}
local util = {}
% \end{macrocode}
+% \iffalse
+%</lua,lua-loader>
+%<*lua>
+% \fi
% \par
% \begin{markdown}
%
@@ -22480,13 +22895,17 @@ function util.err(msg, exit_code)
os.exit(exit_code or 1)
end
% \end{macrocode}
+% \iffalse
+%</lua>
+%<*lua,lua-loader>
+% \fi
% \par
% \begin{markdown}
%
-% The \luamdef{util.cache} method computes the digest of `string` and
-% `salt`, adds the `suffix` and looks into the directory `dir`, whether a
-% file with such a name exists. If it does not, it gets created with
-% `transform(string)` as its content. The filename is then returned.
+% The \luamdef{util.cache} method used `dir`, `string`, `salt`, and `suffix`
+% to determine a pathname. If a file with such a pathname does not exists,
+% it gets created with `transform(string)` as its content. Regardless, the
+% pathname is then returned.
%
% \end{markdown}
% \begin{macrocode}
@@ -22494,7 +22913,7 @@ function util.cache(dir, string, salt, transform, suffix)
local digest = md5.sumhexa(string .. (salt or ""))
local name = util.pathname(dir, digest .. suffix)
local file = io.open(name, "r")
- if file == nil then -- If no cache entry exists, then create a new one.
+ if file == nil then -- If no cache entry exists, create a new one.
file = assert(io.open(name, "w"),
[[Could not open file "]] .. name .. [[" for writing]])
local result = string
@@ -22507,6 +22926,10 @@ function util.cache(dir, string, salt, transform, suffix)
return name
end
% \end{macrocode}
+% \iffalse
+%</lua,lua-loader>
+%<*lua>
+% \fi
% \par
% \begin{markdown}
%
@@ -22765,6 +23188,10 @@ function util.escaper(char_escapes, string_escapes)
end
end
% \end{macrocode}
+% \iffalse
+%</lua>
+%<*lua,lua-loader>
+% \fi
% \par
% \begin{markdown}
%
@@ -22784,6 +23211,56 @@ end
% \par
% \begin{markdown}
%
+% The \luamdef{util.salt} method produces cryptographic salt out of a table of
+% options `options`.
+%
+% \end{markdown}
+% \begin{macrocode}
+function util.salt(options)
+ local opt_string = {}
+ for k, _ in pairs(defaultOptions) do
+ local v = options[k]
+ if type(v) == "table" then
+ for _, i in ipairs(v) do
+ opt_string[#opt_string+1] = k .. "=" .. tostring(i)
+ end
+% \end{macrocode}
+% \begin{markdown}
+%
+% The \Opt{cacheDir} option is disregarded.
+%
+% \end{markdown}
+% \begin{macrocode}
+ elseif k ~= "cacheDir" then
+ opt_string[#opt_string+1] = k .. "=" .. tostring(v)
+ end
+ end
+ table.sort(opt_string)
+ local salt = table.concat(opt_string, ",")
+ .. "," .. metadata.version
+ return salt
+end
+% \end{macrocode}
+% \par
+% \begin{markdown}
+%
+% The \luamdef{util.warning} method produces a warning `s` that is unrelated to
+% any specific markdown text being processed. For warnings that are specific to
+% a markdown text, use \luamref{writer->warning} function.
+%
+% \end{markdown}
+% \begin{macrocode}
+function util.warning(s)
+ io.stderr:write("Warning: " .. s .. "\n")
+end
+% \end{macrocode}
+% \iffalse
+%</lua,lua-loader>
+%<*lua>
+% \fi
+% \par
+% \begin{markdown}
+%
%### HTML Entities
% This section documents the \acro{HTML} entities recognized by the
% markdown reader. These functions are encapsulated in the `entities`
@@ -25100,15 +25577,6 @@ function M.writer.new(options)
% \par
% \begin{markdown}
%
-% Define \luamdef{writer->suffix} as the suffix of the produced cache files.
-%
-% \end{markdown}
-% \begin{macrocode}
- self.suffix = ".tex"
-% \end{macrocode}
-% \par
-% \begin{markdown}
-%
% Define \luamdef{writer->space} as the output format of a space character.
%
% \end{markdown}
@@ -25153,19 +25621,6 @@ function M.writer.new(options)
% \par
% \begin{markdown}
%
-% Define \luamdef{writer->pack} as a function that will take the filename
-% `name` of the output file prepared by the reader and transform it to the
-% output format.
-%
-% \end{markdown}
-% \begin{macrocode}
- function self.pack(name)
- return [[\input{]] .. name .. [[}\relax]]
- end
-% \end{macrocode}
-% \par
-% \begin{markdown}
-%
% Define \luamdef{writer->interblocksep} as the output format of a block
% element separator.
%
@@ -25269,13 +25724,17 @@ function M.writer.new(options)
["{"] = "\\markdownRendererLeftBrace{}",
["}"] = "\\markdownRendererRightBrace{}",
["\\"] = "\\markdownRendererBackslash{}",
+ ["\r"] = " ",
+ ["\n"] = " ",
}
self.escaped_minimal_strings = {
- ["^^"] = "\\markdownRendererCircumflex\\markdownRendererCircumflex ",
+ ["^^"] = "\\markdownRendererCircumflex"
+ .. "\\markdownRendererCircumflex ",
["☒"] = "\\markdownRendererTickedBox{}",
["⌛"] = "\\markdownRendererHalfTickedBox{}",
["☐"] = "\\markdownRendererUntickedBox{}",
- [entities.hex_entity('FFFD')] = "\\markdownRendererReplacementCharacter{}",
+ [entities.hex_entity('FFFD')]
+ = "\\markdownRendererReplacementCharacter{}",
}
% \end{macrocode}
% \par
@@ -25310,7 +25769,8 @@ function M.writer.new(options)
["^"] = "\\markdownRendererCircumflex{}",
["~"] = "\\markdownRendererTilde{}",
["|"] = "\\markdownRendererPipe{}",
- [entities.hex_entity('0000')] = "\\markdownRendererReplacementCharacter{}",
+ [entities.hex_entity('0000')]
+ = "\\markdownRendererReplacementCharacter{}",
}
% \end{macrocode}
% \par
@@ -25318,9 +25778,9 @@ function M.writer.new(options)
%
% Use the \luamref{writer->escaped_chars}, \luamref{writer->escaped_uri_chars},
% and \luamref{writer->escaped_minimal_strings} tables to create the
-% \luamdef{writer->escape_typographic_text},
-% \luamdef{writer->escape_programmatic_text}, and
-% \luamdef{writer->escape_minimal} escaper functions.
+% \luamdef{escape_typographic_text},
+% \luamdef{escape_programmatic_text}, and
+% \luamdef{escape_minimal} local escaper functions.
%
% \end{markdown}
% \begin{macrocode}
@@ -25372,6 +25832,34 @@ function M.writer.new(options)
% \par
% \begin{markdown}
%
+% Define \luamdef{writer->warning} as a function that will transform an input
+% warning `t` with optional more warning text `m` to the output format.
+%
+% \end{markdown}
+% \begin{macrocode}
+ function self.warning(t, m)
+ return {"\\markdownRendererWarning{", self.escape(t), "}{",
+ escape_minimal(t), "}{", self.escape(m or ""), "}{",
+ escape_minimal(m or ""), "}"}
+ end
+% \end{macrocode}
+% \par
+% \begin{markdown}
+%
+% Define \luamdef{writer->error} as a function that will transform an input
+% error text `t` with optional more error text `m` to the output format.
+%
+% \end{markdown}
+% \begin{macrocode}
+ function self.error(t, m)
+ return {"\\markdownRendererError{", self.escape(t), "}{",
+ escape_minimal(t), "}{", self.escape(m or ""), "}{",
+ escape_minimal(m or ""), "}"}
+ end
+% \end{macrocode}
+% \par
+% \begin{markdown}
+%
% Define \luamdef{writer->code} as a function that will transform an input
% inline code span `s` with optional attributes `attributes` to the output
% format.
@@ -25571,7 +26059,8 @@ function M.writer.new(options)
% \begin{macrocode}
function self.inline_html_tag(contents)
if self.flatten_inlines then return contents end
- return {"\\markdownRendererInlineHtmlTag{",self.string(contents),"}"}
+ return {"\\markdownRendererInlineHtmlTag{",
+ self.string(contents),"}"}
end
% \end{macrocode}
% \par
@@ -25671,7 +26160,23 @@ function M.writer.new(options)
% \end{markdown}
% \begin{macrocode}
function self.document(d)
- local buf = {"\\markdownRendererDocumentBegin\n", d}
+ local buf = {"\\markdownRendererDocumentBegin\n"}
+
+ -- warn against the `hybrid` option
+ if options.hybrid then
+ local text = "The `hybrid` option has been soft-deprecated."
+ local more = "Consider using one of the following better options "
+ .. "for mixing TeX and markdown: `contentBlocks`, "
+ .. "`rawAttribute`, `texComments`, `texMathDollars`, "
+ .. "`texMathSingleBackslash`, and "
+ .. "`texMathDoubleBackslash`. "
+ .. "For more information, see the user manual at "
+ .. "<https://witiko.github.io/markdown/>."
+ table.insert(buf, self.warning(text, more))
+ end
+
+ -- insert the text of the document
+ table.insert(buf, d)
-- pop all attributes
table.insert(buf, self.pop_attributes())
@@ -25862,8 +26367,10 @@ function M.writer.new(options)
% \begin{macrocode}
function self.push_attributes(attribute_type, attributes,
start_output, end_output)
- local attribute_type_level = self.attribute_type_levels[attribute_type]
- self.attribute_type_levels[attribute_type] = attribute_type_level + 1
+ local attribute_type_level
+ = self.attribute_type_levels[attribute_type]
+ self.attribute_type_levels[attribute_type]
+ = attribute_type_level + 1
-- index attributes in a hash table for easy lookup
attributes = attributes or {}
@@ -25918,8 +26425,10 @@ function M.writer.new(options)
local attributes, _, end_output
current_attribute_type, attributes, _, end_output = table.unpack(
self.active_attributes[#self.active_attributes])
- local attribute_type_level = self.attribute_type_levels[current_attribute_type]
- self.attribute_type_levels[current_attribute_type] = attribute_type_level - 1
+ local attribute_type_level
+ = self.attribute_type_levels[current_attribute_type]
+ self.attribute_type_levels[current_attribute_type]
+ = attribute_type_level - 1
if self.is_writing and end_output ~= nil then
table.insert(buf, end_output)
end
@@ -25953,7 +26462,8 @@ function M.writer.new(options)
local prev_space = false
local letter_found = false
local normalized_s = s
- if not options.unicodeNormalization or options.unicodeNormalizationForm ~= "nfc" then
+ if not options.unicodeNormalization
+ or options.unicodeNormalizationForm ~= "nfc" then
normalized_s = uni_algos.normalize.NFC(normalized_s)
end
@@ -25970,7 +26480,8 @@ function M.writer.new(options)
end
end
- -- Remove all non-alphanumeric characters, except underscores, hyphens, and periods.
+ -- Remove all non-alphanumeric characters, except underscores,
+ -- hyphens, and periods.
if not unicode.utf8.match(char, "[%w_%-%.%s]") then
goto continue
end
@@ -25998,7 +26509,8 @@ function M.writer.new(options)
table.remove(buffer)
end
- local identifier = #buffer == 0 and "section" or table.concat(buffer, "")
+ local identifier = #buffer == 0 and "section"
+ or table.concat(buffer, "")
return identifier
end
% \end{macrocode}
@@ -26013,7 +26525,8 @@ function M.writer.new(options)
local prev_space = false
local letter_found = false
local normalized_s = s
- if not options.unicodeNormalization or options.unicodeNormalizationForm ~= "nfc" then
+ if not options.unicodeNormalization
+ or options.unicodeNormalizationForm ~= "nfc" then
normalized_s = uni_algos.normalize.NFC(normalized_s)
end
@@ -26030,7 +26543,8 @@ function M.writer.new(options)
end
end
- -- Remove all non-alphanumeric characters, except underscores and hyphens.
+ -- Remove all non-alphanumeric characters, except underscores
+ -- and hyphens.
if not unicode.utf8.match(char, "[%w_%-%s]") then
prev_space = false
goto continue
@@ -26059,7 +26573,8 @@ function M.writer.new(options)
table.remove(buffer)
end
- local identifier = #buffer == 0 and "section" or table.concat(buffer, "")
+ local identifier = #buffer == 0 and "section"
+ or table.concat(buffer, "")
return identifier
end
% \end{macrocode}
@@ -26098,9 +26613,11 @@ function M.writer.new(options)
table.insert(auto_identifiers, create_auto_identifier(flat_text))
end
if self.options.gfmAutoIdentifiers then
- table.insert(auto_identifiers, create_gfm_auto_identifier(flat_text))
+ table.insert(auto_identifiers,
+ create_gfm_auto_identifier(flat_text))
end
- local normalized_attributes = normalize_attributes(attributes, auto_identifiers)
+ local normalized_attributes = normalize_attributes(attributes,
+ auto_identifiers)
-- push attributes for the new section
local start_output = {}
@@ -26116,7 +26633,8 @@ function M.writer.new(options)
-- render the heading and its attributes
if self.is_writing and #normalized_attributes > 0 then
- table.insert(buf, "\\markdownRendererHeaderAttributeContextBegin\n")
+ table.insert(buf,
+ "\\markdownRendererHeaderAttributeContextBegin\n")
table.insert(buf, self.attributes(normalized_attributes, false))
end
@@ -26274,8 +26792,13 @@ parsers.fail = P(false)
parsers.internal_punctuation = S(":;,.?")
parsers.ascii_punctuation = S("!\"#$%&'()*+,-./:;<=>?@[\\]^_`{|}~")
+
% \end{macrocode}
% \par
+% \iffalse
+%</lua>
+%<*lua-unicode-data-generator>
+% \fi
% \begin{markdown}
%
%### Unicode punctuation
@@ -26287,36 +26810,143 @@ parsers.ascii_punctuation = S("!\"#$%&'()*+,-./:;<=>?@[\\]^_`{|}~")
% [unicode-punctuation]: https://spec.commonmark.org/0.31.2/#unicode-punctuation-character
% (CommonMark Spec, Version 0.31.2 (2024-01-28))
%
+% All code from this section will be executed during the compilation of
+% the Markdown package and the standard output will be stored in a file
+% named `markdown-unicode-data.lua` with the precompiled parser of Unicode
+% punctuation.
+%
% \end{markdown}
% \begin{macrocode}
-parsers.punctuation = {}
-(function()
- local pathname = kpse.lookup("UnicodeData.txt")
+;(function()
+ local pathname = assert(kpse.find_file("UnicodeData.txt"),
+ [[Could not locate file "UnicodeData.txt"]])
local file = assert(io.open(pathname, "r"),
[[Could not open file "UnicodeData.txt"]])
+% \end{macrocode}
+% \par
+% \begin{markdown}
+%
+% In order to minimize the size and speed of the parser, we will first
+% construct a prefix tree of UTF-8 encodings for all codepoints of a
+% given code length.
+%
+% \end{markdown}
+% \begin{macrocode}
+ local prefix_trees = {}
for line in file:lines() do
local codepoint, major_category = line:match("^(%x+);[^;]*;(%a)")
if major_category == "P" or major_category == "S" then
local code = unicode.utf8.char(tonumber(codepoint, 16))
- if parsers.punctuation[#code] == nil then
- parsers.punctuation[#code] = parsers.fail
+ if prefix_trees[#code] == nil then
+ prefix_trees[#code] = {}
end
- local code_parser = parsers.succeed
+ local node = prefix_trees[#code]
for i = 1, #code do
local byte = code:sub(i, i)
- local byte_parser = S(byte)
- code_parser = code_parser
- * byte_parser
+ if i < #code then
+ if node[byte] == nil then
+ node[byte] = {}
+ end
+ node = node[byte]
+ else
+ table.insert(node, byte)
+ end
end
- parsers.punctuation[#code] = parsers.punctuation[#code]
- + code_parser
end
end
assert(file:close())
+
+% \end{macrocode}
+% \par
+% \begin{markdown}
+%
+% Next, we will construct a parser out of the prefix tree.
+%
+% \end{markdown}
+% \begin{macrocode}
+ local function depth_first_search(node, path, visit, leave)
+ visit(node, path)
+ for label, child in pairs(node) do
+ if type(child) == "table" then
+ depth_first_search(child, path .. label, visit, leave)
+ else
+ visit(child, path)
+ end
+ end
+ leave(node, path)
+ end
+
+ print("M.punctuation = {}")
+ print("local S = lpeg.S")
+ print("-- luacheck: push no max line length")
+ for length, prefix_tree in pairs(prefix_trees) do
+ local subparsers = {}
+ depth_first_search(prefix_tree, "", function(node, path)
+ if type(node) == "string" then
+ local suffix
+ if node == "]" then
+ suffix = "S('" .. node .. "')"
+ else
+ suffix = "S([[" .. node .. "]])"
+ end
+ if subparsers[path] ~= nil then
+ subparsers[path] = subparsers[path] .. " + " .. suffix
+ else
+ subparsers[path] = suffix
+ end
+ end
+ end, function(_, path)
+ if #path > 0 then
+ local byte = path:sub(#path, #path)
+ local parent_path = path:sub(1, #path-1)
+ if subparsers[path] ~= nil then
+ local suffix
+ if byte == "]" then
+ suffix = "S('" .. byte .. "')"
+ else
+ suffix = "S([[" .. byte .. "]])"
+ end
+ suffix = suffix .. " * (" .. subparsers[path] .. ")"
+ if subparsers[parent_path] ~= nil then
+ subparsers[parent_path] = subparsers[parent_path]
+ .. " + " .. suffix
+ else
+ subparsers[parent_path] = suffix
+ end
+ end
+ else
+ print("M.punctuation[" .. length .. "] = " .. subparsers[path])
+ end
+ end)
+ end
+ print("-- luacheck: pop")
end)()
+print("return M")
+% \end{macrocode}
+% \par
+% \iffalse
+%</lua-unicode-data-generator>
+%<*lua>
+% \fi
+% \begin{markdown}
+%
+% Back in the Markdown package, we will load the precompiled parser of
+% Unicode punctuation.
+%
+% \end{markdown}
+% \begin{macrocode}
+local unicode_data = require("markdown-unicode-data")
+if metadata.version ~= unicode_data.metadata.version then
+ util.warning(
+ "markdown.lua " .. metadata.version .. " used with " ..
+ "markdown-unicode-data.lua " .. unicode_data.metadata.version .. "."
+ )
+end
+parsers.punctuation = unicode_data.punctuation
parsers.escapable = parsers.ascii_punctuation
-parsers.anyescaped = parsers.backslash / "" * parsers.escapable
+parsers.anyescaped = parsers.backslash / ""
+ * parsers.escapable
+ parsers.any
parsers.spacechar = S("\t ")
@@ -26335,14 +26965,18 @@ parsers.linechar = P(1 - parsers.newline)
parsers.blankline = parsers.optionalspace
* parsers.newline / "\n"
parsers.blanklines = parsers.blankline^0
-parsers.skipblanklines = (parsers.optionalspace * parsers.newline)^0
+parsers.skipblanklines = ( parsers.optionalspace
+ * parsers.newline)^0
parsers.indentedline = parsers.indent /""
- * C(parsers.linechar^1 * parsers.newline^-1)
+ * C( parsers.linechar^1
+ * parsers.newline^-1)
parsers.optionallyindentedline = parsers.indent^-1 /""
- * C(parsers.linechar^1 * parsers.newline^-1)
+ * C( parsers.linechar^1
+ * parsers.newline^-1)
parsers.sp = parsers.spacing^0
parsers.spnl = parsers.optionalspace
- * (parsers.newline * parsers.optionalspace)^-1
+ * ( parsers.newline
+ * parsers.optionalspace)^-1
parsers.line = parsers.linechar^0 * parsers.newline
parsers.nonemptyline = parsers.line - parsers.blankline
% \end{macrocode}
@@ -26425,7 +27059,8 @@ local function update_indent_table(indent_table, new_indent, add)
if add then
indent_table.indents[#indent_table.indents + 1] = new_indent
else
- if indent_table.indents[#indent_table.indents].name == new_indent.name then
+ if indent_table.indents[#indent_table.indents].name
+ == new_indent.name then
indent_table.indents[#indent_table.indents] = nil
end
end
@@ -26441,10 +27076,12 @@ end
% \end{markdown}
% \begin{macrocode}
local function remove_indent(name)
- local function remove_indent_level(s, i, indent_table) -- luacheck: ignore s i
- indent_table = update_indent_table(indent_table, {name=name}, false)
- return true, indent_table
- end
+ local remove_indent_level =
+ function(s, i, indent_table) -- luacheck: ignore s i
+ indent_table = update_indent_table(indent_table, {name=name},
+ false)
+ return true, indent_table
+ end
return Cg(Cmt(Cb("indent_info"), remove_indent_level), "indent_info")
end
@@ -26460,7 +27097,8 @@ end
%
% \end{markdown}
% \begin{macrocode}
-local function process_starter_spacing(indent, spacing, minimum, left_strip_length)
+local function process_starter_spacing(indent, spacing,
+ minimum, left_strip_length)
left_strip_length = left_strip_length or 0
local count = 0
@@ -26497,14 +27135,16 @@ local function process_starter_spacing(indent, spacing, minimum, left_strip_leng
minimum_remainder = minimum_remainder .. character
elseif (count >= minimum) then
minimum_found = true
- minimum_remainder = minimum_remainder .. string.rep(" ", count - minimum)
+ minimum_remainder = minimum_remainder
+ .. string.rep(" ", count - minimum)
end
if (code_started) then
code_start = code_start .. character
elseif (count >= minimum + 4) then
code_started = true
- code_start = code_start .. string.rep(" ", count - (minimum + 4))
+ code_start = code_start
+ .. string.rep(" ", count - (minimum + 4))
end
end
end
@@ -26571,7 +27211,8 @@ end
%
% \end{markdown}
% \begin{macrocode}
-local function process_starter_indent(_, _, indent_table, starter, is_blank, indent_type, breakable)
+local function process_starter_indent(_, _, indent_table, starter,
+ is_blank, indent_type, breakable)
local last_trail = starter[1]
local delimiter = starter[2]
local raw_new_trail = starter[3]
@@ -26599,11 +27240,13 @@ local function process_starter_indent(_, _, indent_table, starter, is_blank, ind
local last_trail_length = #last_trail
local delimiter_length = total_delimiter_length(delimiter)
- local total_indent_level = preceding_indentation + last_trail_length + delimiter_length
+ local total_indent_level = preceding_indentation + last_trail_length
+ + delimiter_length
local sp = {}
if not is_blank then
- sp = process_starter_spacing(total_indent_level, raw_new_trail, 0, 1)
+ sp = process_starter_spacing(total_indent_level, raw_new_trail,
+ 0, 1)
end
local del_trail_length = sp.left_total_stripped
@@ -26613,12 +27256,17 @@ local function process_starter_indent(_, _, indent_table, starter, is_blank, ind
del_trail_length = del_trail_length + #sp.remainder
end
- local indent_length = last_trail_length + delimiter_length + del_trail_length
+ local indent_length = last_trail_length + delimiter_length
+ + del_trail_length
local new_indent_info = {name=indent_type, length=indent_length}
- indent_table = update_indent_table(indent_table, new_indent_info, true)
- indent_table = add_trail(indent_table, {is_code=sp.is_code, remainder=sp.remainder, total_length=sp.total_length,
- full_remainder=sp.full_remainder})
+ indent_table = update_indent_table(indent_table, new_indent_info,
+ true)
+ indent_table = add_trail(indent_table,
+ {is_code=sp.is_code,
+ remainder=sp.remainder,
+ total_length=sp.total_length,
+ full_remainder=sp.full_remainder})
return true, indent_table
end
@@ -26636,7 +27284,8 @@ local function decode_pattern(name)
delimeter = parsers.more
end
- return C(parsers.optionalspace) * C(delimeter) * C(parsers.optionalspace) * Cp()
+ return C(parsers.optionalspace) * C(delimeter)
+ * C(parsers.optionalspace) * Cp()
end
% \end{macrocode}
@@ -26677,7 +27326,8 @@ end
%
% \end{markdown}
% \begin{macrocode}
-local function traverse_indent(s, i, indent_table, is_optional, is_blank, current_line_indents)
+local function traverse_indent(s, i, indent_table, is_optional,
+ is_blank, current_line_indents)
local new_index = i
local preceding_indentation = 0
@@ -26696,12 +27346,17 @@ local function traverse_indent(s, i, indent_table, is_optional, is_blank, curren
-- match decoded pattern
local new_indent_info = lpeg.match(Ct(pattern), s, new_index)
if new_indent_info == nil then
- local blankline_end = lpeg.match(Ct(parsers.blankline * Cg(Cp(), "pos")), s, new_index)
- if is_optional or not indent_table.ignore_blockquote_blank or not blankline_end then
- return is_optional, new_index, current_trail, current_line_indents
+ local blankline_end = lpeg.match(
+ Ct(parsers.blankline * Cg(Cp(), "pos")), s, new_index)
+ if is_optional or not indent_table.ignore_blockquote_blank
+ or not blankline_end then
+ return is_optional, new_index, current_trail,
+ current_line_indents
end
- return traverse_indent(s, tonumber(blankline_end.pos), indent_table, is_optional, is_blank, current_line_indents)
+ return traverse_indent(s, tonumber(blankline_end.pos),
+ indent_table, is_optional, is_blank,
+ current_line_indents)
end
local raw_last_trail = new_indent_info[1]
@@ -26714,13 +27369,15 @@ local function traverse_indent(s, i, indent_table, is_optional, is_blank, curren
-- check previous trail
if not space_only and next(current_trail) == nil then
local sp = process_starter_spacing(0, raw_last_trail, 0, 0)
- current_trail = {is_code=sp.is_code, remainder=sp.remainder, total_length=sp.total_length,
+ current_trail = {is_code=sp.is_code, remainder=sp.remainder,
+ total_length=sp.total_length,
full_remainder=sp.full_remainder}
end
if next(current_trail) ~= nil then
if not space_only and current_trail.is_code then
- return is_optional, new_index, current_trail, current_line_indents
+ return is_optional, new_index, current_trail,
+ current_line_indents
end
if current_trail.internal_remainder ~= nil then
raw_last_trail = current_trail.internal_remainder
@@ -26735,7 +27392,8 @@ local function traverse_indent(s, i, indent_table, is_optional, is_blank, curren
raw_last_trail_length = #raw_last_trail
end
- local total_indent_level = preceding_indentation + raw_last_trail_length + delimiter_length
+ local total_indent_level = preceding_indentation
+ + raw_last_trail_length + delimiter_length
local spacing_to_process
local minimum = 0
@@ -26749,13 +27407,17 @@ local function traverse_indent(s, i, indent_table, is_optional, is_blank, curren
minimum = value.length
end
- local sp = process_starter_spacing(total_indent_level, spacing_to_process, minimum, left_strip_length)
+ local sp = process_starter_spacing(total_indent_level,
+ spacing_to_process, minimum,
+ left_strip_length)
if space_only and not sp.is_minimum then
- return is_optional or (is_blank and blank_starter <= index), new_index, current_trail, current_line_indents
+ return is_optional or (is_blank and blank_starter <= index),
+ new_index, current_trail, current_line_indents
end
- local indent_length = raw_last_trail_length + delimiter_length + sp.left_total_stripped
+ local indent_length = raw_last_trail_length + delimiter_length
+ + sp.left_total_stripped
-- update info for the next pattern
if not space_only then
@@ -26764,8 +27426,10 @@ local function traverse_indent(s, i, indent_table, is_optional, is_blank, curren
preceding_indentation = preceding_indentation + value.length
end
- current_trail = {is_code=sp.is_code, remainder=sp.remainder, internal_remainder=sp.minimum_remainder,
- total_length=sp.total_length, full_remainder=sp.full_remainder}
+ current_trail = {is_code=sp.is_code, remainder=sp.remainder,
+ internal_remainder=sp.minimum_remainder,
+ total_length=sp.total_length,
+ full_remainder=sp.full_remainder}
current_line_indents[#current_line_indents + 1] = new_indent_info
new_index = next_index
@@ -26793,34 +27457,36 @@ end
%
% \end{markdown}
% \begin{macrocode}
-local function check_trail_joined(s, i, indent_table, spacing, expect_code, omit_remainder) -- luacheck: ignore s i
- local is_code
- local remainder
+local check_trail_joined =
+ function(s, i, indent_table, -- luacheck: ignore s i
+ spacing, expect_code, omit_remainder)
+ local is_code
+ local remainder
- if has_trail(indent_table) then
- local trail = indent_table.trail
- is_code = trail.is_code
- if is_code then
- remainder = trail.remainder
- else
- remainder = trail.full_remainder
- end
- else
- local sp = process_starter_spacing(0, spacing, 0, 0)
- is_code = sp.is_code
- if is_code then
- remainder = sp.remainder
+ if has_trail(indent_table) then
+ local trail = indent_table.trail
+ is_code = trail.is_code
+ if is_code then
+ remainder = trail.remainder
+ else
+ remainder = trail.full_remainder
+ end
else
- remainder = sp.full_remainder
+ local sp = process_starter_spacing(0, spacing, 0, 0)
+ is_code = sp.is_code
+ if is_code then
+ remainder = sp.remainder
+ else
+ remainder = sp.full_remainder
+ end
end
- end
- local result = check_trail(expect_code, is_code)
- if omit_remainder then
- return result
+ local result = check_trail(expect_code, is_code)
+ if omit_remainder then
+ return result
+ end
+ return result, remainder
end
- return result, remainder
-end
% \end{macrocode}
% \begin{markdown}
@@ -26829,22 +27495,24 @@ end
%
% \end{markdown}
% \begin{macrocode}
-local function check_trail_length(s, i, indent_table, spacing, min, max) -- luacheck: ignore s i
- local trail
+local check_trail_length =
+ function(s, i, indent_table, -- luacheck: ignore s i
+ spacing, min, max)
+ local trail
- if has_trail(indent_table) then
- trail = indent_table.trail
- else
- trail = process_starter_spacing(0, spacing, 0, 0)
- end
+ if has_trail(indent_table) then
+ trail = indent_table.trail
+ else
+ trail = process_starter_spacing(0, spacing, 0, 0)
+ end
- local total_length = trail.total_length
- if total_length == nil then
- return false
- end
+ local total_length = trail.total_length
+ if total_length == nil then
+ return false
+ end
- return min <= total_length and total_length <= max
-end
+ return min <= total_length and total_length <= max
+ end
% \end{macrocode}
% \begin{markdown}
@@ -26854,7 +27522,8 @@ end
%
% \end{markdown}
% \begin{macrocode}
-local function check_continuation_indentation(s, i, indent_table, is_optional, is_blank)
+local function check_continuation_indentation(s, i, indent_table,
+ is_optional, is_blank)
if not has_indents(indent_table) then
return true
end
@@ -26907,27 +27576,29 @@ end
%
% \end{markdown}
% \begin{macrocode}
-local function check_trail_type(s, i, trail, spacing, trail_type) -- luacheck: ignore s i
- if trail == nil then
- trail = process_starter_spacing(0, spacing, 0, 0)
- end
+local check_trail_type =
+ function(s, i, -- luacheck: ignore s i
+ trail, spacing, trail_type)
+ if trail == nil then
+ trail = process_starter_spacing(0, spacing, 0, 0)
+ end
- if trail_type == "non-code" then
- return check_trail(false, trail.is_code)
- end
- if trail_type == "code" then
- return check_trail(true, trail.is_code)
- end
- if trail_type == "full-code" then
- if (trail.is_code) then
- return i, trail.remainder
+ if trail_type == "non-code" then
+ return check_trail(false, trail.is_code)
+ end
+ if trail_type == "code" then
+ return check_trail(true, trail.is_code)
+ end
+ if trail_type == "full-code" then
+ if (trail.is_code) then
+ return i, trail.remainder
+ end
+ return i, ""
+ end
+ if trail_type == "full-any" then
+ return i, trail.internal_remainder
end
- return i, ""
- end
- if trail_type == "full-any" then
- return i, trail.internal_remainder
end
-end
% \end{macrocode}
% \begin{markdown}
@@ -26936,20 +27607,22 @@ end
%
% \end{markdown}
% \begin{macrocode}
-local function trail_freezing(s, i, indent_table, is_freezing) -- luacheck: ignore s i
- if is_freezing then
- if indent_table.is_trail_frozen then
- indent_table.trail = indent_table.frozen_trail
+local trail_freezing =
+ function(s, i, -- luacheck: ignore s i
+ indent_table, is_freezing)
+ if is_freezing then
+ if indent_table.is_trail_frozen then
+ indent_table.trail = indent_table.frozen_trail
+ else
+ indent_table.frozen_trail = indent_table.trail
+ indent_table.is_trail_frozen = true
+ end
else
- indent_table.frozen_trail = indent_table.trail
- indent_table.is_trail_frozen = true
+ indent_table.frozen_trail = nil
+ indent_table.is_trail_frozen = false
end
- else
- indent_table.frozen_trail = nil
- indent_table.is_trail_frozen = false
+ return true, indent_table
end
- return true, indent_table
-end
% \end{macrocode}
% \begin{markdown}
@@ -26960,53 +27633,59 @@ end
%
% \end{markdown}
% \begin{macrocode}
-local function check_continuation_indentation_and_trail(s, i, indent_table, is_optional, is_blank, trail_type,
- reset_rem, omit_remainder)
- if not has_indents(indent_table) then
- local spacing, new_index = lpeg.match(C(parsers.spacechar^0) * Cp(), s, i)
- local result, remainder = check_trail_type(s, i, indent_table.trail, spacing, trail_type)
- if remainder == nil then
+local check_continuation_indentation_and_trail =
+ function (s, i, indent_table, is_optional, is_blank, trail_type,
+ reset_rem, omit_remainder)
+ if not has_indents(indent_table) then
+ local spacing, new_index = lpeg.match( C(parsers.spacechar^0)
+ * Cp(), s, i)
+ local result, remainder = check_trail_type(s, i,
+ indent_table.trail, spacing, trail_type)
+ if remainder == nil then
+ if result then
+ return new_index
+ end
+ return false
+ end
if result then
- return new_index
+ return new_index, remainder
end
return false
end
- if result then
- return new_index, remainder
- end
- return false
- end
- local passes, new_index, current_trail = traverse_indent(s, i, indent_table, is_optional, is_blank)
+ local passes, new_index, current_trail = traverse_indent(s, i,
+ indent_table, is_optional, is_blank)
+
+ if passes then
+ local spacing
+ if current_trail == nil then
+ local newer_spacing, newer_index = lpeg.match(
+ C(parsers.spacechar^0) * Cp(), s, i)
+ current_trail = process_starter_spacing(0, newer_spacing, 0, 0)
+ new_index = newer_index
+ spacing = newer_spacing
+ else
+ spacing = current_trail.remainder
+ end
+ local result, remainder = check_trail_type(s, new_index,
+ current_trail, spacing, trail_type)
+ if remainder == nil or omit_remainder then
+ if result then
+ return new_index
+ end
+ return false
+ end
- if passes then
- local spacing
- if current_trail == nil then
- local newer_spacing, newer_index = lpeg.match(C(parsers.spacechar^0) * Cp(), s, i)
- current_trail = process_starter_spacing(0, newer_spacing, 0, 0)
- new_index = newer_index
- spacing = newer_spacing
- else
- spacing = current_trail.remainder
- end
- local result, remainder = check_trail_type(s, new_index, current_trail, spacing, trail_type)
- if remainder == nil or omit_remainder then
+ if is_blank and reset_rem then
+ remainder = remove_remainder_if_blank(indent_table, remainder)
+ end
if result then
- return new_index
+ return new_index, remainder
end
return false
end
-
- if is_blank and reset_rem then
- remainder = remove_remainder_if_blank(indent_table, remainder)
- end
- if result then
- return new_index, remainder
- end
return false
end
- return false
-end
% \end{macrocode}
% \begin{markdown}
@@ -27015,14 +27694,20 @@ end
%
% \end{markdown}
% \begin{macrocode}
-parsers.check_trail = Cmt(Cb("indent_info") * C(parsers.spacechar^0) * Cc(false), check_trail_joined)
+parsers.check_trail = Cmt( Cb("indent_info") * C(parsers.spacechar^0)
+ * Cc(false), check_trail_joined)
-parsers.check_trail_no_rem = Cmt(Cb("indent_info") * C(parsers.spacechar^0) * Cc(false) * Cc(true), check_trail_joined)
+parsers.check_trail_no_rem = Cmt( Cb("indent_info")
+ * C(parsers.spacechar^0) * Cc(false)
+ * Cc(true), check_trail_joined)
-parsers.check_code_trail = Cmt(Cb("indent_info") * C(parsers.spacechar^0) * Cc(true), check_trail_joined)
+parsers.check_code_trail = Cmt( Cb("indent_info")
+ * C(parsers.spacechar^0)
+ * Cc(true), check_trail_joined)
parsers.check_trail_length_range = function(min, max)
- return Cmt(Cb("indent_info") * C(parsers.spacechar^0) * Cc(min) * Cc(max), check_trail_length)
+ return Cmt( Cb("indent_info") * C(parsers.spacechar^0) * Cc(min)
+ * Cc(max), check_trail_length)
end
parsers.check_trail_length = function(n)
@@ -27037,9 +27722,11 @@ end
%
% \end{markdown}
% \begin{macrocode}
-parsers.freeze_trail = Cg(Cmt(Cb("indent_info") * Cc(true), trail_freezing), "indent_info")
+parsers.freeze_trail = Cg( Cmt(Cb("indent_info")
+ * Cc(true), trail_freezing), "indent_info")
-parsers.unfreeze_trail = Cg(Cmt(Cb("indent_info") * Cc(false), trail_freezing), "indent_info")
+parsers.unfreeze_trail = Cg(Cmt(Cb("indent_info") * Cc(false),
+ trail_freezing), "indent_info")
% \end{macrocode}
% \begin{markdown}
@@ -27048,11 +27735,16 @@ parsers.unfreeze_trail = Cg(Cmt(Cb("indent_info") * Cc(false), trail_freezing),
%
% \end{markdown}
% \begin{macrocode}
-parsers.check_minimal_indent = Cmt(Cb("indent_info") * Cc(false), check_continuation_indentation)
+parsers.check_minimal_indent = Cmt(Cb("indent_info") * Cc(false),
+ check_continuation_indentation)
-parsers.check_optional_indent = Cmt(Cb("indent_info") * Cc(true), check_continuation_indentation)
+parsers.check_optional_indent = Cmt(Cb("indent_info") * Cc(true),
+ check_continuation_indentation)
-parsers.check_minimal_blank_indent = Cmt(Cb("indent_info") * Cc(false) * Cc(true), check_continuation_indentation)
+parsers.check_minimal_blank_indent
+ = Cmt( Cb("indent_info") * Cc(false)
+ * Cc(true)
+ , check_continuation_indentation)
% \end{macrocode}
% \begin{markdown}
@@ -27063,37 +27755,45 @@ parsers.check_minimal_blank_indent = Cmt(Cb("indent_info") * Cc(false) * Cc(true
% \end{markdown}
% \begin{macrocode}
-parsers.check_minimal_indent_and_trail = Cmt( Cb("indent_info")
- * Cc(false) * Cc(false) * Cc("non-code") * Cc(true),
- check_continuation_indentation_and_trail)
+parsers.check_minimal_indent_and_trail =
+ Cmt( Cb("indent_info")
+ * Cc(false) * Cc(false) * Cc("non-code") * Cc(true)
+ , check_continuation_indentation_and_trail)
-parsers.check_minimal_indent_and_code_trail = Cmt( Cb("indent_info")
- * Cc(false) * Cc(false) * Cc("code") * Cc(false),
- check_continuation_indentation_and_trail)
+parsers.check_minimal_indent_and_code_trail =
+ Cmt( Cb("indent_info")
+ * Cc(false) * Cc(false) * Cc("code") * Cc(false)
+ , check_continuation_indentation_and_trail)
-parsers.check_minimal_blank_indent_and_full_code_trail = Cmt( Cb("indent_info")
- * Cc(false) * Cc(true) * Cc("full-code") * Cc(true),
- check_continuation_indentation_and_trail)
+parsers.check_minimal_blank_indent_and_full_code_trail =
+ Cmt( Cb("indent_info")
+ * Cc(false) * Cc(true) * Cc("full-code") * Cc(true)
+ , check_continuation_indentation_and_trail)
-parsers.check_minimal_indent_and_any_trail = Cmt( Cb("indent_info")
- * Cc(false) * Cc(false) * Cc("full-any") * Cc(true) * Cc(false),
- check_continuation_indentation_and_trail)
+parsers.check_minimal_indent_and_any_trail =
+ Cmt( Cb("indent_info")
+ * Cc(false) * Cc(false) * Cc("full-any") * Cc(true) * Cc(false)
+ , check_continuation_indentation_and_trail)
-parsers.check_minimal_blank_indent_and_any_trail = Cmt( Cb("indent_info")
- * Cc(false) * Cc(true) * Cc("full-any") * Cc(true) * Cc(false),
- check_continuation_indentation_and_trail)
+parsers.check_minimal_blank_indent_and_any_trail =
+ Cmt( Cb("indent_info")
+ * Cc(false) * Cc(true) * Cc("full-any") * Cc(true) * Cc(false)
+ , check_continuation_indentation_and_trail)
-parsers.check_minimal_blank_indent_and_any_trail_no_rem = Cmt( Cb("indent_info")
- * Cc(false) * Cc(true) * Cc("full-any") * Cc(true) * Cc(true),
- check_continuation_indentation_and_trail)
+parsers.check_minimal_blank_indent_and_any_trail_no_rem =
+ Cmt( Cb("indent_info")
+ * Cc(false) * Cc(true) * Cc("full-any") * Cc(true) * Cc(true)
+ , check_continuation_indentation_and_trail)
-parsers.check_optional_indent_and_any_trail = Cmt( Cb("indent_info")
- * Cc(true) * Cc(false) * Cc("full-any") * Cc(true) * Cc(false),
- check_continuation_indentation_and_trail)
+parsers.check_optional_indent_and_any_trail =
+ Cmt( Cb("indent_info")
+ * Cc(true) * Cc(false) * Cc("full-any") * Cc(true) * Cc(false)
+ , check_continuation_indentation_and_trail)
-parsers.check_optional_blank_indent_and_any_trail = Cmt( Cb("indent_info")
- * Cc(true) * Cc(true) * Cc("full-any") * Cc(true) * Cc(false),
- check_continuation_indentation_and_trail)
+parsers.check_optional_blank_indent_and_any_trail =
+ Cmt( Cb("indent_info")
+ * Cc(true) * Cc(true) * Cc("full-any") * Cc(true) * Cc(false)
+ , check_continuation_indentation_and_trail)
% \end{macrocode}
% \begin{markdown}
@@ -27104,7 +27804,8 @@ parsers.check_optional_blank_indent_and_any_trail = Cmt( Cb("indent_info")
% \begin{macrocode}
parsers.spnlc_noexc = parsers.optionalspace
- * (parsers.newline * parsers.check_minimal_indent_and_any_trail)^-1
+ * ( parsers.newline
+ * parsers.check_minimal_indent_and_any_trail)^-1
parsers.spnlc = parsers.optionalspace
* (V("EndlineNoSub"))^-1
@@ -27112,7 +27813,8 @@ parsers.spnlc = parsers.optionalspace
parsers.spnlc_sep = parsers.optionalspace * V("EndlineNoSub")
+ parsers.spacechar^1
-parsers.only_blank = parsers.spacechar^0 * (parsers.newline + parsers.eof)
+parsers.only_blank = parsers.spacechar^0
+ * (parsers.newline + parsers.eof)
% \end{macrocode}
% \begin{figure}
@@ -27159,64 +27861,66 @@ parsers.commented_line_letter = parsers.linechar
+ parsers.newline
- parsers.backslash
- parsers.percent
-parsers.commented_line = Cg(Cc(""), "backslashes")
- * ((#(parsers.commented_line_letter
- - parsers.newline)
- * Cb("backslashes")
- * Cs(parsers.commented_line_letter
- - parsers.newline)^1 -- initial
- * Cg(Cc(""), "backslashes"))
- + #(parsers.backslash * parsers.backslash)
- * Cg((parsers.backslash -- even backslash
- * parsers.backslash)^1, "backslashes")
- + (parsers.backslash
- * (#parsers.percent
- * Cb("backslashes")
- / function(backslashes)
- return string.rep("\\", #backslashes / 2)
- end
- * C(parsers.percent)
- + #parsers.commented_line_letter
- * Cb("backslashes")
- * Cc("\\")
- * C(parsers.commented_line_letter))
- * Cg(Cc(""), "backslashes")))^0
- * (#parsers.percent
- * Cb("backslashes")
- / function(backslashes)
- return string.rep("\\", #backslashes / 2)
- end
- * ((parsers.percent -- comment
- * parsers.line
- * #parsers.blankline) -- blank line
- / "\n"
- + parsers.percent -- comment
- * parsers.line
- * parsers.optionalspace) -- leading tabs and spaces
- + #(parsers.newline)
- * Cb("backslashes")
- * C(parsers.newline))
-
-parsers.chunk = parsers.line * (parsers.optionallyindentedline
- - parsers.blankline)^0
-
-parsers.attribute_key_char = parsers.alphanumeric + S("-_:.")
-parsers.attribute_raw_char = parsers.alphanumeric + S("-_")
-parsers.attribute_key = (parsers.attribute_key_char
- - parsers.dash - parsers.digit)
- * parsers.attribute_key_char^0
-parsers.attribute_value = ( (parsers.dquote / "")
- * (parsers.anyescaped - parsers.dquote)^0
- * (parsers.dquote / ""))
- + ( (parsers.squote / "")
- * (parsers.anyescaped - parsers.squote)^0
- * (parsers.squote / ""))
- + ( parsers.anyescaped - parsers.dquote - parsers.rbrace
- - parsers.space)^0
-parsers.attribute_identifier = parsers.attribute_key_char^1
-parsers.attribute_classname = parsers.letter
- * parsers.attribute_key_char^0
-parsers.attribute_raw = parsers.attribute_raw_char^1
+parsers.commented_line = Cg(Cc(""), "backslashes")
+ * ((#(parsers.commented_line_letter
+ - parsers.newline)
+ * Cb("backslashes")
+ * Cs(parsers.commented_line_letter
+ - parsers.newline)^1 -- initial
+ * Cg(Cc(""), "backslashes"))
+ + #(parsers.backslash * parsers.backslash)
+ * Cg((parsers.backslash -- even backslash
+ * parsers.backslash)^1, "backslashes")
+ + (parsers.backslash
+ * (#parsers.percent
+ * Cb("backslashes")
+ / function(backslashes)
+ return string.rep("\\", #backslashes / 2)
+ end
+ * C(parsers.percent)
+ + #parsers.commented_line_letter
+ * Cb("backslashes")
+ * Cc("\\")
+ * C(parsers.commented_line_letter))
+ * Cg(Cc(""), "backslashes")))^0
+ * (#parsers.percent
+ * Cb("backslashes")
+ / function(backslashes)
+ return string.rep("\\", #backslashes / 2)
+ end
+ * ((parsers.percent -- comment
+ * parsers.line
+ * #parsers.blankline) -- blank line
+ / "\n"
+ + parsers.percent -- comment
+ * parsers.line
+ * parsers.optionalspace) -- leading spaces
+ + #(parsers.newline)
+ * Cb("backslashes")
+ * C(parsers.newline))
+
+parsers.chunk = parsers.line * (parsers.optionallyindentedline
+ - parsers.blankline)^0
+
+parsers.attribute_key_char = parsers.alphanumeric + S("-_:.")
+parsers.attribute_raw_char = parsers.alphanumeric + S("-_")
+parsers.attribute_key = (parsers.attribute_key_char
+ - parsers.dash - parsers.digit)
+ * parsers.attribute_key_char^0
+parsers.attribute_value = ( (parsers.dquote / "")
+ * (parsers.anyescaped - parsers.dquote)^0
+ * (parsers.dquote / ""))
+ + ( (parsers.squote / "")
+ * (parsers.anyescaped - parsers.squote)^0
+ * (parsers.squote / ""))
+ + ( parsers.anyescaped
+ - parsers.dquote
+ - parsers.rbrace
+ - parsers.space)^0
+parsers.attribute_identifier = parsers.attribute_key_char^1
+parsers.attribute_classname = parsers.letter
+ * parsers.attribute_key_char^0
+parsers.attribute_raw = parsers.attribute_raw_char^1
parsers.attribute = (parsers.dash * Cc(".unnumbered"))
+ C( parsers.hash
@@ -27224,7 +27928,9 @@ parsers.attribute = (parsers.dash * Cc(".unnumbered"))
+ C( parsers.period
* parsers.attribute_classname)
+ Cs( parsers.attribute_key
- * parsers.optionalspace * parsers.equal * parsers.optionalspace
+ * parsers.optionalspace
+ * parsers.equal
+ * parsers.optionalspace
* parsers.attribute_value)
parsers.attributes = parsers.lbrace
* parsers.optionalspace
@@ -27234,7 +27940,6 @@ parsers.attributes = parsers.lbrace
* parsers.optionalspace
* parsers.rbrace
-
parsers.raw_attribute = parsers.lbrace
* parsers.optionalspace
* parsers.equal
@@ -27246,7 +27951,10 @@ parsers.raw_attribute = parsers.lbrace
-- indented blocks with first line indented.
parsers.indented_blocks = function(bl)
return Cs( bl
- * (parsers.blankline^1 * parsers.indent * -parsers.blankline * bl)^0
+ * ( parsers.blankline^1
+ * parsers.indent
+ * -parsers.blankline
+ * bl)^0
* (parsers.blankline^1 + parsers.eof) )
end
% \end{macrocode}
@@ -27262,15 +27970,18 @@ local function repeat_between(pattern, min, max)
end
parsers.hexentity = parsers.ampersand * parsers.hash * C(S("Xx"))
- * C(repeat_between(parsers.hexdigit, 1, 6)) * parsers.semicolon
+ * C(repeat_between(parsers.hexdigit, 1, 6))
+ * parsers.semicolon
parsers.decentity = parsers.ampersand * parsers.hash
- * C(repeat_between(parsers.digit, 1, 7)) * parsers.semicolon
+ * C(repeat_between(parsers.digit, 1, 7))
+ * parsers.semicolon
parsers.tagentity = parsers.ampersand * C(parsers.alphanumeric^1)
* parsers.semicolon
-parsers.html_entities = parsers.hexentity / entities.hex_entity_with_x_char
- + parsers.decentity / entities.dec_entity
- + parsers.tagentity / entities.char_entity
+parsers.html_entities
+ = parsers.hexentity / entities.hex_entity_with_x_char
+ + parsers.decentity / entities.dec_entity
+ + parsers.tagentity / entities.char_entity
% \end{macrocode}
% \par
% \begin{markdown}
@@ -27284,7 +27995,8 @@ parsers.bullet = function(bullet_char, interrupting)
if interrupting then
allowed_end = C(parsers.spacechar^1) * #parsers.linechar
else
- allowed_end = C(parsers.spacechar^1) + #(parsers.newline + parsers.eof)
+ allowed_end = C(parsers.spacechar^1)
+ + #(parsers.newline + parsers.eof)
end
return parsers.check_trail
* Ct(C(bullet_char) * Cc(""))
@@ -27342,7 +28054,8 @@ parsers.inticks = parsers.openticks
%
% \end{markdown}
% \begin{macrocode}
--- case-insensitive match (we assume s is lowercase). must be single byte encoding
+-- case-insensitive match (we assume s is lowercase)
+-- must be single byte encoding
parsers.keyword_exact = function(s)
local parser = P(0)
for i=1,#s do
@@ -27424,13 +28137,14 @@ parsers.block_keyword =
parsers.keyword_exact("ul")
-- end conditions
-parsers.html_blankline_end_condition = parsers.linechar^0
- * ( parsers.newline
- * (parsers.check_minimal_blank_indent_and_any_trail
- * #parsers.blankline
- + parsers.check_minimal_indent_and_any_trail)
- * parsers.linechar^1)^0
- * (parsers.newline^-1 / "")
+parsers.html_blankline_end_condition
+ = parsers.linechar^0
+ * ( parsers.newline
+ * (parsers.check_minimal_blank_indent_and_any_trail
+ * #parsers.blankline
+ + parsers.check_minimal_indent_and_any_trail)
+ * parsers.linechar^1)^0
+ * (parsers.newline^-1 / "")
local function remove_trailing_blank_lines(s)
return s:gsub("[\n\r]+%s*$", "")
@@ -27452,9 +28166,14 @@ parsers.html_attribute_spacing = parsers.optionalspace
* parsers.optionalspace
+ parsers.spacechar^1
-parsers.html_attribute_name = (parsers.letter + parsers.colon + parsers.underscore)
- * (parsers.alphanumeric + parsers.colon + parsers.underscore
- + parsers.period + parsers.dash)^0
+parsers.html_attribute_name = ( parsers.letter
+ + parsers.colon
+ + parsers.underscore)
+ * ( parsers.alphanumeric
+ + parsers.colon
+ + parsers.underscore
+ + parsers.period
+ + parsers.dash)^0
parsers.html_attribute_value = parsers.squote
* (parsers.linechar - parsers.squote)^0
@@ -27462,9 +28181,15 @@ parsers.html_attribute_value = parsers.squote
+ parsers.dquote
* (parsers.linechar - parsers.dquote)^0
* parsers.dquote
- + ( parsers.any - parsers.spacechar - parsers.newline
- - parsers.dquote - parsers.squote - parsers.backtick
- - parsers.equal - parsers.less - parsers.more)^1
+ + ( parsers.any
+ - parsers.spacechar
+ - parsers.newline
+ - parsers.dquote
+ - parsers.squote
+ - parsers.backtick
+ - parsers.equal
+ - parsers.less
+ - parsers.more)^1
parsers.html_inline_attribute_value = parsers.squote
* (V("NoSoftLineBreakEndline")
@@ -27478,30 +28203,41 @@ parsers.html_inline_attribute_value = parsers.squote
- parsers.blankline^2
- parsers.dquote)^0
* parsers.dquote
- + (parsers.any - parsers.spacechar - parsers.newline
- - parsers.dquote - parsers.squote - parsers.backtick
- - parsers.equal - parsers.less - parsers.more)^1
-
-parsers.html_attribute_value_specification = parsers.optionalspace
- * parsers.equal
- * parsers.optionalspace
- * parsers.html_attribute_value
+ + (parsers.any
+ - parsers.spacechar
+ - parsers.newline
+ - parsers.dquote
+ - parsers.squote
+ - parsers.backtick
+ - parsers.equal
+ - parsers.less
+ - parsers.more)^1
+
+parsers.html_attribute_value_specification
+ = parsers.optionalspace
+ * parsers.equal
+ * parsers.optionalspace
+ * parsers.html_attribute_value
parsers.html_spnl = parsers.optionalspace
- * (V("NoSoftLineBreakEndline") * parsers.optionalspace)^-1
+ * (V("NoSoftLineBreakEndline")
+ * parsers.optionalspace)^-1
-parsers.html_inline_attribute_value_specification = parsers.html_spnl
- * parsers.equal
- * parsers.html_spnl
- * parsers.html_inline_attribute_value
+parsers.html_inline_attribute_value_specification
+ = parsers.html_spnl
+ * parsers.equal
+ * parsers.html_spnl
+ * parsers.html_inline_attribute_value
-parsers.html_attribute = parsers.html_attribute_spacing
- * parsers.html_attribute_name
- * parsers.html_inline_attribute_value_specification^-1
+parsers.html_attribute
+ = parsers.html_attribute_spacing
+ * parsers.html_attribute_name
+ * parsers.html_inline_attribute_value_specification^-1
-parsers.html_non_newline_attribute = parsers.spacechar^1
- * parsers.html_attribute_name
- * parsers.html_attribute_value_specification^-1
+parsers.html_non_newline_attribute
+ = parsers.spacechar^1
+ * parsers.html_attribute_name
+ * parsers.html_attribute_value_specification^-1
parsers.nested_breaking_blank = parsers.newline
* parsers.check_minimal_blank_indent
@@ -27511,49 +28247,59 @@ parsers.html_comment_start = P("<!--")
parsers.html_comment_end = P("-->")
-parsers.html_comment = Cs( parsers.html_comment_start
- * parsers.html_until_end(parsers.html_comment_end))
+parsers.html_comment
+ = Cs( parsers.html_comment_start
+ * parsers.html_until_end(parsers.html_comment_end))
parsers.html_inline_comment = (parsers.html_comment_start / "")
* -P(">") * -P("->")
- * Cs((V("NoSoftLineBreakEndline") + parsers.any
- - parsers.nested_breaking_blank - parsers.html_comment_end)^0)
+ * Cs(( V("NoSoftLineBreakEndline")
+ + parsers.any
+ - parsers.nested_breaking_blank
+ - parsers.html_comment_end)^0)
* (parsers.html_comment_end / "")
parsers.html_cdatasection_start = P("<![CDATA[")
parsers.html_cdatasection_end = P("]]>")
-parsers.html_cdatasection = Cs( parsers.html_cdatasection_start
- * parsers.html_until_end(parsers.html_cdatasection_end))
+parsers.html_cdatasection
+ = Cs( parsers.html_cdatasection_start
+ * parsers.html_until_end(parsers.html_cdatasection_end))
-parsers.html_inline_cdatasection = parsers.html_cdatasection_start
- * Cs(V("NoSoftLineBreakEndline") + parsers.any
- - parsers.nested_breaking_blank - parsers.html_cdatasection_end)^0
- * parsers.html_cdatasection_end
+parsers.html_inline_cdatasection
+ = parsers.html_cdatasection_start
+ * Cs(V("NoSoftLineBreakEndline") + parsers.any
+ - parsers.nested_breaking_blank - parsers.html_cdatasection_end)^0
+ * parsers.html_cdatasection_end
parsers.html_declaration_start = P("<!") * parsers.letter
parsers.html_declaration_end = P(">")
-parsers.html_declaration = Cs( parsers.html_declaration_start
- * parsers.html_until_end(parsers.html_declaration_end))
+parsers.html_declaration
+ = Cs( parsers.html_declaration_start
+ * parsers.html_until_end(parsers.html_declaration_end))
-parsers.html_inline_declaration = parsers.html_declaration_start
- * Cs(V("NoSoftLineBreakEndline") + parsers.any
- - parsers.nested_breaking_blank - parsers.html_declaration_end)^0
- * parsers.html_declaration_end
+parsers.html_inline_declaration
+ = parsers.html_declaration_start
+ * Cs(V("NoSoftLineBreakEndline") + parsers.any
+ - parsers.nested_breaking_blank - parsers.html_declaration_end)^0
+ * parsers.html_declaration_end
parsers.html_instruction_start = P("<?")
parsers.html_instruction_end = P("?>")
-parsers.html_instruction = Cs( parsers.html_instruction_start
- * parsers.html_until_end(parsers.html_instruction_end))
+parsers.html_instruction
+ = Cs( parsers.html_instruction_start
+ * parsers.html_until_end(parsers.html_instruction_end))
parsers.html_inline_instruction = parsers.html_instruction_start
- * Cs(V("NoSoftLineBreakEndline") + parsers.any
- - parsers.nested_breaking_blank - parsers.html_instruction_end)^0
+ * Cs( V("NoSoftLineBreakEndline")
+ + parsers.any
+ - parsers.nested_breaking_blank
+ - parsers.html_instruction_end)^0
* parsers.html_instruction_end
parsers.html_blankline = parsers.newline
@@ -27599,25 +28345,28 @@ parsers.incomplete_tag_following = parsers.spacechar
+ parsers.slash * parsers.more
+ #(parsers.newline + parsers.eof)
-parsers.incomplete_special_tag_following = parsers.spacechar
- + parsers.more
- + #(parsers.newline + parsers.eof)
+parsers.incomplete_special_tag_following = parsers.spacechar
+ + parsers.more
+ + #( parsers.newline
+ + parsers.eof)
parsers.html_incomplete_open_tag = parsers.html_tag_start
* parsers.block_keyword
* parsers.incomplete_tag_following
-parsers.html_incomplete_open_special_tag = parsers.html_tag_start
- * parsers.special_block_keyword
- * parsers.incomplete_special_tag_following
+parsers.html_incomplete_open_special_tag
+ = parsers.html_tag_start
+ * parsers.special_block_keyword
+ * parsers.incomplete_special_tag_following
parsers.html_incomplete_close_tag = parsers.html_tag_closing_start
* parsers.block_keyword
* parsers.incomplete_tag_following
-parsers.html_incomplete_close_special_tag = parsers.html_tag_closing_start
- * parsers.special_block_keyword
- * parsers.incomplete_tag_following
+parsers.html_incomplete_close_special_tag
+ = parsers.html_tag_closing_start
+ * parsers.special_block_keyword
+ * parsers.incomplete_tag_following
-- closing tags
parsers.html_close_tag = parsers.html_tag_closing_start
@@ -27655,27 +28404,33 @@ parsers.html_empty_special_tag = parsers.html_tag_start
* parsers.html_attribute^0
* parsers.html_empty_tag_end
-parsers.html_incomplete_blocks = parsers.html_incomplete_open_tag
- + parsers.html_incomplete_open_special_tag
- + parsers.html_incomplete_close_tag
+parsers.html_incomplete_blocks
+ = parsers.html_incomplete_open_tag
+ + parsers.html_incomplete_open_special_tag
+ + parsers.html_incomplete_close_tag
-- parse special html blocks
-parsers.html_blankline_ending_special_block_opening = (parsers.html_close_special_tag
- + parsers.html_empty_special_tag)
- * #(parsers.optionalspace
- * (parsers.newline + parsers.eof))
+parsers.html_blankline_ending_special_block_opening
+ = ( parsers.html_close_special_tag
+ + parsers.html_empty_special_tag)
+ * #( parsers.optionalspace
+ * (parsers.newline + parsers.eof))
-parsers.html_blankline_ending_special_block = parsers.html_blankline_ending_special_block_opening
- * parsers.html_blankline_end_condition
+parsers.html_blankline_ending_special_block
+ = parsers.html_blankline_ending_special_block_opening
+ * parsers.html_blankline_end_condition
-parsers.html_special_block_opening = parsers.html_incomplete_open_special_tag
- - parsers.html_empty_special_tag
+parsers.html_special_block_opening
+ = parsers.html_incomplete_open_special_tag
+ - parsers.html_empty_special_tag
-parsers.html_closing_special_block = parsers.html_special_block_opening
- * parsers.html_until_end(parsers.html_close_special_tag)
+parsers.html_closing_special_block
+ = parsers.html_special_block_opening
+ * parsers.html_until_end(parsers.html_close_special_tag)
-parsers.html_special_block = parsers.html_blankline_ending_special_block
- + parsers.html_closing_special_block
+parsers.html_special_block
+ = parsers.html_blankline_ending_special_block
+ + parsers.html_closing_special_block
-- parse html blocks
parsers.html_block_opening = parsers.html_incomplete_open_tag
@@ -27685,18 +28440,21 @@ parsers.html_block = parsers.html_block_opening
* parsers.html_blankline_end_condition
-- parse any html blocks
-parsers.html_any_block_opening = (parsers.html_any_open_tag
- + parsers.html_any_close_tag
- + parsers.html_any_empty_tag)
- * #(parsers.optionalspace * (parsers.newline + parsers.eof))
+parsers.html_any_block_opening
+ = ( parsers.html_any_open_tag
+ + parsers.html_any_close_tag
+ + parsers.html_any_empty_tag)
+ * #(parsers.optionalspace * (parsers.newline + parsers.eof))
parsers.html_any_block = parsers.html_any_block_opening
* parsers.html_blankline_end_condition
parsers.html_inline_comment_full = parsers.html_comment_start
* -P(">") * -P("->")
- * Cs((V("NoSoftLineBreakEndline") + parsers.any - P("--")
- - parsers.nested_breaking_blank - parsers.html_comment_end)^0)
+ * Cs(( V("NoSoftLineBreakEndline")
+ + parsers.any - P("--")
+ - parsers.nested_breaking_blank
+ - parsers.html_comment_end)^0)
* parsers.html_comment_end
parsers.html_inline_tags = parsers.html_inline_comment_full
@@ -27729,21 +28487,25 @@ parsers.auto_link_scheme = parsers.letter
* parsers.auto_link_scheme_part^-30
parsers.absolute_uri = parsers.auto_link_scheme * parsers.colon
- * (parsers.any - parsers.spacing - parsers.less - parsers.more)^0
+ * ( parsers.any - parsers.spacing
+ - parsers.less - parsers.more)^0
parsers.printable_characters = S(".!#$%&'*+/=?^_`{|}~-")
parsers.email_address_local_part_char = parsers.alphanumeric
+ parsers.printable_characters
-parsers.email_address_local_part = parsers.email_address_local_part_char^1
+parsers.email_address_local_part
+ = parsers.email_address_local_part_char^1
parsers.email_address_dns_label = parsers.alphanumeric
- * (parsers.alphanumeric + parsers.dash)^-62
+ * ( parsers.alphanumeric
+ + parsers.dash)^-62
* B(parsers.alphanumeric)
parsers.email_address_domain = parsers.email_address_dns_label
- * (parsers.period * parsers.email_address_dns_label)^0
+ * ( parsers.period
+ * parsers.email_address_dns_label)^0
parsers.email_address = parsers.email_address_local_part
* parsers.at
@@ -27799,25 +28561,37 @@ parsers.link_text = parsers.lbracket
+ parsers.autolink
+ V("InlineHtml")
+ ( parsers.backslash * parsers.backslash)
- + ( parsers.backslash * (parsers.lbracket + parsers.rbracket)
+ + ( parsers.backslash
+ * ( parsers.lbracket
+ + parsers.rbracket)
+ V("NoSoftLineBreakSpace")
+ V("NoSoftLineBreakEndline")
+ (parsers.any
- - (parsers.newline + parsers.lbracket + parsers.rbracket + parsers.blankline^2))))^0)
+ - ( parsers.newline
+ + parsers.lbracket
+ + parsers.rbracket
+ + parsers.blankline^2))))^0)
* parsers.rbracket
parsers.link_label_body = -#(parsers.sp * parsers.rbracket)
- * #((parsers.any - parsers.rbracket)^-999 * parsers.rbracket)
+ * #( ( parsers.any
+ - parsers.rbracket)^-999
+ * parsers.rbracket)
* Cs((parsers.alphanumeric^1
+ parsers.inticks
+ parsers.autolink
+ V("InlineHtml")
+ ( parsers.backslash * parsers.backslash)
- + ( parsers.backslash * (parsers.lbracket + parsers.rbracket)
+ + ( parsers.backslash
+ * ( parsers.lbracket
+ + parsers.rbracket)
+ V("NoSoftLineBreakSpace")
+ V("NoSoftLineBreakEndline")
+ (parsers.any
- - (parsers.newline + parsers.lbracket + parsers.rbracket + parsers.blankline^2))))^1)
+ - ( parsers.newline
+ + parsers.lbracket
+ + parsers.rbracket
+ + parsers.blankline^2))))^1)
parsers.link_label = parsers.lbracket
* parsers.link_label_body
@@ -27847,29 +28621,38 @@ parsers.title_s = parsers.squote
* Cs((parsers.html_entities
+ V("NoSoftLineBreakSpace")
+ V("NoSoftLineBreakEndline")
- + (parsers.anyescaped - parsers.newline - parsers.squote - parsers.blankline^2))^0)
+ + ( parsers.anyescaped
+ - parsers.newline
+ - parsers.squote
+ - parsers.blankline^2))^0)
* parsers.squote
parsers.title_d = parsers.dquote
* Cs((parsers.html_entities
+ V("NoSoftLineBreakSpace")
+ V("NoSoftLineBreakEndline")
- + (parsers.anyescaped - parsers.newline - parsers.dquote - parsers.blankline^2))^0)
+ + ( parsers.anyescaped
+ - parsers.newline
+ - parsers.dquote
+ - parsers.blankline^2))^0)
* parsers.dquote
parsers.title_p = parsers.lparent
* Cs((parsers.html_entities
+ V("NoSoftLineBreakSpace")
+ V("NoSoftLineBreakEndline")
- + (parsers.anyescaped - parsers.newline - parsers.lparent - parsers.rparent
+ + ( parsers.anyescaped
+ - parsers.newline
+ - parsers.lparent
+ - parsers.rparent
- parsers.blankline^2))^0)
* parsers.rparent
-parsers.title = parsers.title_d + parsers.title_s + parsers.title_p
+parsers.title
+ = parsers.title_d + parsers.title_s + parsers.title_p
parsers.optionaltitle
- = parsers.spnlc * parsers.title * parsers.spacechar^0
- + Cc("")
+ = parsers.spnlc * parsers.title * parsers.spacechar^0 + Cc("")
% \end{macrocode}
% \par
@@ -27880,9 +28663,11 @@ parsers.optionaltitle
% \end{markdown}
% \begin{macrocode}
-- parse a reference definition: [foo]: /bar "title"
-parsers.define_reference_parser = (parsers.check_trail / "") * parsers.link_label * parsers.colon
+parsers.define_reference_parser = (parsers.check_trail / "")
+ * parsers.link_label * parsers.colon
* parsers.spnlc * parsers.url
- * ( parsers.spnlc_sep * parsers.title * parsers.only_blank
+ * ( parsers.spnlc_sep * parsers.title
+ * parsers.only_blank
+ Cc("") * parsers.only_blank)
% \end{macrocode}
% \par
@@ -27897,7 +28682,10 @@ parsers.Inline = V("Inline")
-- parse many p between starter and ender
parsers.between = function(p, starter, ender)
local ender2 = B(parsers.nonspacechar) * ender
- return (starter * #parsers.nonspacechar * Ct(p * (p - ender2)^0) * ender2)
+ return ( starter
+ * #parsers.nonspacechar
+ * Ct(p * (p - ender2)^0)
+ * ender2)
end
% \end{macrocode}
@@ -27909,7 +28697,8 @@ end
% \end{markdown}
% \begin{macrocode}
parsers.lineof = function(c)
- return (parsers.check_trail_no_rem * (P(c) * parsers.optionalspace)^3
+ return ( parsers.check_trail_no_rem
+ * (P(c) * parsers.optionalspace)^3
* (parsers.newline + parsers.eof))
end
@@ -27929,8 +28718,11 @@ parsers.heading_start = #parsers.hash * C(parsers.hash^-6)
* -parsers.hash / length
-- parse setext header ending and return level
-parsers.heading_level = parsers.nonindentspace * parsers.equal^1 * parsers.optionalspace * #parsers.newline * Cc(1)
- + parsers.nonindentspace * parsers.dash^1 * parsers.optionalspace * #parsers.newline * Cc(2)
+parsers.heading_level
+ = parsers.nonindentspace * parsers.equal^1
+ * parsers.optionalspace * #parsers.newline * Cc(1)
+ + parsers.nonindentspace * parsers.dash^1
+ * parsers.optionalspace * #parsers.newline * Cc(2)
local function strip_atx_end(s)
return s:gsub("%s+#*%s*\n$","")
@@ -28102,9 +28894,11 @@ function M.reader.new(writer, options)
local prefix = lpeg.match(C(parsers.optionalspace), line)
local prefix_length = #prefix
local is_shorter = min_prefix_length == nil
- is_shorter = is_shorter or prefix_length < min_prefix_length
+ if not is_shorter then
+ is_shorter = prefix_length < min_prefix_length
+ end
if is_shorter then
- min_prefix_length, min_prefix = prefix_length, prefix
+ min_prefix_length, min_prefix = prefix_length, prefix
end
return line
end)
@@ -28126,7 +28920,11 @@ function M.reader.new(writer, options)
end
local res = lpeg.match(grammar(), str)
if res == nil then
- error(format("%s failed on:\n%s", name, str:sub(1,20)))
+ return writer.error(
+ format("Parser `%s` failed to process the input text.", name),
+ format("Here are the first 20 characters of the remaining "
+ .. "unprocessed text: `%s`.", str:sub(1,20))
+ )
else
return res
end
@@ -28176,35 +28974,47 @@ function M.reader.new(writer, options)
%
% \end{markdown}
% \begin{macrocode}
- parsers.minimally_indented_blankline = parsers.check_minimal_indent * (parsers.blankline / "")
+ parsers.minimally_indented_blankline
+ = parsers.check_minimal_indent * (parsers.blankline / "")
- parsers.minimally_indented_block = parsers.check_minimal_indent * V("Block")
+ parsers.minimally_indented_block
+ = parsers.check_minimal_indent * V("Block")
- parsers.minimally_indented_block_or_paragraph = parsers.check_minimal_indent * V("BlockOrParagraph")
+ parsers.minimally_indented_block_or_paragraph
+ = parsers.check_minimal_indent * V("BlockOrParagraph")
- parsers.minimally_indented_paragraph = parsers.check_minimal_indent * V("Paragraph")
+ parsers.minimally_indented_paragraph
+ = parsers.check_minimal_indent * V("Paragraph")
- parsers.minimally_indented_plain = parsers.check_minimal_indent * V("Plain")
+ parsers.minimally_indented_plain
+ = parsers.check_minimal_indent * V("Plain")
- parsers.minimally_indented_par_or_plain = parsers.minimally_indented_paragraph
- + parsers.minimally_indented_plain
+ parsers.minimally_indented_par_or_plain
+ = parsers.minimally_indented_paragraph
+ + parsers.minimally_indented_plain
- parsers.minimally_indented_par_or_plain_no_blank = parsers.minimally_indented_par_or_plain
- - parsers.minimally_indented_blankline
+ parsers.minimally_indented_par_or_plain_no_blank
+ = parsers.minimally_indented_par_or_plain
+ - parsers.minimally_indented_blankline
- parsers.minimally_indented_ref = parsers.check_minimal_indent * V("Reference")
+ parsers.minimally_indented_ref
+ = parsers.check_minimal_indent * V("Reference")
- parsers.minimally_indented_blank = parsers.check_minimal_indent * V("Blank")
+ parsers.minimally_indented_blank
+ = parsers.check_minimal_indent * V("Blank")
- parsers.conditionally_indented_blankline = parsers.check_minimal_blank_indent * (parsers.blankline / "")
+ parsers.conditionally_indented_blankline
+ = parsers.check_minimal_blank_indent * (parsers.blankline / "")
- parsers.minimally_indented_ref_or_block = parsers.minimally_indented_ref
- + parsers.minimally_indented_block
- - parsers.minimally_indented_blankline
+ parsers.minimally_indented_ref_or_block
+ = parsers.minimally_indented_ref
+ + parsers.minimally_indented_block
+ - parsers.minimally_indented_blankline
- parsers.minimally_indented_ref_or_block_or_par = parsers.minimally_indented_ref
- + parsers.minimally_indented_block_or_paragraph
- - parsers.minimally_indented_blankline
+ parsers.minimally_indented_ref_or_block_or_par
+ = parsers.minimally_indented_ref
+ + parsers.minimally_indented_block_or_paragraph
+ - parsers.minimally_indented_blankline
% \end{macrocode}
% \begin{markdown}
@@ -28214,7 +29024,8 @@ function M.reader.new(writer, options)
% \end{markdown}
% \begin{macrocode}
- parsers.separator_loop = function(separated_block, paragraph, block_separator, paragraph_separator)
+ function parsers.separator_loop(separated_block, paragraph,
+ block_separator, paragraph_separator)
return separated_block
+ block_separator
* paragraph
@@ -28223,10 +29034,14 @@ function M.reader.new(writer, options)
* paragraph
end
- parsers.create_loop_body_pair = function(separated_block, paragraph, block_separator, paragraph_separator)
+ function parsers.create_loop_body_pair(separated_block, paragraph,
+ block_separator,
+ paragraph_separator)
return {
- block = parsers.separator_loop(separated_block, paragraph, block_separator, block_separator),
- par = parsers.separator_loop(separated_block, paragraph, block_separator, paragraph_separator)
+ block = parsers.separator_loop(separated_block, paragraph,
+ block_separator, block_separator),
+ par = parsers.separator_loop(separated_block, paragraph,
+ block_separator, paragraph_separator)
}
end
@@ -28249,18 +29064,20 @@ function M.reader.new(writer, options)
parsers.content_blank = parsers.minimally_indented_blankline
- parsers.ref_or_block_separated = parsers.sep_group_no_output(parsers.content_blank)
- * ( parsers.minimally_indented_ref
- - parsers.content_blank)
- + parsers.block_sep_group(parsers.content_blank)
- * ( parsers.minimally_indented_block
- - parsers.content_blank)
+ parsers.ref_or_block_separated
+ = parsers.sep_group_no_output(parsers.content_blank)
+ * ( parsers.minimally_indented_ref
+ - parsers.content_blank)
+ + parsers.block_sep_group(parsers.content_blank)
+ * ( parsers.minimally_indented_block
+ - parsers.content_blank)
parsers.loop_body_pair =
- parsers.create_loop_body_pair(parsers.ref_or_block_separated,
- parsers.minimally_indented_par_or_plain_no_blank,
- parsers.block_sep_group(parsers.content_blank),
- parsers.par_sep_group(parsers.content_blank))
+ parsers.create_loop_body_pair(
+ parsers.ref_or_block_separated,
+ parsers.minimally_indented_par_or_plain_no_blank,
+ parsers.block_sep_group(parsers.content_blank),
+ parsers.par_sep_group(parsers.content_blank))
parsers.content_loop = ( V("Block")
* parsers.loop_body_pair.block^0
@@ -28284,7 +29101,8 @@ function M.reader.new(writer, options)
parsers.add_indent = function(pattern, name, breakable)
return Cg(Cmt( Cb("indent_info")
* Ct(pattern)
- * (#parsers.linechar * Cc(false) + Cc(true)) -- check if starter is blank
+ * ( #parsers.linechar -- check if starter is blank
+ * Cc(false) + Cc(true))
* Cc(name)
* Cc(breakable),
process_starter_indent), "indent_info")
@@ -28312,7 +29130,8 @@ function M.reader.new(writer, options)
allowed_end = C(parsers.spacechar^1) * #parsers.linechar
else
delimiter_range = parsers.dig * parsers.dig^-8
- allowed_end = C(parsers.spacechar^1) + #(parsers.newline + parsers.eof)
+ allowed_end = C(parsers.spacechar^1)
+ + #(parsers.newline + parsers.eof)
end
return parsers.check_trail
@@ -28334,16 +29153,21 @@ function M.reader.new(writer, options)
%
% \end{markdown}
% \begin{macrocode}
- parsers.blockquote_start = parsers.check_trail * C(parsers.more) * C(parsers.spacechar^0)
+ parsers.blockquote_start
+ = parsers.check_trail
+ * C(parsers.more)
+ * C(parsers.spacechar^0)
- parsers.blockquote_body = parsers.add_indent(parsers.blockquote_start, "bq", true)
- * parsers.indented_content()
- * remove_indent("bq")
+ parsers.blockquote_body
+ = parsers.add_indent(parsers.blockquote_start, "bq", true)
+ * parsers.indented_content()
+ * remove_indent("bq")
if not options.breakableBlockquotes then
- parsers.blockquote_body = parsers.add_indent(parsers.blockquote_start, "bq", false)
- * parsers.indented_content()
- * remove_indent("bq")
+ parsers.blockquote_body
+ = parsers.add_indent(parsers.blockquote_start, "bq", false)
+ * parsers.indented_content()
+ * remove_indent("bq")
end
% \end{macrocode}
% \par
@@ -28357,7 +29181,8 @@ function M.reader.new(writer, options)
% \begin{macrocode}
local function parse_content_part(content_part)
local rope = util.rope_to_string(content_part)
- local parsed = self.parser_functions.parse_inlines_no_link_or_emphasis(rope)
+ local parsed
+ = self.parser_functions.parse_inlines_no_link_or_emphasis(rope)
parsed.indent_info = nil
return parsed
end
@@ -28369,37 +29194,40 @@ function M.reader.new(writer, options)
%
% \end{markdown}
% \begin{macrocode}
- local function collect_emphasis_content(t, opening_index, closing_index)
- local content = {}
+ local collect_emphasis_content =
+ function(t, opening_index, closing_index)
+ local content = {}
- local content_part = {}
- for i = opening_index, closing_index do
- local value = t[i]
+ local content_part = {}
+ for i = opening_index, closing_index do
+ local value = t[i]
- if value.rendered ~= nil then
- content[#content + 1] = parse_content_part(content_part)
- content_part = {}
- content[#content + 1] = value.rendered
- value.rendered = nil
- else
- if value.type == "delimiter" and value.element == "emphasis" then
- if value.is_active then
- content_part[#content_part + 1] = string.rep(value.character, value.current_count)
- end
+ if value.rendered ~= nil then
+ content[#content + 1] = parse_content_part(content_part)
+ content_part = {}
+ content[#content + 1] = value.rendered
+ value.rendered = nil
else
- content_part[#content_part + 1] = value.content
+ if value.type == "delimiter"
+ and value.element == "emphasis" then
+ if value.is_active then
+ content_part[#content_part + 1]
+ = string.rep(value.character, value.current_count)
+ end
+ else
+ content_part[#content_part + 1] = value.content
+ end
+ value.content = ''
+ value.is_active = false
end
- value.content = ''
- value.is_active = false
end
- end
- if next(content_part) ~= nil then
- content[#content + 1] = parse_content_part(content_part)
- end
+ if next(content_part) ~= nil then
+ content[#content + 1] = parse_content_part(content_part)
+ end
- return content
- end
+ return content
+ end
% \end{macrocode}
% \begin{markdown}
@@ -28410,7 +29238,9 @@ function M.reader.new(writer, options)
% \end{markdown}
% \begin{macrocode}
local function fill_emph(t, opening_index, closing_index)
- local content = collect_emphasis_content(t, opening_index + 1, closing_index - 1)
+ local content
+ = collect_emphasis_content(t, opening_index + 1,
+ closing_index - 1)
t[opening_index + 1].is_active = true
t[opening_index + 1].rendered = writer.emphasis(content)
end
@@ -28424,7 +29254,9 @@ function M.reader.new(writer, options)
% \end{markdown}
% \begin{macrocode}
local function fill_strong(t, opening_index, closing_index)
- local content = collect_emphasis_content(t, opening_index + 1, closing_index - 1)
+ local content
+ = collect_emphasis_content(t, opening_index + 1,
+ closing_index - 1)
t[opening_index + 1].is_active = true
t[opening_index + 1].rendered = writer.strong(content)
end
@@ -28438,9 +29270,12 @@ function M.reader.new(writer, options)
% \end{markdown}
% \begin{macrocode}
local function breaks_three_rule(opening_delimiter, closing_delimiter)
- return (opening_delimiter.is_closing or closing_delimiter.is_opening) and
- ((opening_delimiter.original_count + closing_delimiter.original_count) % 3 == 0) and
- (opening_delimiter.original_count % 3 ~= 0 or closing_delimiter.original_count % 3 ~= 0)
+ return ( opening_delimiter.is_closing
+ or closing_delimiter.is_opening)
+ and (( opening_delimiter.original_count
+ + closing_delimiter.original_count) % 3 == 0)
+ and ( opening_delimiter.original_count % 3 ~= 0
+ or closing_delimiter.original_count % 3 ~= 0)
end
% \end{macrocode}
@@ -28452,7 +29287,8 @@ function M.reader.new(writer, options)
%
% \end{markdown}
% \begin{macrocode}
- local function find_emphasis_opener(t, bottom_index, latest_index, character, closing_delimiter)
+ local find_emphasis_opener = function(t, bottom_index, latest_index,
+ character, closing_delimiter)
for i = latest_index, bottom_index, -1 do
local value = t[i]
if value.is_active and
@@ -28516,12 +29352,18 @@ function M.reader.new(writer, options)
local is_opening = value.is_opening
local closing_length_modulo_three = value.original_count % 3
- local current_openers_bottom = openers_bottom[character][is_opening][closing_length_modulo_three + 1]
+ local current_openers_bottom
+ = openers_bottom[character][is_opening]
+ [closing_length_modulo_three + 1]
- local opener_position = find_emphasis_opener(t, current_openers_bottom, current_position - 1, character, value)
+ local opener_position
+ = find_emphasis_opener(t, current_openers_bottom,
+ current_position - 1, character, value)
if (opener_position == nil) then
- openers_bottom[character][is_opening][closing_length_modulo_three + 1] = current_position
+ openers_bottom[character][is_opening]
+ [closing_length_modulo_three + 1]
+ = current_position
current_position = current_position + 1
goto continue
end
@@ -28531,7 +29373,8 @@ function M.reader.new(writer, options)
local current_opening_count = opening_delimiter.current_count
local current_closing_count = t[current_position].current_count
- if (current_opening_count >= 2) and (current_closing_count >= 2) then
+ if (current_opening_count >= 2)
+ and (current_closing_count >= 2) then
opening_delimiter.current_count = current_opening_count - 2
t[current_position].current_count = current_closing_count - 2
fill_strong(t, opener_position, current_position)
@@ -28615,15 +29458,19 @@ function M.reader.new(writer, options)
return check_unicode_type(s, i, 0, 3, "%s")
end
- parsers.unicode_preceding_punctuation = B(parsers.escapable)
- + Cmt(parsers.succeed, check_preceding_unicode_punctuation)
+ parsers.unicode_preceding_punctuation
+ = B(parsers.escapable)
+ + Cmt(parsers.succeed, check_preceding_unicode_punctuation)
- parsers.unicode_preceding_whitespace = Cmt(parsers.succeed, check_preceding_unicode_whitespace)
+ parsers.unicode_preceding_whitespace
+ = Cmt(parsers.succeed, check_preceding_unicode_whitespace)
- parsers.unicode_following_punctuation = #parsers.escapable
- + Cmt(parsers.succeed, check_following_unicode_punctuation)
+ parsers.unicode_following_punctuation
+ = #parsers.escapable
+ + Cmt(parsers.succeed, check_following_unicode_punctuation)
- parsers.unicode_following_whitespace = Cmt(parsers.succeed, check_following_unicode_whitespace)
+ parsers.unicode_following_whitespace
+ = Cmt(parsers.succeed, check_following_unicode_whitespace)
parsers.delimiter_run = function(character)
return (B(parsers.backslash * character) + -B(character))
@@ -28633,49 +29480,58 @@ function M.reader.new(writer, options)
parsers.left_flanking_delimiter_run = function(character)
return (B( parsers.any)
- * (parsers.unicode_preceding_punctuation + parsers.unicode_preceding_whitespace)
+ * ( parsers.unicode_preceding_punctuation
+ + parsers.unicode_preceding_whitespace)
+ -B(parsers.any))
* parsers.delimiter_run(character)
* parsers.unicode_following_punctuation
+ parsers.delimiter_run(character)
- * -#(parsers.unicode_following_punctuation + parsers.unicode_following_whitespace
+ * -#( parsers.unicode_following_punctuation
+ + parsers.unicode_following_whitespace
+ parsers.eof)
end
parsers.right_flanking_delimiter_run = function(character)
return parsers.unicode_preceding_punctuation
* parsers.delimiter_run(character)
- * (parsers.unicode_following_punctuation + parsers.unicode_following_whitespace
+ * ( parsers.unicode_following_punctuation
+ + parsers.unicode_following_whitespace
+ parsers.eof)
+ (B(parsers.any)
- * -(parsers.unicode_preceding_punctuation + parsers.unicode_preceding_whitespace))
+ * -( parsers.unicode_preceding_punctuation
+ + parsers.unicode_preceding_whitespace))
* parsers.delimiter_run(character)
end
if options.underscores then
- parsers.emph_start = parsers.left_flanking_delimiter_run(parsers.asterisk)
- + (-#parsers.right_flanking_delimiter_run(parsers.underscore)
- + (parsers.unicode_preceding_punctuation
- * #parsers.right_flanking_delimiter_run(parsers.underscore)))
- * parsers.left_flanking_delimiter_run(parsers.underscore)
-
- parsers.emph_end = parsers.right_flanking_delimiter_run(parsers.asterisk)
- + (-#parsers.left_flanking_delimiter_run(parsers.underscore)
- + #(parsers.left_flanking_delimiter_run(parsers.underscore)
- * parsers.unicode_following_punctuation))
- * parsers.right_flanking_delimiter_run(parsers.underscore)
+ parsers.emph_start
+ = parsers.left_flanking_delimiter_run(parsers.asterisk)
+ + ( -#parsers.right_flanking_delimiter_run(parsers.underscore)
+ + ( parsers.unicode_preceding_punctuation
+ * #parsers.right_flanking_delimiter_run(parsers.underscore)))
+ * parsers.left_flanking_delimiter_run(parsers.underscore)
+
+ parsers.emph_end
+ = parsers.right_flanking_delimiter_run(parsers.asterisk)
+ + ( -#parsers.left_flanking_delimiter_run(parsers.underscore)
+ + #( parsers.left_flanking_delimiter_run(parsers.underscore)
+ * parsers.unicode_following_punctuation))
+ * parsers.right_flanking_delimiter_run(parsers.underscore)
else
- parsers.emph_start = parsers.left_flanking_delimiter_run(parsers.asterisk)
+ parsers.emph_start
+ = parsers.left_flanking_delimiter_run(parsers.asterisk)
- parsers.emph_end = parsers.right_flanking_delimiter_run(parsers.asterisk)
+ parsers.emph_end
+ = parsers.right_flanking_delimiter_run(parsers.asterisk)
end
- parsers.emph_capturing_open_and_close = #parsers.emph_start * #parsers.emph_end
- * Ct( Cg(Cc("delimiter"), "type")
- * Cg(Cc("emphasis"), "element")
- * Cg(C(parsers.emph_start), "content")
- * Cg(Cc(true), "is_opening")
- * Cg(Cc(true), "is_closing"))
+ parsers.emph_capturing_open_and_close
+ = #parsers.emph_start * #parsers.emph_end
+ * Ct( Cg(Cc("delimiter"), "type")
+ * Cg(Cc("emphasis"), "element")
+ * Cg(C(parsers.emph_start), "content")
+ * Cg(Cc(true), "is_opening")
+ * Cg(Cc(true), "is_closing"))
parsers.emph_capturing_open = Ct( Cg(Cc("delimiter"), "type")
* Cg(Cc("emphasis"), "element")
@@ -28765,17 +29621,24 @@ function M.reader.new(writer, options)
parsers.title_s_direct_ref = parsers.squote
* Cs((parsers.html_entities
- + (parsers.anyescaped - parsers.squote - parsers.blankline^2))^0)
+ + ( parsers.anyescaped
+ - parsers.squote
+ - parsers.blankline^2))^0)
* parsers.squote
parsers.title_d_direct_ref = parsers.dquote
* Cs((parsers.html_entities
- + (parsers.anyescaped - parsers.dquote - parsers.blankline^2))^0)
+ + ( parsers.anyescaped
+ - parsers.dquote
+ - parsers.blankline^2))^0)
* parsers.dquote
parsers.title_p_direct_ref = parsers.lparent
* Cs((parsers.html_entities
- + (parsers.anyescaped - parsers.lparent - parsers.rparent - parsers.blankline^2))^0)
+ + ( parsers.anyescaped
+ - parsers.lparent
+ - parsers.rparent
+ - parsers.blankline^2))^0)
* parsers.rparent
parsers.title_direct_ref = parsers.title_s_direct_ref
@@ -28785,7 +29648,8 @@ function M.reader.new(writer, options)
parsers.inline_direct_ref_inside = parsers.lparent * parsers.spnl
* Cg(parsers.url + Cc(""), "url")
* parsers.spnl
- * Cg(parsers.title_direct_ref + Cc(""), "title")
+ * Cg( parsers.title_direct_ref
+ + Cc(""), "title")
* parsers.spnl * parsers.rparent
parsers.inline_direct_ref = parsers.lparent * parsers.spnlc
@@ -28813,7 +29677,8 @@ function M.reader.new(writer, options)
* Cg(Cc("inline"), "link_type")
+ #(parsers.exclamation * parsers.full_link)
* Cg(Cc("full"), "link_type")
- + #(parsers.exclamation * parsers.collapsed_link)
+ + #( parsers.exclamation
+ * parsers.collapsed_link)
* Cg(Cc("collapsed"), "link_type")
+ #(parsers.exclamation * parsers.shortcut_link)
* Cg(Cc("shortcut"), "link_type")
@@ -28844,15 +29709,18 @@ function M.reader.new(writer, options)
local inline_note_element = Cg(Cc("note"), "element")
* parsers.note_opening
- * Cg(parsers.circumflex * parsers.lbracket, "content")
+ * Cg( parsers.circumflex
+ * parsers.lbracket, "content")
local image_element = Cg(Cc("image"), "element")
* parsers.image_opening
- * Cg(parsers.exclamation * parsers.lbracket, "content")
+ * Cg( parsers.exclamation
+ * parsers.lbracket, "content")
local note_element = Cg(Cc("note"), "element")
* parsers.raw_note_opening
- * Cg(parsers.lbracket * parsers.circumflex, "content")
+ * Cg( parsers.lbracket
+ * parsers.circumflex, "content")
local link_element = Cg(Cc("link"), "element")
* parsers.link_opening
@@ -28882,7 +29750,9 @@ function M.reader.new(writer, options)
* Cg(Cc(false), "is_opening")
* Cg(Cc(true), "is_closing")
* ( Cg(Cc(true), "is_direct")
- * Cg(parsers.rbracket * #parsers.inline_direct_ref, "content")
+ * Cg( parsers.rbracket
+ * #parsers.inline_direct_ref,
+ "content")
+ Cg(Cc(false), "is_direct")
* Cg(parsers.rbracket, "content")))
@@ -28906,19 +29776,21 @@ function M.reader.new(writer, options)
* -parsers.starter) / "")
* parsers.spacechar^0 / "\n"
- parsers.link_and_emph_content = Ct( Cg(Cc("content"), "type")
- * Cg(Cs(( parsers.link_emph_precedence
- + parsers.backslash * parsers.any
- + parsers.link_and_emph_endline
- + (parsers.linechar
- - parsers.blankline^2
- - parsers.link_image_open_or_close
- - parsers.emph_open_or_close))^0), "content"))
+ parsers.link_and_emph_content
+ = Ct( Cg(Cc("content"), "type")
+ * Cg(Cs(( parsers.link_emph_precedence
+ + parsers.backslash * parsers.linechar
+ + parsers.link_and_emph_endline
+ + (parsers.linechar
+ - parsers.blankline^2
+ - parsers.link_image_open_or_close
+ - parsers.emph_open_or_close))^0), "content"))
- parsers.link_and_emph_table = (parsers.link_image_opening + parsers.emph_open)
- * parsers.link_and_emph_content
- * ((parsers.link_image_open_or_close + parsers.emph_open_or_close)
- * parsers.link_and_emph_content)^1
+ parsers.link_and_emph_table
+ = (parsers.link_image_opening + parsers.emph_open)
+ * parsers.link_and_emph_content
+ * ((parsers.link_image_open_or_close + parsers.emph_open_or_close)
+ * parsers.link_and_emph_content)^1
% \end{macrocode}
% \begin{markdown}
@@ -28948,7 +29820,9 @@ function M.reader.new(writer, options)
local value = t[i]
if value.type == "delimiter" and
value.is_opening and
- (value.element == "link" or value.element == "image" or value.element == "note")
+ ( value.element == "link"
+ or value.element == "image"
+ or value.element == "note")
and not value.removed then
if value.is_active then
return i
@@ -29029,11 +29903,12 @@ function M.reader.new(writer, options)
%
% \end{markdown}
% \begin{macrocode}
- local function delete_parsed_content_in_range(t, opening_index, closing_index)
- for i = opening_index, closing_index do
- t[i].rendered = nil
+ local delete_parsed_content_in_range =
+ function(t, opening_index, closing_index)
+ for i = opening_index, closing_index do
+ t[i].rendered = nil
+ end
end
- end
% \end{macrocode}
% \begin{markdown}
@@ -29078,34 +29953,40 @@ function M.reader.new(writer, options)
%
% \end{markdown}
% \begin{macrocode}
- local function render_link_or_image(t, opening_index, closing_index, content_end_index, reference)
- process_emphasis(t, opening_index, content_end_index)
- local mapped = collect_emphasis_content(t, opening_index + 1, content_end_index - 1)
-
- local rendered = {}
- if (t[opening_index].element == "link") then
- rendered = writer.link(mapped, reference.url, reference.title, reference.attributes)
- end
+ local render_link_or_image =
+ function(t, opening_index, closing_index, content_end_index,
+ reference)
+ process_emphasis(t, opening_index, content_end_index)
+ local mapped = collect_emphasis_content(t, opening_index + 1,
+ content_end_index - 1)
- if (t[opening_index].element == "image") then
- rendered = writer.image(mapped, reference.url, reference.title, reference.attributes)
- end
+ local rendered = {}
+ if (t[opening_index].element == "link") then
+ rendered = writer.link(mapped, reference.url,
+ reference.title, reference.attributes)
+ end
- if (t[opening_index].element == "note") then
- if (t[opening_index].link_type == "note_inline") then
- rendered = writer.note(mapped)
+ if (t[opening_index].element == "image") then
+ rendered = writer.image(mapped, reference.url, reference.title,
+ reference.attributes)
end
- if (t[opening_index].link_type == "raw_note") then
- rendered = writer.note(reference)
+
+ if (t[opening_index].element == "note") then
+ if (t[opening_index].link_type == "note_inline") then
+ rendered = writer.note(mapped)
+ end
+ if (t[opening_index].link_type == "raw_note") then
+ rendered = writer.note(reference)
+ end
end
- end
- t[opening_index].rendered = rendered
- delete_parsed_content_in_range(t, opening_index + 1, closing_index)
- empty_content_in_range(t, opening_index, closing_index)
- disable_previous_link_openers(t, opening_index)
- disable_range(t, opening_index, closing_index)
- end
+ t[opening_index].rendered = rendered
+ delete_parsed_content_in_range(t, opening_index + 1,
+ closing_index)
+ empty_content_in_range(t, opening_index, closing_index)
+ disable_previous_link_openers(t, opening_index)
+ disable_range(t, opening_index, closing_index)
+ end
% \end{macrocode}
% \begin{markdown}
@@ -29116,52 +29997,56 @@ function M.reader.new(writer, options)
%
% \end{markdown}
% \begin{macrocode}
- local function resolve_inline_following_content(t, closing_index, match_reference, match_link_attributes)
- local content = ""
- for i = closing_index + 1, #t do
- content = content .. t[i].content
- end
+ local resolve_inline_following_content =
+ function(t, closing_index, match_reference, match_link_attributes)
+ local content = ""
+ for i = closing_index + 1, #t do
+ content = content .. t[i].content
+ end
- local matching_content = parsers.succeed
+ local matching_content = parsers.succeed
- if match_reference then
- matching_content = matching_content * parsers.inline_direct_ref_inside
- end
+ if match_reference then
+ matching_content = matching_content
+ * parsers.inline_direct_ref_inside
+ end
- if match_link_attributes then
- matching_content = matching_content * Cg(Ct(parsers.attributes^-1), "attributes")
- end
+ if match_link_attributes then
+ matching_content = matching_content
+ * Cg(Ct(parsers.attributes^-1), "attributes")
+ end
- local matched = lpeg.match(Ct(matching_content * Cg(Cp(), "end_position")), content)
+ local matched = lpeg.match(Ct( matching_content
+ * Cg(Cp(), "end_position")), content)
- local matched_count = matched.end_position - 1
- for i = closing_index + 1, #t do
- local value = t[i]
+ local matched_count = matched.end_position - 1
+ for i = closing_index + 1, #t do
+ local value = t[i]
- local chars_left = matched_count
- matched_count = matched_count - #value.content
+ local chars_left = matched_count
+ matched_count = matched_count - #value.content
- if matched_count <= 0 then
- value.content = value.content:sub(chars_left + 1)
- break
+ if matched_count <= 0 then
+ value.content = value.content:sub(chars_left + 1)
+ break
+ end
+
+ value.content = ''
+ value.is_active = false
end
- value.content = ''
- value.is_active = false
- end
+ local attributes = matched.attributes
+ if attributes == nil or next(attributes) == nil then
+ attributes = nil
+ end
- local attributes = matched.attributes
- if attributes == nil or next(attributes) == nil then
- attributes = nil
+ return {
+ url = matched.url or "",
+ title = matched.title or "",
+ attributes = attributes
+ }
end
- return {
- url = matched.url or "",
- title = matched.title or "",
- attributes = attributes
- }
- end
-
% \end{macrocode}
% \begin{markdown}
%
@@ -29171,8 +30056,11 @@ function M.reader.new(writer, options)
% \end{markdown}
% \begin{macrocode}
local function resolve_inline_link(t, opening_index, closing_index)
- local inline_content = resolve_inline_following_content(t, closing_index, true, t.match_link_attributes)
- render_link_or_image(t, opening_index, closing_index, closing_index, inline_content)
+ local inline_content
+ = resolve_inline_following_content(t, closing_index, true,
+ t.match_link_attributes)
+ render_link_or_image(t, opening_index, closing_index,
+ closing_index, inline_content)
end
% \end{macrocode}
@@ -29183,10 +30071,14 @@ function M.reader.new(writer, options)
%
% \end{markdown}
% \begin{macrocode}
- local function resolve_note_inline_link(t, opening_index, closing_index)
- local inline_content = resolve_inline_following_content(t, closing_index, false, false)
- render_link_or_image(t, opening_index, closing_index, closing_index, inline_content)
- end
+ local resolve_note_inline_link =
+ function(t, opening_index, closing_index)
+ local inline_content
+ = resolve_inline_following_content(t, closing_index,
+ false, false)
+ render_link_or_image(t, opening_index, closing_index,
+ closing_index, inline_content)
+ end
% \end{macrocode}
% \begin{markdown}
@@ -29197,13 +30089,18 @@ function M.reader.new(writer, options)
% \end{markdown}
% \begin{macrocode}
local function resolve_shortcut_link(t, opening_index, closing_index)
- local content = collect_link_content(t, opening_index + 1, closing_index - 1)
+ local content
+ = collect_link_content(t, opening_index + 1, closing_index - 1)
local r = self.lookup_reference(content)
if r then
- local inline_content = resolve_inline_following_content(t, closing_index, false, t.match_link_attributes)
- r.attributes = join_attributes(r.attributes, inline_content.attributes)
- render_link_or_image(t, opening_index, closing_index, closing_index, r)
+ local inline_content
+ = resolve_inline_following_content(t, closing_index, false,
+ t.match_link_attributes)
+ r.attributes
+ = join_attributes(r.attributes, inline_content.attributes)
+ render_link_or_image(t, opening_index, closing_index,
+ closing_index, r)
end
end
@@ -29216,12 +30113,14 @@ function M.reader.new(writer, options)
% \end{markdown}
% \begin{macrocode}
local function resolve_raw_note_link(t, opening_index, closing_index)
- local content = collect_link_content(t, opening_index + 1, closing_index - 1)
+ local content
+ = collect_link_content(t, opening_index + 1, closing_index - 1)
local r = self.lookup_note_reference(content)
if r then
local parsed_ref = self.parser_functions.parse_blocks_nested(r)
- render_link_or_image(t, opening_index, closing_index, closing_index, parsed_ref)
+ render_link_or_image(t, opening_index, closing_index,
+ closing_index, parsed_ref)
end
end
@@ -29234,15 +30133,22 @@ function M.reader.new(writer, options)
% \end{markdown}
% \begin{macrocode}
local function resolve_full_link(t, opening_index, closing_index)
- local next_link_closing_index = find_next_link_closing_index(t, closing_index + 4)
- local next_link_content = collect_link_content(t, closing_index + 3, next_link_closing_index - 1)
+ local next_link_closing_index
+ = find_next_link_closing_index(t, closing_index + 4)
+ local next_link_content
+ = collect_link_content(t, closing_index + 3,
+ next_link_closing_index - 1)
local r = self.lookup_reference(next_link_content)
if r then
- local inline_content = resolve_inline_following_content(t, next_link_closing_index, false,
- t.match_link_attributes)
- r.attributes = join_attributes(r.attributes, inline_content.attributes)
- render_link_or_image(t, opening_index, next_link_closing_index, closing_index, r)
+ local inline_content
+ = resolve_inline_following_content(t, next_link_closing_index,
+ false,
+ t.match_link_attributes)
+ r.attributes
+ = join_attributes(r.attributes, inline_content.attributes)
+ render_link_or_image(t, opening_index, next_link_closing_index,
+ closing_index, r)
end
end
@@ -29256,14 +30162,20 @@ function M.reader.new(writer, options)
% \end{markdown}
% \begin{macrocode}
local function resolve_collapsed_link(t, opening_index, closing_index)
- local next_link_closing_index = find_next_link_closing_index(t, closing_index + 4)
- local content = collect_link_content(t, opening_index + 1, closing_index - 1)
+ local next_link_closing_index
+ = find_next_link_closing_index(t, closing_index + 4)
+ local content
+ = collect_link_content(t, opening_index + 1, closing_index - 1)
local r = self.lookup_reference(content)
if r then
- local inline_content = resolve_inline_following_content(t, closing_index, false, t.match_link_attributes)
- r.attributes = join_attributes(r.attributes, inline_content.attributes)
- render_link_or_image(t, opening_index, next_link_closing_index, closing_index, r)
+ local inline_content
+ = resolve_inline_following_content(t, closing_index, false,
+ t.match_link_attributes)
+ r.attributes
+ = join_attributes(r.attributes, inline_content.attributes)
+ render_link_or_image(t, opening_index, next_link_closing_index,
+ closing_index, r)
end
end
@@ -29285,7 +30197,9 @@ function M.reader.new(writer, options)
for i,value in ipairs(t) do
if not value.is_closing
or value.type ~= "delimiter"
- or not (value.element == "link" or value.element == "image" or value.element == "note")
+ or not ( value.element == "link"
+ or value.element == "image"
+ or value.element == "note")
or value.removed then
goto continue
end
@@ -29343,7 +30257,8 @@ function M.reader.new(writer, options)
%
% \end{markdown}
% \begin{macrocode}
- parsers.Str = (parsers.normalchar * (parsers.normalchar + parsers.at)^0)
+ parsers.Str = ( parsers.normalchar
+ * (parsers.normalchar + parsers.at)^0)
/ writer.string
parsers.Symbol = (parsers.backtick^1 + V("SpecialChar"))
@@ -29371,25 +30286,28 @@ function M.reader.new(writer, options)
parsers.interrupting_bullets = parsers.fail
parsers.interrupting_enumerators = parsers.fail
else
- parsers.interrupting_bullets = parsers.bullet(parsers.dash, true)
- + parsers.bullet(parsers.asterisk, true)
- + parsers.bullet(parsers.plus, true)
-
- parsers.interrupting_enumerators = parsers.enumerator(parsers.period, true)
- + parsers.enumerator(parsers.rparent, true)
+ parsers.interrupting_bullets
+ = parsers.bullet(parsers.dash, true)
+ + parsers.bullet(parsers.asterisk, true)
+ + parsers.bullet(parsers.plus, true)
+
+ parsers.interrupting_enumerators
+ = parsers.enumerator(parsers.period, true)
+ + parsers.enumerator(parsers.rparent, true)
end
if options.html then
- parsers.html_interrupting = parsers.check_trail
- * ( parsers.html_incomplete_open_tag
- + parsers.html_incomplete_close_tag
- + parsers.html_incomplete_open_special_tag
- + parsers.html_comment_start
- + parsers.html_cdatasection_start
- + parsers.html_declaration_start
- + parsers.html_instruction_start
- - parsers.html_close_special_tag
- - parsers.html_empty_special_tag)
+ parsers.html_interrupting
+ = parsers.check_trail
+ * ( parsers.html_incomplete_open_tag
+ + parsers.html_incomplete_close_tag
+ + parsers.html_incomplete_open_special_tag
+ + parsers.html_comment_start
+ + parsers.html_cdatasection_start
+ + parsers.html_declaration_start
+ + parsers.html_instruction_start
+ - parsers.html_close_special_tag
+ - parsers.html_empty_special_tag)
else
parsers.html_interrupting = parsers.fail
end
@@ -29411,7 +30329,7 @@ function M.reader.new(writer, options)
* -V("EndlineExceptions")
+ parsers.check_optional_indent
* -V("EndlineExceptions")
- * -parsers.starter)
+ * -parsers.starter) / function(_) return end
* parsers.spacechar^0
parsers.Endline = parsers.endline
@@ -29437,30 +30355,37 @@ function M.reader.new(writer, options)
parsers.Space = parsers.spacechar^2 * parsers.Endline
/ writer.hard_line_break
- + parsers.spacechar^1 * parsers.Endline^-1 * parsers.eof / self.expandtabs
+ + parsers.spacechar^1
+ * parsers.Endline^-1
+ * parsers.eof / self.expandtabs
+ parsers.spacechar^1 * parsers.Endline
/ writer.soft_line_break
- + parsers.spacechar^1 * -parsers.newline / self.expandtabs
+ + parsers.spacechar^1
+ * -parsers.newline / self.expandtabs
parsers.NoSoftLineBreakSpace
= parsers.spacechar^2 * parsers.Endline
/ writer.hard_line_break
- + parsers.spacechar^1 * parsers.Endline^-1 * parsers.eof / self.expandtabs
+ + parsers.spacechar^1
+ * parsers.Endline^-1
+ * parsers.eof / self.expandtabs
+ parsers.spacechar^1 * parsers.Endline
/ writer.soft_line_break
- + parsers.spacechar^1 * -parsers.newline / self.expandtabs
+ + parsers.spacechar^1
+ * -parsers.newline / self.expandtabs
parsers.NonbreakingEndline
= parsers.endline
- / writer.soft_line_break
+ / writer.nbsp
parsers.NonbreakingSpace
- = parsers.spacechar^2 * parsers.Endline
- / writer.hard_line_break
- + parsers.spacechar^1 * parsers.Endline^-1 * parsers.eof / ""
- + parsers.spacechar^1 * parsers.Endline
+ = parsers.spacechar^2 * parsers.endline
+ / writer.nbsp
+ + parsers.spacechar^1
+ * parsers.endline^-1 * parsers.eof / ""
+ + parsers.spacechar^1 * parsers.endline
* parsers.optionalspace
- / writer.soft_line_break
+ / writer.nbsp
+ parsers.spacechar^1 * parsers.optionalspace
/ writer.nbsp
@@ -29509,18 +30434,20 @@ end
parsers.LinkAndEmph = Ct(parsers.link_and_emph_table)
/ self.defer_link_and_emphasis_processing
- parsers.EscapedChar = parsers.backslash * C(parsers.escapable) / writer.string
+ parsers.EscapedChar = parsers.backslash
+ * C(parsers.escapable) / writer.string
- parsers.InlineHtml = Cs(parsers.html_inline_comment) / writer.inline_html_comment
- + Cs(parsers.html_any_empty_inline_tag
- + parsers.html_inline_instruction
- + parsers.html_inline_cdatasection
- + parsers.html_inline_declaration
- + parsers.html_any_open_inline_tag
- + parsers.html_any_close_tag)
- / writer.inline_html_tag
+ parsers.InlineHtml = Cs(parsers.html_inline_comment)
+ / writer.inline_html_comment
+ + Cs(parsers.html_any_empty_inline_tag
+ + parsers.html_inline_instruction
+ + parsers.html_inline_cdatasection
+ + parsers.html_inline_declaration
+ + parsers.html_any_open_inline_tag
+ + parsers.html_any_close_tag)
+ / writer.inline_html_tag
- parsers.HtmlEntity = parsers.html_entities / writer.string
+ parsers.HtmlEntity = parsers.html_entities / writer.string
% \end{macrocode}
% \par
% \begin{markdown}
@@ -29539,15 +30466,18 @@ end
+ parsers.html_declaration))
/ writer.block_html_element
- parsers.indented_non_blank_line = parsers.indentedline - parsers.blankline
+ parsers.indented_non_blank_line = parsers.indentedline
+ - parsers.blankline
- parsers.Verbatim = Cs(
- parsers.check_code_trail
- * (parsers.line - parsers.blankline)
- * ((parsers.check_minimal_blank_indent_and_full_code_trail * parsers.blankline)^0
- * ((parsers.check_minimal_indent / "") * parsers.check_code_trail
- * (parsers.line - parsers.blankline))^1)^0
- ) / self.expandtabs / writer.verbatim
+ parsers.Verbatim
+ = Cs( parsers.check_code_trail
+ * (parsers.line - parsers.blankline)
+ * (( parsers.check_minimal_blank_indent_and_full_code_trail
+ * parsers.blankline)^0
+ * ( (parsers.check_minimal_indent / "")
+ * parsers.check_code_trail
+ * (parsers.line - parsers.blankline))^1)^0)
+ / self.expandtabs / writer.verbatim
parsers.Blockquote = parsers.blockquote_body
/ writer.blockquote
@@ -29586,73 +30516,79 @@ end
parsers.list_blank = parsers.conditionally_indented_blankline
- parsers.ref_or_block_list_separated = parsers.sep_group_no_output(parsers.list_blank)
- * parsers.minimally_indented_ref
- + parsers.block_sep_group(parsers.list_blank)
- * parsers.minimally_indented_block
-
- parsers.ref_or_block_non_separated = parsers.minimally_indented_ref
- + (parsers.succeed / writer.interblocksep)
- * parsers.minimally_indented_block
- - parsers.minimally_indented_blankline
-
- parsers.tight_list_loop_body_pair =
- parsers.create_loop_body_pair(parsers.ref_or_block_non_separated,
- parsers.minimally_indented_par_or_plain_no_blank,
- (parsers.succeed / writer.interblocksep),
- (parsers.succeed / writer.paragraphsep))
-
- parsers.loose_list_loop_body_pair =
- parsers.create_loop_body_pair(parsers.ref_or_block_list_separated,
- parsers.minimally_indented_par_or_plain,
- parsers.block_sep_group(parsers.list_blank),
- parsers.par_sep_group(parsers.list_blank))
-
- parsers.tight_list_content_loop = V("Block")
- * parsers.tight_list_loop_body_pair.block^0
- + (V("Paragraph") + V("Plain"))
- * parsers.ref_or_block_non_separated
- * parsers.tight_list_loop_body_pair.block^0
- + (V("Paragraph") + V("Plain"))
- * parsers.tight_list_loop_body_pair.par^0
-
- parsers.loose_list_content_loop = V("Block")
- * parsers.loose_list_loop_body_pair.block^0
- + (V("Paragraph") + V("Plain"))
- * parsers.ref_or_block_list_separated
- * parsers.loose_list_loop_body_pair.block^0
- + (V("Paragraph") + V("Plain"))
- * parsers.loose_list_loop_body_pair.par^0
-
- parsers.list_item_tightness_condition = -#( parsers.list_blank^0
- * parsers.minimally_indented_ref_or_block_or_par)
- * remove_indent("li")
- + remove_indent("li")
- * parsers.fail
-
- parsers.indented_content_tight = Ct( (parsers.blankline / "")
- * #parsers.list_blank
- * remove_indent("li")
- + ( (V("Reference") + (parsers.blankline / ""))
- * parsers.check_minimal_indent
- * parsers.tight_list_content_loop
- + (V("Reference") + (parsers.blankline / ""))
- + (parsers.tickbox^-1 / writer.escape)
- * parsers.tight_list_content_loop
- )
- * parsers.list_item_tightness_condition
- )
-
- parsers.indented_content_loose = Ct( (parsers.blankline / "")
- * #parsers.list_blank
- + ( (V("Reference") + (parsers.blankline / ""))
- * parsers.check_minimal_indent
- * parsers.loose_list_content_loop
- + (V("Reference") + (parsers.blankline / ""))
- + (parsers.tickbox^-1 / writer.escape)
- * parsers.loose_list_content_loop
- )
- )
+ parsers.ref_or_block_list_separated
+ = parsers.sep_group_no_output(parsers.list_blank)
+ * parsers.minimally_indented_ref
+ + parsers.block_sep_group(parsers.list_blank)
+ * parsers.minimally_indented_block
+
+ parsers.ref_or_block_non_separated
+ = parsers.minimally_indented_ref
+ + (parsers.succeed / writer.interblocksep)
+ * parsers.minimally_indented_block
+ - parsers.minimally_indented_blankline
+
+ parsers.tight_list_loop_body_pair =
+ parsers.create_loop_body_pair(
+ parsers.ref_or_block_non_separated,
+ parsers.minimally_indented_par_or_plain_no_blank,
+ (parsers.succeed / writer.interblocksep),
+ (parsers.succeed / writer.paragraphsep))
+
+ parsers.loose_list_loop_body_pair =
+ parsers.create_loop_body_pair(
+ parsers.ref_or_block_list_separated,
+ parsers.minimally_indented_par_or_plain,
+ parsers.block_sep_group(parsers.list_blank),
+ parsers.par_sep_group(parsers.list_blank))
+
+ parsers.tight_list_content_loop
+ = V("Block")
+ * parsers.tight_list_loop_body_pair.block^0
+ + (V("Paragraph") + V("Plain"))
+ * parsers.ref_or_block_non_separated
+ * parsers.tight_list_loop_body_pair.block^0
+ + (V("Paragraph") + V("Plain"))
+ * parsers.tight_list_loop_body_pair.par^0
+
+ parsers.loose_list_content_loop
+ = V("Block")
+ * parsers.loose_list_loop_body_pair.block^0
+ + (V("Paragraph") + V("Plain"))
+ * parsers.ref_or_block_list_separated
+ * parsers.loose_list_loop_body_pair.block^0
+ + (V("Paragraph") + V("Plain"))
+ * parsers.loose_list_loop_body_pair.par^0
+
+ parsers.list_item_tightness_condition
+ = -#( parsers.list_blank^0
+ * parsers.minimally_indented_ref_or_block_or_par)
+ * remove_indent("li")
+ + remove_indent("li")
+ * parsers.fail
+
+ parsers.indented_content_tight
+ = Ct( (parsers.blankline / "")
+ * #parsers.list_blank
+ * remove_indent("li")
+ + ( (V("Reference") + (parsers.blankline / ""))
+ * parsers.check_minimal_indent
+ * parsers.tight_list_content_loop
+ + (V("Reference") + (parsers.blankline / ""))
+ + (parsers.tickbox^-1 / writer.escape)
+ * parsers.tight_list_content_loop
+ )
+ * parsers.list_item_tightness_condition)
+
+ parsers.indented_content_loose
+ = Ct( (parsers.blankline / "")
+ * #parsers.list_blank
+ + ( (V("Reference") + (parsers.blankline / ""))
+ * parsers.check_minimal_indent
+ * parsers.loose_list_content_loop
+ + (V("Reference") + (parsers.blankline / ""))
+ + (parsers.tickbox^-1 / writer.escape)
+ * parsers.loose_list_content_loop))
parsers.TightListItem = function(starter)
return -parsers.ThematicBreak
@@ -29710,13 +30646,15 @@ end
local enumerator = parsers.enumerator(delimiter_type)
return Cg(enumerator, "listtype")
* (Ct( parsers.TightListItem(Cb("listtype"))
- * ((parsers.check_minimal_indent / "") * parsers.TightListItem(enumerator))^0)
+ * ( (parsers.check_minimal_indent / "")
+ * parsers.TightListItem(enumerator))^0)
* Cc(true)
* -#((parsers.list_blank^0 / "")
* parsers.check_minimal_indent * enumerator)
+ Ct( parsers.LooseListItem(Cb("listtype"))
* ((parsers.list_blank^0 / "")
- * (parsers.check_minimal_indent / "") * parsers.LooseListItem(enumerator))^0)
+ * (parsers.check_minimal_indent / "")
+ * parsers.LooseListItem(enumerator))^0)
* Cc(false)
) * Ct(Cb("listtype")) / ordered_list
end
@@ -29769,15 +30707,21 @@ end
- parsers.thematic_break_lines
parsers.heading_text = parsers.heading_line
- * ((V("Endline") / "\n") * (parsers.heading_line - parsers.heading_level))^0
+ * ( (V("Endline") / "\n")
+ * ( parsers.heading_line
+ - parsers.heading_level))^0
* parsers.newline^-1
- parsers.SetextHeading = parsers.freeze_trail * parsers.check_trail_no_rem
- * #(parsers.heading_text
- * parsers.check_minimal_indent * parsers.check_trail * parsers.heading_level)
+ parsers.SetextHeading = parsers.freeze_trail
+ * parsers.check_trail_no_rem
+ * #( parsers.heading_text
+ * parsers.check_minimal_indent
+ * parsers.check_trail
+ * parsers.heading_level)
* Cs(parsers.heading_text)
/ parsers.parse_heading_text
- * parsers.check_minimal_indent_and_trail * parsers.heading_level
+ * parsers.check_minimal_indent_and_trail
+ * parsers.heading_level
* parsers.newline
* parsers.unfreeze_trail
/ writer.heading
@@ -29829,14 +30773,18 @@ end
local current_extension_name = nil
self.insert_pattern = function(selector, pattern, pattern_name)
assert(pattern_name == nil or type(pattern_name) == "string")
- local _, _, lhs, pos, rhs = selector:find("^(%a+)%s+([%a%s]+%a+)%s+(%a+)$")
+ local _, _, lhs, pos, rhs
+ = selector:find("^(%a+)%s+([%a%s]+%a+)%s+(%a+)$")
assert(lhs ~= nil,
- [[Expected selector in form "LHS (before|after|instead of) RHS", not "]]
+ [[Expected selector in form ]]
+ .. [["LHS (before|after|instead of) RHS", not "]]
.. selector .. [["]])
assert(walkable_syntax[lhs] ~= nil,
- [[Rule ]] .. lhs .. [[ -> ... does not exist in markdown grammar]])
+ [[Rule ]] .. lhs
+ .. [[ -> ... does not exist in markdown grammar]])
assert(pos == "before" or pos == "after" or pos == "instead of",
- [[Expected positional specifier "before", "after", or "instead of", not "]]
+ [[Expected positional specifier "before", "after", ]]
+ .. [[or "instead of", not "]]
.. pos .. [["]])
local rule = walkable_syntax[lhs]
local index = nil
@@ -29854,10 +30802,12 @@ end
.. [[ does not exist in markdown grammar]])
local accountable_pattern
if current_extension_name then
- accountable_pattern = { pattern, current_extension_name, pattern_name }
+ accountable_pattern
+ = {pattern, current_extension_name, pattern_name}
else
assert(type(pattern) == "string",
- [[reader->insert_pattern() was called outside an extension with ]]
+ [[reader->insert_pattern() was called outside ]]
+ .. [[an extension with ]]
.. [[a PEG pattern instead of a rule name]])
accountable_pattern = pattern
end
@@ -29880,11 +30830,9 @@ end
local syntax =
{ "Blocks",
- Blocks = V("InitializeState")
- * ( V("ExpectedJekyllData")
- * (V("Blank")^0 / writer.interblocksep)
- )^-1
- * V("Blank")^0
+ Blocks = V("InitializeState")
+ * V("ExpectedJekyllData")
+ * V("Blank")^0
% \end{macrocode}
% \par
% \begin{markdown}
@@ -29895,71 +30843,72 @@ end
%
% \end{markdown}
% \begin{macrocode}
- * ( V("Block")
- * ( V("Blank")^0 * parsers.eof
- + ( V("Blank")^2 / writer.paragraphsep
- + V("Blank")^0 / writer.interblocksep
- )
- )
- + ( V("Paragraph") + V("Plain") )
- * ( V("Blank")^0 * parsers.eof
- + ( V("Blank")^2 / writer.paragraphsep
- + V("Blank")^0 / writer.interblocksep
- )
- )
- * V("Block")
- * ( V("Blank")^0 * parsers.eof
- + ( V("Blank")^2 / writer.paragraphsep
- + V("Blank")^0 / writer.interblocksep
- )
- )
- + ( V("Paragraph") + V("Plain") )
- * ( V("Blank")^0 * parsers.eof
- + V("Blank")^0 / writer.paragraphsep
- )
- )^0,
-
- ExpectedJekyllData = parsers.fail,
-
- Blank = parsers.Blank,
- Reference = parsers.Reference,
-
- Blockquote = parsers.Blockquote,
- Verbatim = parsers.Verbatim,
- ThematicBreak = parsers.ThematicBreak,
- BulletList = parsers.BulletList,
- OrderedList = parsers.OrderedList,
- DisplayHtml = parsers.DisplayHtml,
- Heading = parsers.Heading,
- Paragraph = parsers.Paragraph,
- Plain = parsers.Plain,
-
- EndlineExceptions = parsers.EndlineExceptions,
+ * ( V("Block")
+ * ( V("Blank")^0 * parsers.eof
+ + ( V("Blank")^2 / writer.paragraphsep
+ + V("Blank")^0 / writer.interblocksep
+ )
+ )
+ + ( V("Paragraph") + V("Plain") )
+ * ( V("Blank")^0 * parsers.eof
+ + ( V("Blank")^2 / writer.paragraphsep
+ + V("Blank")^0 / writer.interblocksep
+ )
+ )
+ * V("Block")
+ * ( V("Blank")^0 * parsers.eof
+ + ( V("Blank")^2 / writer.paragraphsep
+ + V("Blank")^0 / writer.interblocksep
+ )
+ )
+ + ( V("Paragraph") + V("Plain") )
+ * ( V("Blank")^0 * parsers.eof
+ + V("Blank")^0 / writer.paragraphsep
+ )
+ )^0,
+
+ ExpectedJekyllData = parsers.succeed,
+
+ Blank = parsers.Blank,
+ Reference = parsers.Reference,
+
+ Blockquote = parsers.Blockquote,
+ Verbatim = parsers.Verbatim,
+ ThematicBreak = parsers.ThematicBreak,
+ BulletList = parsers.BulletList,
+ OrderedList = parsers.OrderedList,
+ DisplayHtml = parsers.DisplayHtml,
+ Heading = parsers.Heading,
+ Paragraph = parsers.Paragraph,
+ Plain = parsers.Plain,
+
+ EndlineExceptions = parsers.EndlineExceptions,
NoSoftLineBreakEndlineExceptions
- = parsers.NoSoftLineBreakEndlineExceptions,
-
- Str = parsers.Str,
- Space = parsers.Space,
- NoSoftLineBreakSpace = parsers.NoSoftLineBreakSpace,
- OptionalIndent = parsers.OptionalIndent,
- Endline = parsers.Endline,
- EndlineNoSub = parsers.EndlineNoSub,
+ = parsers.NoSoftLineBreakEndlineExceptions,
+
+ Str = parsers.Str,
+ Space = parsers.Space,
+ NoSoftLineBreakSpace
+ = parsers.NoSoftLineBreakSpace,
+ OptionalIndent = parsers.OptionalIndent,
+ Endline = parsers.Endline,
+ EndlineNoSub = parsers.EndlineNoSub,
NoSoftLineBreakEndline
- = parsers.NoSoftLineBreakEndline,
- EndlineBreak = parsers.EndlineBreak,
- LinkAndEmph = parsers.LinkAndEmph,
- Code = parsers.Code,
- AutoLinkUrl = parsers.AutoLinkUrl,
- AutoLinkEmail = parsers.AutoLinkEmail,
+ = parsers.NoSoftLineBreakEndline,
+ EndlineBreak = parsers.EndlineBreak,
+ LinkAndEmph = parsers.LinkAndEmph,
+ Code = parsers.Code,
+ AutoLinkUrl = parsers.AutoLinkUrl,
+ AutoLinkEmail = parsers.AutoLinkEmail,
AutoLinkRelativeReference
- = parsers.AutoLinkRelativeReference,
- InlineHtml = parsers.InlineHtml,
- HtmlEntity = parsers.HtmlEntity,
- EscapedChar = parsers.EscapedChar,
- Smart = parsers.Smart,
- Symbol = parsers.Symbol,
- SpecialChar = parsers.fail,
- InitializeState = parsers.succeed,
+ = parsers.AutoLinkRelativeReference,
+ InlineHtml = parsers.InlineHtml,
+ HtmlEntity = parsers.HtmlEntity,
+ EscapedChar = parsers.EscapedChar,
+ Smart = parsers.Smart,
+ Symbol = parsers.Symbol,
+ SpecialChar = parsers.fail,
+ InitializeState = parsers.succeed,
}
% \end{macrocode}
% \par
@@ -29977,13 +30926,17 @@ end
self.update_rule = function(rule_name, get_pattern)
assert(current_extension_name ~= nil)
assert(syntax[rule_name] ~= nil,
- [[Rule ]] .. rule_name .. [[ -> ... does not exist in markdown grammar]])
+ [[Rule ]] .. rule_name
+ .. [[ -> ... does not exist in markdown grammar]])
local previous_pattern
local extension_name
if walkable_syntax[rule_name] then
- local previous_accountable_pattern = walkable_syntax[rule_name][1]
+ local previous_accountable_pattern
+ = walkable_syntax[rule_name][1]
previous_pattern = previous_accountable_pattern[1]
- extension_name = previous_accountable_pattern[2] .. ", " .. current_extension_name
+ extension_name
+ = previous_accountable_pattern[2]
+ .. ", " .. current_extension_name
else
previous_pattern = nil
extension_name = current_extension_name
@@ -30113,9 +31066,11 @@ end
pattern_name = "Anonymous Pattern"
end
local extension_name = rhs[2]
- human_readable_rhs = pattern_name .. [[ (]] .. extension_name .. [[)]]
+ human_readable_rhs = pattern_name .. [[ (]]
+ .. extension_name .. [[)]]
end
- local encoded_rhs = util.encode_json_string(human_readable_rhs)
+ local encoded_rhs
+ = util.encode_json_string(human_readable_rhs)
local output_line = [[ ]] .. encoded_rhs
if rhs_index < #rule then
output_line = output_line .. ","
@@ -30133,7 +31088,8 @@ end
local output = table.concat(output_lines, "\n")
local output_filename = options.debugExtensionsFileName
local output_file = assert(io.open(output_filename, "w"),
- [[Could not open file "]] .. output_filename .. [[" for writing]])
+ [[Could not open file "]] .. output_filename
+ .. [[" for writing]])
assert(output_file:write(output))
assert(output_file:close())
end
@@ -30226,7 +31182,7 @@ end
end
local blocks_nested_t = util.table_copy(syntax)
- blocks_nested_t.ExpectedJekyllData = parsers.fail
+ blocks_nested_t.ExpectedJekyllData = parsers.succeed
parsers.blocks_nested = Ct(blocks_nested_t)
parsers.blocks = Ct(syntax)
@@ -30256,8 +31212,10 @@ end
local inlines_no_link_or_emphasis_t = util.table_copy(inlines_t)
inlines_no_link_or_emphasis_t.LinkAndEmph = parsers.fail
- inlines_no_link_or_emphasis_t.EndlineExceptions = parsers.EndlineExceptions - parsers.eof
- parsers.inlines_no_link_or_emphasis = Ct(inlines_no_link_or_emphasis_t)
+ inlines_no_link_or_emphasis_t.EndlineExceptions
+ = parsers.EndlineExceptions - parsers.eof
+ parsers.inlines_no_link_or_emphasis
+ = Ct(inlines_no_link_or_emphasis_t)
% \end{macrocode}
% \par
% \begin{markdown}
@@ -30284,7 +31242,8 @@ end
elseif form == "nfkd" then
input = uni_algos.normalize.NFKD(input)
else
- error(format("Unknown normalization form %s", form))
+ return writer.error(
+ format("Unknown normalization form %s.", form))
end
end
% \end{macrocode}
@@ -30300,30 +31259,12 @@ end
end
% \end{macrocode}
% \begin{markdown}
-% When determining the name of the cache file, create salt for the hashing
-% function out of the package version and the passed options recognized by the
-% Lua interface (see Section <#sec:lua-options>). The \Opt{cacheDir} option
-% is disregarded.
+% Clear the table of references.
% \end{markdown}
% \begin{macrocode}
references = {}
- local opt_string = {}
- for k, _ in pairs(defaultOptions) do
- local v = options[k]
- if type(v) == "table" then
- for _, i in ipairs(v) do
- opt_string[#opt_string+1] = k .. "=" .. tostring(i)
- end
- elseif k ~= "cacheDir" then
- opt_string[#opt_string+1] = k .. "=" .. tostring(v)
- end
- end
- table.sort(opt_string)
- local salt = table.concat(opt_string, ",") .. "," .. metadata.version
- local output
- local function convert(input)
- local document = self.parser_functions.parse_blocks(input)
- local output = util.rope_to_string(writer.document(document))
+ local document = self.parser_functions.parse_blocks(input)
+ local output = util.rope_to_string(writer.document(document))
% \end{macrocode}
% \begin{markdown}
% Remove block element / paragraph separators immediately followed by the
@@ -30331,82 +31272,49 @@ end
% Then, remove any leftover output of \luamref{writer->undosep}.
% \end{markdown}
% \begin{macrocode}
- local undosep_start, undosep_end
- local potential_secend_start, secend_start
- local potential_sep_start, sep_start
+ local undosep_start, undosep_end
+ local potential_secend_start, secend_start
+ local potential_sep_start, sep_start
+ while true do
+ -- find a `writer->undosep`
+ undosep_start, undosep_end
+ = output:find(writer.undosep_text, 1, true)
+ if undosep_start == nil then break end
+ -- skip any preceding section ends
+ secend_start = undosep_start
while true do
- -- find a `writer->undosep`
- undosep_start, undosep_end = output:find(writer.undosep_text, 1, true)
- if undosep_start == nil then break end
- -- skip any preceding section ends
- secend_start = undosep_start
- while true do
- potential_secend_start = secend_start - #writer.secend_text
- if potential_secend_start < 1
- or output:sub(potential_secend_start, secend_start - 1) ~= writer.secend_text then
- break
- end
- secend_start = potential_secend_start
+ potential_secend_start = secend_start - #writer.secend_text
+ if potential_secend_start < 1
+ or output:sub(potential_secend_start,
+ secend_start - 1) ~= writer.secend_text
+ then
+ break
end
- -- find an immediately preceding block element / paragraph separator
- sep_start = secend_start
- potential_sep_start = sep_start - #writer.interblocksep_text
+ secend_start = potential_secend_start
+ end
+ -- find an immediately preceding
+ -- block element / paragraph separator
+ sep_start = secend_start
+ potential_sep_start = sep_start - #writer.interblocksep_text
+ if potential_sep_start >= 1
+ and output:sub(potential_sep_start,
+ sep_start - 1) == writer.interblocksep_text
+ then
+ sep_start = potential_sep_start
+ else
+ potential_sep_start = sep_start - #writer.paragraphsep_text
if potential_sep_start >= 1
- and output:sub(potential_sep_start, sep_start - 1) == writer.interblocksep_text then
+ and output:sub(potential_sep_start,
+ sep_start - 1) == writer.paragraphsep_text
+ then
sep_start = potential_sep_start
- else
- potential_sep_start = sep_start - #writer.paragraphsep_text
- if potential_sep_start >= 1
- and output:sub(potential_sep_start, sep_start - 1) == writer.paragraphsep_text then
- sep_start = potential_sep_start
- end
end
- -- remove `writer->undosep` and immediately preceding block element / paragraph separator
- output = output:sub(1, sep_start - 1)
- .. output:sub(secend_start, undosep_start - 1)
- .. output:sub(undosep_end + 1)
- end
- return output
- end
-% \end{macrocode}
-% \begin{markdown}
-% If we cache markdown documents, produce the cache file and transform its
-% filename to plain \TeX{} output via the \luamref{writer->pack} method.
-% \end{markdown}
-% \begin{macrocode}
- if options.eagerCache or options.finalizeCache then
- local name = util.cache(options.cacheDir, input, salt, convert,
- ".md" .. writer.suffix)
- output = writer.pack(name)
-% \end{macrocode}
-% \begin{markdown}
-% Otherwise, return the result of the conversion directly.
-% \end{markdown}
-% \begin{macrocode}
- else
- output = convert(input)
- end
-% \end{macrocode}
-% \begin{markdown}
-% If the \Opt{finalizeCache} option is enabled, populate the frozen cache in
-% the file \Opt{frozenCacheFileName} with an entry for markdown document
-% number \Opt{frozenCacheCounter}.
-% \end{markdown}
-% \begin{macrocode}
- if options.finalizeCache then
- local file, mode
- if options.frozenCacheCounter > 0 then
- mode = "a"
- else
- mode = "w"
end
- file = assert(io.open(options.frozenCacheFileName, mode),
- [[Could not open file "]] .. options.frozenCacheFileName
- .. [[" for writing]])
- assert(file:write([[\expandafter\global\expandafter\def\csname ]]
- .. [[markdownFrozenCache]] .. options.frozenCacheCounter
- .. [[\endcsname{]] .. output .. [[}]] .. "\n"))
- assert(file:close())
+ -- remove `writer->undosep` and immediately preceding
+ -- block element / paragraph separator
+ output = output:sub(1, sep_start - 1)
+ .. output:sub(secend_start, undosep_start - 1)
+ .. output:sub(undosep_end + 1)
end
return output
end
@@ -30468,10 +31376,13 @@ M.extensions.bracketed_spans = function()
+ parsers.autolink
+ V("InlineHtml")
+ ( parsers.backslash * parsers.backslash)
- + ( parsers.backslash * (parsers.lbracket + parsers.rbracket)
+ + ( parsers.backslash
+ * (parsers.lbracket + parsers.rbracket)
+ V("Space") + V("Endline")
+ (parsers.any
- - (parsers.newline + parsers.lbracket + parsers.rbracket
+ - ( parsers.newline
+ + parsers.lbracket
+ + parsers.rbracket
+ parsers.blankline^2))))^1)
/ self.parser_functions.parse_inlines)
* parsers.rbracket
@@ -30534,11 +31445,15 @@ M.extensions.citations = function(citation_nbsps)
end
end
else
- table.insert(buffer, {"\\markdownRenderer", text_cites and "TextCite" or "Cite",
- "{", #cites, "}"})
+ table.insert(buffer,
+ {"\\markdownRenderer",
+ text_cites and "TextCite" or "Cite",
+ "{", #cites, "}"})
for _,cite in ipairs(cites) do
- table.insert(buffer, {cite.suppress_author and "-" or "+", "{",
- cite.prenote or "", "}{", cite.postnote or "", "}{", cite.name, "}"})
+ table.insert(buffer,
+ {cite.suppress_author and "-" or "+", "{",
+ cite.prenote or "", "}{",
+ cite.postnote or "", "}{", cite.name, "}"})
end
end
return buffer
@@ -30554,12 +31469,16 @@ M.extensions.citations = function(citation_nbsps)
local citation_name
= Cs(parsers.dash^-1) * parsers.at
* Cs(citation_chars
- * (((citation_chars + parsers.internal_punctuation
+ * ((( citation_chars
+ + parsers.internal_punctuation
- parsers.comma - parsers.semicolon)
- * -#((parsers.internal_punctuation - parsers.comma
+ * -#(( parsers.internal_punctuation
+ - parsers.comma
- parsers.semicolon)^0
- * -(citation_chars + parsers.internal_punctuation
- - parsers.comma - parsers.semicolon)))^0
+ * -( citation_chars
+ + parsers.internal_punctuation
+ - parsers.comma
+ - parsers.semicolon)))^0
* citation_chars)^-1)
local citation_body_prenote
@@ -30568,10 +31487,14 @@ M.extensions.citations = function(citation_nbsps)
+ parsers.inticks
+ parsers.autolink
+ V("InlineHtml")
- + V("Space") + V("Endline")
+ + V("Space") + V("EndlineNoSub")
+ (parsers.anyescaped
- - (parsers.newline + parsers.rbracket + parsers.blankline^2))
- - (parsers.spnl * parsers.dash^-1 * parsers.at))^1)
+ - ( parsers.newline
+ + parsers.rbracket
+ + parsers.blankline^2))
+ - ( parsers.spnl
+ * parsers.dash^-1
+ * parsers.at))^1)
local citation_body_postnote
= Cs((parsers.alphanumeric^1
@@ -30579,9 +31502,11 @@ M.extensions.citations = function(citation_nbsps)
+ parsers.inticks
+ parsers.autolink
+ V("InlineHtml")
- + V("Space") + V("Endline")
+ + V("Space") + V("EndlineNoSub")
+ (parsers.anyescaped
- - (parsers.newline + parsers.rbracket + parsers.semicolon
+ - ( parsers.newline
+ + parsers.rbracket
+ + parsers.semicolon
+ parsers.blankline^2))
- (parsers.spnl * parsers.rbracket))^1)
@@ -30592,7 +31517,8 @@ M.extensions.citations = function(citation_nbsps)
* parsers.spnlc
)
* citation_name
- * (parsers.internal_punctuation - parsers.semicolon)^-1
+ * ( parsers.internal_punctuation
+ - parsers.semicolon)^-1
* ( parsers.spnlc / function(_) return end
* citation_body_postnote
+ Cc("")
@@ -30614,7 +31540,9 @@ M.extensions.citations = function(citation_nbsps)
+ V("InlineHtml")
+ V("Space") + V("Endline")
+ (parsers.anyescaped
- - (parsers.newline + parsers.rbracket + parsers.at
+ - ( parsers.newline
+ + parsers.rbracket
+ + parsers.at
+ parsers.semicolon + parsers.blankline^2))
- (parsers.spnl * parsers.rbracket))^0)
@@ -30708,7 +31636,8 @@ M.extensions.content_blocks = function(language_map)
% \begin{macrocode}
local languages_json = (function()
local base, prev, curr
- for _, pathname in ipairs{kpse.lookup(language_map, { all=true })} do
+ for _, pathname in ipairs{kpse.lookup(language_map,
+ {all=true})} do
local file = io.open(pathname, "r")
if not file then goto continue end
local input = assert(file:read("*a"))
@@ -30749,20 +31678,20 @@ M.extensions.content_blocks = function(language_map)
suf = suf:lower()
if type == "onlineimage" then
return {"\\markdownRendererContentBlockOnlineImage{",suf,"}",
- "{",self.string(src),"}",
- "{",self.uri(src),"}",
- "{",self.string(tit or ""),"}"}
+ "{",self.string(src),"}",
+ "{",self.uri(src),"}",
+ "{",self.string(tit or ""),"}"}
elseif languages_json[suf] then
return {"\\markdownRendererContentBlockCode{",suf,"}",
- "{",self.string(languages_json[suf]),"}",
- "{",self.string(src),"}",
- "{",self.uri(src),"}",
- "{",self.string(tit or ""),"}"}
+ "{",self.string(languages_json[suf]),"}",
+ "{",self.string(src),"}",
+ "{",self.uri(src),"}",
+ "{",self.string(tit or ""),"}"}
else
return {"\\markdownRendererContentBlock{",suf,"}",
- "{",self.string(src),"}",
- "{",self.uri(src),"}",
- "{",self.string(tit or ""),"}"}
+ "{",self.string(src),"}",
+ "{",self.uri(src),"}",
+ "{",self.string(tit or ""),"}"}
end
end
end, extend_reader = function(self)
@@ -30797,8 +31726,8 @@ M.extensions.content_blocks = function(language_map)
return parser
end)("png", "jpg", "jpeg", "gif", "tif", "tiff")
- -- online image url for iA Writer content blocks with mandatory suffix,
- -- allowing nested brackets:
+ -- online image url for iA Writer content blocks with
+ -- mandatory suffix, allowing nested brackets:
local onlineimageurl
= (parsers.less
* Cs((parsers.anyescaped
@@ -30876,8 +31805,9 @@ M.extensions.definition_lists = function(tight_lists)
local function dlitem(term, defs)
local retVal = {"\\markdownRendererDlItem{",term,"}"}
for _, def in ipairs(defs) do
- retVal[#retVal+1] = {"\\markdownRendererDlDefinitionBegin ",def,
- "\\markdownRendererDlDefinitionEnd "}
+ retVal[#retVal+1]
+ = {"\\markdownRendererDlDefinitionBegin ",def,
+ "\\markdownRendererDlDefinitionEnd "}
end
retVal[#retVal+1] = "\\markdownRendererDlItemEnd "
return retVal
@@ -30903,17 +31833,26 @@ M.extensions.definition_lists = function(tight_lists)
local defstartchar = S("~:")
- local defstart = parsers.check_trail_length(0) * defstartchar * #parsers.spacing
- * (parsers.tab + parsers.space^-3)
- + parsers.check_trail_length(1) * defstartchar * #parsers.spacing
- * (parsers.tab + parsers.space^-2)
- + parsers.check_trail_length(2) * defstartchar * #parsers.spacing
- * (parsers.tab + parsers.space^-1)
- + parsers.check_trail_length(3) * defstartchar * #parsers.spacing
-
- local indented_line = (parsers.check_minimal_indent / "") * parsers.check_code_trail * parsers.line
-
- local blank = parsers.check_minimal_blank_indent_and_any_trail * parsers.optionalspace * parsers.newline
+ local defstart
+ = parsers.check_trail_length(0) * defstartchar
+ * #parsers.spacing
+ * (parsers.tab + parsers.space^-3)
+ + parsers.check_trail_length(1)
+ * defstartchar * #parsers.spacing
+ * (parsers.tab + parsers.space^-2)
+ + parsers.check_trail_length(2)
+ * defstartchar * #parsers.spacing
+ * (parsers.tab + parsers.space^-1)
+ + parsers.check_trail_length(3)
+ * defstartchar * #parsers.spacing
+
+ local indented_line
+ = (parsers.check_minimal_indent / "")
+ * parsers.check_code_trail * parsers.line
+
+ local blank
+ = parsers.check_minimal_blank_indent_and_any_trail
+ * parsers.optionalspace * parsers.newline
local dlchunk = Cs(parsers.line * (indented_line - blank)^0)
@@ -30930,24 +31869,24 @@ M.extensions.definition_lists = function(tight_lists)
end
local DefinitionListItemLoose
- = C(parsers.line) * blank^0
- * Ct((parsers.check_minimal_indent * (defstart
- * indented_blocks(dlchunk)
- / self.parser_functions.parse_blocks_nested))^1)
- * Cc(false) / definition_list_item
+ = C(parsers.line) * blank^0
+ * Ct((parsers.check_minimal_indent * (defstart
+ * indented_blocks(dlchunk)
+ / self.parser_functions.parse_blocks_nested))^1)
+ * Cc(false) / definition_list_item
local DefinitionListItemTight
- = C(parsers.line)
- * Ct((parsers.check_minimal_indent * (defstart * dlchunk
- / self.parser_functions.parse_blocks_nested))^1)
- * Cc(true) / definition_list_item
+ = C(parsers.line)
+ * Ct((parsers.check_minimal_indent * (defstart * dlchunk
+ / self.parser_functions.parse_blocks_nested))^1)
+ * Cc(true) / definition_list_item
local DefinitionList
- = ( Ct(DefinitionListItemLoose^1) * Cc(false)
- + Ct(DefinitionListItemTight^1)
- * (blank^0
- * -DefinitionListItemLoose * Cc(true))
- ) / writer.definitionlist
+ = ( Ct(DefinitionListItemLoose^1) * Cc(false)
+ + Ct(DefinitionListItemTight^1)
+ * (blank^0
+ * -DefinitionListItemLoose * Cc(true))
+ ) / writer.definitionlist
self.insert_pattern("Block after Heading",
DefinitionList, "DefinitionList")
@@ -31032,7 +31971,8 @@ M.extensions.fancy_lists = function()
return {"\\markdownRendererFancyOlItemWithNumber{",num,"}",s,
"\\markdownRendererFancyOlItemEnd "}
else
- return {"\\markdownRendererFancyOlItem ",s,"\\markdownRendererFancyOlItemEnd "}
+ return {"\\markdownRendererFancyOlItem ",s,
+ "\\markdownRendererFancyOlItemEnd "}
end
end
end, extend_reader = function(self)
@@ -31053,7 +31993,8 @@ M.extensions.fancy_lists = function()
continuation_marker = marker
end
for _,delim in ipairs(delims) do
- table.insert(markers_table, {start_marker, continuation_marker, delim})
+ table.insert(markers_table,
+ {start_marker, continuation_marker, delim})
end
end
return markers_table
@@ -31072,15 +32013,18 @@ M.extensions.fancy_lists = function()
local roman_marker = function(chars)
local m, d, c = P(chars[1]), P(chars[2]), P(chars[3])
- local l, x, v, i = P(chars[4]), P(chars[5]), P(chars[6]), P(chars[7])
+ local l, x, v, i
+ = P(chars[4]), P(chars[5]), P(chars[6]), P(chars[7])
return m^-3
* (c*m + c*d + d^-1 * c^-3)
* (x*c + x*l + l^-1 * x^-3)
* (i*x + i*v + v^-1 * i^-3)
end
- local lowercase_roman_marker = roman_marker({"m", "d", "c", "l", "x", "v", "i"})
- local uppercase_roman_marker = roman_marker({"M", "D", "C", "L", "X", "V", "I"})
+ local lowercase_roman_marker
+ = roman_marker({"m", "d", "c", "l", "x", "v", "i"})
+ local uppercase_roman_marker
+ = roman_marker({"M", "D", "C", "L", "X", "V", "I"})
local lowercase_opening_roman_marker = P("i")
local uppercase_opening_roman_marker = P("I")
@@ -31104,7 +32048,8 @@ M.extensions.fancy_lists = function()
local markers_table = combine_markers_and_delims(markers, delims)
- local function enumerator(start_marker, _, delimiter_type, interrupting)
+ local function enumerator(start_marker, _,
+ delimiter_type, interrupting)
local delimiter_range
local allowed_end
if interrupting then
@@ -31112,7 +32057,8 @@ M.extensions.fancy_lists = function()
allowed_end = C(parsers.spacechar^1) * #parsers.linechar
else
delimiter_range = start_marker
- allowed_end = C(parsers.spacechar^1) + #(parsers.newline + parsers.eof)
+ allowed_end = C(parsers.spacechar^1)
+ + #(parsers.newline + parsers.eof)
end
return parsers.check_trail
@@ -31134,13 +32080,15 @@ M.extensions.fancy_lists = function()
end
local function roman2number(roman)
- local romans = { ["M"] = 1000, ["D"] = 500, ["C"] = 100, ["L"] = 50, ["X"] = 10, ["V"] = 5, ["I"] = 1 }
+ local romans = { ["M"] = 1000, ["D"] = 500, ["C"] = 100,
+ ["L"] = 50, ["X"] = 10, ["V"] = 5, ["I"] = 1 }
local numeral = 0
local i = 1
local len = string.len(roman)
while i < len do
- local z1, z2 = romans[ string.sub(roman, i, i) ], romans[ string.sub(roman, i+1, i+1) ]
+ local z1, z2 = romans[ string.sub(roman, i, i) ],
+ romans[ string.sub(roman, i+1, i+1) ]
if z1 < z2 then
numeral = numeral + (z2 - z1)
i = i + 2
@@ -31149,7 +32097,9 @@ M.extensions.fancy_lists = function()
i = i + 1
end
end
- if i <= len then numeral = numeral + romans[ string.sub(roman,i,i) ] end
+ if i <= len then
+ numeral = numeral + romans[ string.sub(roman,i,i) ]
+ end
return numeral
end
@@ -31174,11 +32124,13 @@ M.extensions.fancy_lists = function()
end
num = numstr:match("^([A-Z])$")
if num then
- return string.byte(num) - string.byte("A") + 1, "UpperAlpha", numdelim
+ return string.byte(num) - string.byte("A") + 1,
+ "UpperAlpha", numdelim
end
num = numstr:match("^([a-z])$")
if num then
- return string.byte(num) - string.byte("a") + 1, "LowerAlpha", numdelim
+ return string.byte(num) - string.byte("a") + 1,
+ "LowerAlpha", numdelim
end
num = numstr:match("^([IVXLCDM]+)")
if num then
@@ -31192,30 +32144,39 @@ M.extensions.fancy_lists = function()
end
local function fancylist(items,tight,start)
- local startnum, numstyle, numdelim = sniffstyle(start[2][1], start[2][2])
+ local startnum, numstyle, numdelim
+ = sniffstyle(start[2][1], start[2][2])
return writer.fancylist(items,tight,
options.startNumber and startnum or 1,
numstyle or "Decimal",
numdelim or "Default")
end
- local FancyListOfType = function(start_marker, continuation_marker, delimiter_type)
- local enumerator_start = enumerator(start_marker, continuation_marker, delimiter_type)
- local enumerator_cont = enumerator(continuation_marker, continuation_marker, delimiter_type)
- return Cg(enumerator_start, "listtype")
- * (Ct( TightListItem(Cb("listtype"))
- * ((parsers.check_minimal_indent / "") * TightListItem(enumerator_cont))^0)
- * Cc(true)
- * -#((parsers.conditionally_indented_blankline^0 / "")
- * parsers.check_minimal_indent * enumerator_cont)
- + Ct( LooseListItem(Cb("listtype"))
- * ((parsers.conditionally_indented_blankline^0 / "")
- * (parsers.check_minimal_indent / "") * LooseListItem(enumerator_cont))^0)
- * Cc(false)
- ) * Ct(Cb("listtype")) / fancylist
- end
+ local FancyListOfType
+ = function(start_marker, continuation_marker, delimiter_type)
+ local enumerator_start
+ = enumerator(start_marker, continuation_marker,
+ delimiter_type)
+ local enumerator_cont
+ = enumerator(continuation_marker, continuation_marker,
+ delimiter_type)
+ return Cg(enumerator_start, "listtype")
+ * (Ct( TightListItem(Cb("listtype"))
+ * ((parsers.check_minimal_indent / "")
+ * TightListItem(enumerator_cont))^0)
+ * Cc(true)
+ * -#((parsers.conditionally_indented_blankline^0 / "")
+ * parsers.check_minimal_indent * enumerator_cont)
+ + Ct( LooseListItem(Cb("listtype"))
+ * ((parsers.conditionally_indented_blankline^0 / "")
+ * (parsers.check_minimal_indent / "")
+ * LooseListItem(enumerator_cont))^0)
+ * Cc(false)
+ ) * Ct(Cb("listtype")) / fancylist
+ end
- local FancyList = join_table_with_func(FancyListOfType, markers_table)
+ local FancyList
+ = join_table_with_func(FancyListOfType, markers_table)
local Endline = parsers.newline
* (parsers.check_minimal_indent
@@ -31271,14 +32232,17 @@ M.extensions.fenced_code = function(blank_before_code_fence,
s = s:gsub("\n$", "")
local buf = {}
if attr ~= nil then
- table.insert(buf, {"\\markdownRendererFencedCodeAttributeContextBegin",
- self.attributes(attr)})
+ table.insert(buf,
+ {"\\markdownRendererFencedCodeAttributeContextBegin",
+ self.attributes(attr)})
end
local name = util.cache_verbatim(options.cacheDir, s)
- table.insert(buf, {"\\markdownRendererInputFencedCode{",
- name,"}{",self.string(i),"}{",self.infostring(i),"}"})
+ table.insert(buf,
+ {"\\markdownRendererInputFencedCode{",
+ name,"}{",self.string(i),"}{",self.infostring(i),"}"})
if attr ~= nil then
- table.insert(buf, "\\markdownRendererFencedCodeAttributeContextEnd{}")
+ table.insert(buf,
+ "\\markdownRendererFencedCodeAttributeContextEnd{}")
end
return buf
end
@@ -31318,11 +32282,13 @@ M.extensions.fenced_code = function(blank_before_code_fence,
- parsers.newline)^0)
/ strip_enclosing_whitespaces)
- local backtick_infostring = Cs(Cs((V("HtmlEntity")
- + (-#(parsers.backslash * parsers.backtick) * parsers.anyescaped)
- - parsers.newline
- - parsers.backtick)^0)
- / strip_enclosing_whitespaces)
+ local backtick_infostring
+ = Cs( Cs((V("HtmlEntity")
+ + ( -#(parsers.backslash * parsers.backtick)
+ * parsers.anyescaped)
+ - parsers.newline
+ - parsers.backtick)^0)
+ / strip_enclosing_whitespaces)
local fenceindent
@@ -31344,77 +32310,93 @@ M.extensions.fenced_code = function(blank_before_code_fence,
end
end
- local function count_fenced_start_indent(_, _, indent_table, trail)
- local last_indent_name = get_last_indent_name(indent_table)
- fenceindent = 0
- if last_indent_name ~= "li" then
- fenceindent = #trail
+ local count_fenced_start_indent =
+ function(_, _, indent_table, trail)
+ local last_indent_name = get_last_indent_name(indent_table)
+ fenceindent = 0
+ if last_indent_name ~= "li" then
+ fenceindent = #trail
+ end
+ return true
end
- return true
- end
- local fencehead = function(char, infostring)
- return Cmt(Cb("indent_info") * parsers.check_trail, count_fenced_start_indent)
- * Cg(char^3, "fencelength")
- * parsers.optionalspace
- * infostring
- * (parsers.newline + parsers.eof)
+ local fencehead = function(char, infostring)
+ return Cmt( Cb("indent_info")
+ * parsers.check_trail, count_fenced_start_indent)
+ * Cg(char^3, "fencelength")
+ * parsers.optionalspace
+ * infostring
+ * (parsers.newline + parsers.eof)
end
- local fencetail = function(char)
- return parsers.check_trail_no_rem
- * Cmt(C(char^3) * Cb("fencelength"), captures_geq_length)
- * parsers.optionalspace * (parsers.newline + parsers.eof)
- + parsers.eof
+ local fencetail = function(char)
+ return parsers.check_trail_no_rem
+ * Cmt(C(char^3) * Cb("fencelength"), captures_geq_length)
+ * parsers.optionalspace * (parsers.newline + parsers.eof)
+ + parsers.eof
end
- local function process_fenced_line(s, i, indent_table, line_content, is_blank) -- luacheck: ignore s i
- local remainder = ""
- if has_trail(indent_table) then
- remainder = indent_table.trail.internal_remainder
- end
+ local process_fenced_line =
+ function(s, i, -- luacheck: ignore s i
+ indent_table, line_content, is_blank)
+ local remainder = ""
+ if has_trail(indent_table) then
+ remainder = indent_table.trail.internal_remainder
+ end
- if is_blank and get_last_indent_name(indent_table) == "li" then
- remainder = ""
- end
+ if is_blank
+ and get_last_indent_name(indent_table) == "li" then
+ remainder = ""
+ end
- local str = remainder .. line_content
- local index = 1
- local remaining = fenceindent
+ local str = remainder .. line_content
+ local index = 1
+ local remaining = fenceindent
- while true do
- local c = str:sub(index, index)
- if c == " " and remaining > 0 then
- remaining = remaining - 1
- index = index + 1
- elseif c == "\t" and remaining > 3 then
- remaining = remaining - 4
- index = index + 1
- else
- break
+ while true do
+ local c = str:sub(index, index)
+ if c == " " and remaining > 0 then
+ remaining = remaining - 1
+ index = index + 1
+ elseif c == "\t" and remaining > 3 then
+ remaining = remaining - 4
+ index = index + 1
+ else
+ break
+ end
end
- end
- return true, str:sub(index)
- end
+ return true, str:sub(index)
+ end
local fencedline = function(char)
- return Cmt(Cb("indent_info") * C(parsers.line - fencetail(char)) * Cc(false), process_fenced_line)
+ return Cmt( Cb("indent_info")
+ * C(parsers.line - fencetail(char))
+ * Cc(false), process_fenced_line)
end
- local blankfencedline = Cmt(Cb("indent_info") * C(parsers.blankline) * Cc(true), process_fenced_line)
+ local blankfencedline
+ = Cmt( Cb("indent_info")
+ * C(parsers.blankline)
+ * Cc(true), process_fenced_line)
local TildeFencedCode
- = fencehead(parsers.tilde, tilde_infostring)
- * Cs(((parsers.check_minimal_blank_indent / "") * blankfencedline
- + (parsers.check_minimal_indent / "") * fencedline(parsers.tilde))^0)
- * ((parsers.check_minimal_indent / "") * fencetail(parsers.tilde) + parsers.succeed)
+ = fencehead(parsers.tilde, tilde_infostring)
+ * Cs(( (parsers.check_minimal_blank_indent / "")
+ * blankfencedline
+ + ( parsers.check_minimal_indent / "")
+ * fencedline(parsers.tilde))^0)
+ * ( (parsers.check_minimal_indent / "")
+ * fencetail(parsers.tilde) + parsers.succeed)
local BacktickFencedCode
= fencehead(parsers.backtick, backtick_infostring)
- * Cs(((parsers.check_minimal_blank_indent / "") * blankfencedline
- + (parsers.check_minimal_indent / "") * fencedline(parsers.backtick))^0)
- * ((parsers.check_minimal_indent / "") * fencetail(parsers.backtick) + parsers.succeed)
+ * Cs(( (parsers.check_minimal_blank_indent / "")
+ * blankfencedline
+ + (parsers.check_minimal_indent / "")
+ * fencedline(parsers.backtick))^0)
+ * ( (parsers.check_minimal_indent / "")
+ * fencetail(parsers.backtick) + parsers.succeed)
local infostring_with_attributes
= Ct(C((parsers.linechar
@@ -31424,28 +32406,28 @@ M.extensions.fenced_code = function(blank_before_code_fence,
* Ct(parsers.attributes))
local FencedCode
- = ((TildeFencedCode + BacktickFencedCode)
- / function(infostring, code)
- local expanded_code = self.expandtabs(code)
-
- if allow_raw_blocks then
- local raw_attr = lpeg.match(parsers.raw_attribute,
- infostring)
- if raw_attr then
- return writer.rawBlock(expanded_code, raw_attr)
- end
- end
-
- local attr = nil
- if allow_attributes then
- local match = lpeg.match(infostring_with_attributes,
- infostring)
- if match then
- infostring, attr = table.unpack(match)
- end
- end
- return writer.fencedCode(expanded_code, infostring, attr)
- end)
+ = ((TildeFencedCode + BacktickFencedCode)
+ / function(infostring, code)
+ local expanded_code = self.expandtabs(code)
+
+ if allow_raw_blocks then
+ local raw_attr = lpeg.match(parsers.raw_attribute,
+ infostring)
+ if raw_attr then
+ return writer.rawBlock(expanded_code, raw_attr)
+ end
+ end
+
+ local attr = nil
+ if allow_attributes then
+ local match = lpeg.match(infostring_with_attributes,
+ infostring)
+ if match then
+ infostring, attr = table.unpack(match)
+ end
+ end
+ return writer.fencedCode(expanded_code, infostring, attr)
+ end)
self.insert_pattern("Block after Verbatim",
FencedCode, "FencedCode")
@@ -31497,10 +32479,13 @@ M.extensions.fenced_divs = function(blank_before_div_fence)
% \end{markdown}
% \begin{macrocode}
function self.div_begin(attributes)
- local start_output = {"\\markdownRendererFencedDivAttributeContextBegin\n",
- self.attributes(attributes)}
- local end_output = {"\\markdownRendererFencedDivAttributeContextEnd{}"}
- return self.push_attributes("div", attributes, start_output, end_output)
+ local start_output
+ = {"\\markdownRendererFencedDivAttributeContextBegin\n",
+ self.attributes(attributes)}
+ local end_output
+ = {"\\markdownRendererFencedDivAttributeContextEnd{}"}
+ return self.push_attributes(
+ "div", attributes, start_output, end_output)
end
% \end{macrocode}
% \par
@@ -31561,21 +32546,24 @@ M.extensions.fenced_divs = function(blank_before_div_fence)
self.initialize_named_group("fenced_div_num_opening_indents")
local function increment_div_level()
- local function push_indent_table(s, i, indent_table, -- luacheck: ignore s i
- fenced_div_num_opening_indents, fenced_div_level)
- fenced_div_level = tonumber(fenced_div_level) + 1
- local num_opening_indents = 0
- if indent_table.indents ~= nil then
- num_opening_indents = #indent_table.indents
+ local push_indent_table =
+ function(s, i, indent_table, -- luacheck: ignore s i
+ fenced_div_num_opening_indents, fenced_div_level)
+ fenced_div_level = tonumber(fenced_div_level) + 1
+ local num_opening_indents = 0
+ if indent_table.indents ~= nil then
+ num_opening_indents = #indent_table.indents
+ end
+ fenced_div_num_opening_indents[fenced_div_level]
+ = num_opening_indents
+ return true, fenced_div_num_opening_indents
end
- fenced_div_num_opening_indents[fenced_div_level] = num_opening_indents
- return true, fenced_div_num_opening_indents
- end
- local function increment_level(s, i, fenced_div_level) -- luacheck: ignore s i
- fenced_div_level = tonumber(fenced_div_level) + 1
- return true, tostring(fenced_div_level)
- end
+ local increment_level =
+ function(s, i, fenced_div_level) -- luacheck: ignore s i
+ fenced_div_level = tonumber(fenced_div_level) + 1
+ return true, tostring(fenced_div_level)
+ end
return Cg( Cmt( Cb("indent_info")
* Cb("fenced_div_num_opening_indents")
@@ -31586,11 +32574,13 @@ M.extensions.fenced_divs = function(blank_before_div_fence)
end
local function decrement_div_level()
- local function pop_indent_table(s, i, fenced_div_indent_table, fenced_div_level) -- luacheck: ignore s i
- fenced_div_level = tonumber(fenced_div_level)
- fenced_div_indent_table[fenced_div_level] = nil
- return true, tostring(fenced_div_level - 1)
- end
+ local pop_indent_table =
+ function(s, i, -- luacheck: ignore s i
+ fenced_div_indent_table, fenced_div_level)
+ fenced_div_level = tonumber(fenced_div_level)
+ fenced_div_indent_table[fenced_div_level] = nil
+ return true, tostring(fenced_div_level - 1)
+ end
return Cg( Cmt( Cb("fenced_div_num_opening_indents")
* Cb("fenced_div_level"), pop_indent_table)
@@ -31598,21 +32588,24 @@ M.extensions.fenced_divs = function(blank_before_div_fence)
end
- local non_fenced_div_block = parsers.check_minimal_indent * V("Block")
- - parsers.check_minimal_indent_and_trail * fenced_div_end
+ local non_fenced_div_block
+ = parsers.check_minimal_indent * V("Block")
+ - parsers.check_minimal_indent_and_trail * fenced_div_end
- local non_fenced_div_paragraph = parsers.check_minimal_indent * V("Paragraph")
- - parsers.check_minimal_indent_and_trail * fenced_div_end
+ local non_fenced_div_paragraph
+ = parsers.check_minimal_indent * V("Paragraph")
+ - parsers.check_minimal_indent_and_trail * fenced_div_end
local blank = parsers.minimally_indented_blank
- local block_separated = parsers.block_sep_group(blank)
- * non_fenced_div_block
+ local block_separated = parsers.block_sep_group(blank)
+ * non_fenced_div_block
- local loop_body_pair = parsers.create_loop_body_pair(block_separated,
- non_fenced_div_paragraph,
- parsers.block_sep_group(blank),
- parsers.par_sep_group(blank))
+ local loop_body_pair
+ = parsers.create_loop_body_pair(block_separated,
+ non_fenced_div_paragraph,
+ parsers.block_sep_group(blank),
+ parsers.par_sep_group(blank))
local content_loop = ( non_fenced_div_block
* loop_body_pair.block^0
@@ -31625,7 +32618,9 @@ M.extensions.fenced_divs = function(blank_before_div_fence)
local FencedDiv = fenced_div_begin
/ function (infostring)
- local attr = lpeg.match(Ct(parsers.attributes), infostring)
+ local attr
+ = lpeg.match(Ct(parsers.attributes),
+ infostring)
if attr == nil then
attr = {"." .. infostring}
end
@@ -31636,7 +32631,8 @@ M.extensions.fenced_divs = function(blank_before_div_fence)
* parsers.skipblanklines
* Ct(content_loop)
* parsers.minimally_indented_blank^0
- * parsers.check_minimal_indent_and_trail * fenced_div_end
+ * parsers.check_minimal_indent_and_trail
+ * fenced_div_end
* decrement_div_level()
* (Cc("") / writer.div_end)
@@ -31657,23 +32653,27 @@ M.extensions.fenced_divs = function(blank_before_div_fence)
% \end{markdown}
% \begin{macrocode}
local function is_inside_div()
- local function check_div_level(s, i, fenced_div_level) -- luacheck: ignore s i
- fenced_div_level = tonumber(fenced_div_level)
- return fenced_div_level > 0
- end
+ local check_div_level =
+ function(s, i, fenced_div_level) -- luacheck: ignore s i
+ fenced_div_level = tonumber(fenced_div_level)
+ return fenced_div_level > 0
+ end
return Cmt(Cb("fenced_div_level"), check_div_level)
end
local function check_indent()
- local function compare_indent(s, i, indent_table, -- luacheck: ignore s i
- fenced_div_num_opening_indents, fenced_div_level)
- fenced_div_level = tonumber(fenced_div_level)
- local num_current_indents = (indent_table.current_line_indents ~= nil and
- #indent_table.current_line_indents) or 0
- local num_opening_indents = fenced_div_num_opening_indents[fenced_div_level]
- return num_current_indents == num_opening_indents
- end
+ local compare_indent =
+ function(s, i, indent_table, -- luacheck: ignore s i
+ fenced_div_num_opening_indents, fenced_div_level)
+ fenced_div_level = tonumber(fenced_div_level)
+ local num_current_indents
+ = ( indent_table.current_line_indents ~= nil and
+ #indent_table.current_line_indents) or 0
+ local num_opening_indents
+ = fenced_div_num_opening_indents[fenced_div_level]
+ return num_current_indents == num_opening_indents
+ end
return Cmt( Cb("indent_info")
* Cb("fenced_div_num_opening_indents")
@@ -31745,26 +32745,31 @@ M.extensions.header_attributes = function()
* parsers.newline))^1
- parsers.thematic_break_lines
- local heading_text = heading_line
- * ((V("Endline") / "\n") * (heading_line - parsers.heading_level))^0
- * parsers.newline^-1
-
- local SetextHeading = parsers.freeze_trail * parsers.check_trail_no_rem
- * #(heading_text
- * (parsers.attributes
- * parsers.optionalspace
- * parsers.newline)^-1
- * parsers.check_minimal_indent * parsers.check_trail * parsers.heading_level)
- * Cs(heading_text) / strip_trailing_spaces
- / parsers.parse_heading_text
- * Cg(Ct((parsers.attributes
- * parsers.optionalspace
- * parsers.newline)^-1), "attributes")
- * parsers.check_minimal_indent_and_trail * parsers.heading_level
- * Cb("attributes")
- * parsers.newline
- * parsers.unfreeze_trail
- / writer.heading
+ local heading_text
+ = heading_line
+ * ( (V("Endline") / "\n")
+ * (heading_line - parsers.heading_level))^0
+ * parsers.newline^-1
+
+ local SetextHeading
+ = parsers.freeze_trail * parsers.check_trail_no_rem
+ * #(heading_text
+ * (parsers.attributes
+ * parsers.optionalspace
+ * parsers.newline)^-1
+ * parsers.check_minimal_indent
+ * parsers.check_trail
+ * parsers.heading_level)
+ * Cs(heading_text) / strip_trailing_spaces
+ / parsers.parse_heading_text
+ * Cg(Ct((parsers.attributes
+ * parsers.optionalspace
+ * parsers.newline)^-1), "attributes")
+ * parsers.check_minimal_indent_and_trail * parsers.heading_level
+ * Cb("attributes")
+ * parsers.newline
+ * parsers.unfreeze_trail
+ / writer.heading
local Heading = AtxHeading + SetextHeading
self.update_rule("Heading", Heading)
@@ -31838,18 +32843,18 @@ M.extensions.line_blocks = function()
local parsers = self.parsers
local writer = self.writer
- local LineBlock = Ct(
- (Cs(
- ( (parsers.pipe * parsers.space)/""
- * ((parsers.space)/entities.char_entity("nbsp"))^0
- * parsers.linechar^0 * (parsers.newline/""))
- * (-parsers.pipe
- * (parsers.space^1/" ")
- * parsers.linechar^1
- * (parsers.newline/"")
- )^0
- * (parsers.blankline/"")^0
- ) / self.parser_functions.parse_inlines)^1) / writer.lineblock
+ local LineBlock
+ = Ct((Cs(( (parsers.pipe * parsers.space) / ""
+ * ((parsers.space)/entities.char_entity("nbsp"))^0
+ * parsers.linechar^0 * (parsers.newline/""))
+ * (-parsers.pipe
+ * (parsers.space^1/" ")
+ * parsers.linechar^1
+ * (parsers.newline/"")
+ )^0
+ * (parsers.blankline/"")^0)
+ / self.parser_functions.parse_inlines)^1)
+ / writer.lineblock
self.insert_pattern("Block after Blockquote",
LineBlock, "LineBlock")
@@ -31889,8 +32894,9 @@ M.extensions.mark = function()
local doubleequals = P("==")
- local Mark = parsers.between(V("Inline"), doubleequals, doubleequals)
- / function (inlines) return writer.mark(inlines) end
+ local Mark
+ = parsers.between(V("Inline"), doubleequals, doubleequals)
+ / function (inlines) return writer.mark(inlines) end
self.add_special_character("=")
self.insert_pattern("Inline before LinkAndEmph",
@@ -31923,13 +32929,18 @@ M.extensions.link_attributes = function()
%
% \end{markdown}
% \begin{macrocode}
- local define_reference_parser = (parsers.check_trail / "") * parsers.link_label * parsers.colon
- * parsers.spnlc * parsers.url
- * ( parsers.spnlc_sep * parsers.title * (parsers.spnlc * Ct(parsers.attributes))
- * parsers.only_blank
- + parsers.spnlc_sep * parsers.title * parsers.only_blank
- + Cc("") * (parsers.spnlc * Ct(parsers.attributes)) * parsers.only_blank
- + Cc("") * parsers.only_blank)
+ local define_reference_parser
+ = (parsers.check_trail / "")
+ * parsers.link_label
+ * parsers.colon
+ * parsers.spnlc * parsers.url
+ * ( parsers.spnlc_sep * parsers.title
+ * (parsers.spnlc * Ct(parsers.attributes))
+ * parsers.only_blank
+ + parsers.spnlc_sep * parsers.title * parsers.only_blank
+ + Cc("") * (parsers.spnlc * Ct(parsers.attributes))
+ * parsers.only_blank
+ + Cc("") * parsers.only_blank)
local ReferenceWithAttributes = define_reference_parser
/ self.register_link
@@ -31944,8 +32955,10 @@ M.extensions.link_attributes = function()
% \end{markdown}
% \begin{macrocode}
- local LinkWithAttributesAndEmph = Ct(parsers.link_and_emph_table * Cg(Cc(true), "match_link_attributes"))
- / self.defer_link_and_emphasis_processing
+ local LinkWithAttributesAndEmph
+ = Ct(parsers.link_and_emph_table * Cg(Cc(true),
+ "match_link_attributes"))
+ / self.defer_link_and_emphasis_processing
self.update_rule("LinkAndEmph", LinkWithAttributesAndEmph)
@@ -32030,9 +33043,10 @@ M.extensions.notes = function(notes, inline_notes)
if inline_notes then
local InlineNote
- = parsers.circumflex
- * (parsers.link_label / self.parser_functions.parse_inlines_no_inline_note)
- / writer.note
+ = parsers.circumflex
+ * ( parsers.link_label
+ / self.parser_functions.parse_inlines_no_inline_note)
+ / writer.note
self.insert_pattern("Inline after LinkAndEmph",
InlineNote, "InlineNote")
@@ -32070,20 +33084,27 @@ M.extensions.notes = function(notes, inline_notes)
local NoteRef = RawNoteRef / lookup_note
- local optionally_indented_line = parsers.check_optional_indent_and_any_trail * parsers.line
+ local optionally_indented_line
+ = parsers.check_optional_indent_and_any_trail * parsers.line
- local blank = parsers.check_optional_blank_indent_and_any_trail * parsers.optionalspace * parsers.newline
+ local blank
+ = parsers.check_optional_blank_indent_and_any_trail
+ * parsers.optionalspace * parsers.newline
- local chunk = Cs(parsers.line * (optionally_indented_line - blank)^0)
+ local chunk
+ = Cs(parsers.line
+ * (optionally_indented_line - blank)^0)
local indented_blocks = function(bl)
return Cs( bl
- * (blank^1 * (parsers.check_optional_indent / "")
- * parsers.check_code_trail * -parsers.blankline * bl)^0)
+ * ( blank^1 * (parsers.check_optional_indent / "")
+ * parsers.check_code_trail
+ * -parsers.blankline * bl)^0)
end
local NoteBlock
- = parsers.check_trail_no_rem * RawNoteRef * parsers.colon
+ = parsers.check_trail_no_rem
+ * RawNoteRef * parsers.colon
* parsers.spnlc * indented_blocks(chunk)
/ register_note
@@ -32241,24 +33262,26 @@ M.extensions.pipe_tables = function(table_captions, table_attributes)
, table_hline_separator
, table_hline_column)
- local table_caption_beginning = (parsers.check_minimal_blank_indent_and_any_trail_no_rem
- * parsers.optionalspace * parsers.newline)^0
- * parsers.check_minimal_indent_and_trail
- * (P("Table")^-1 * parsers.colon)
- * parsers.optionalspace
+ local table_caption_beginning
+ = ( parsers.check_minimal_blank_indent_and_any_trail_no_rem
+ * parsers.optionalspace * parsers.newline)^0
+ * parsers.check_minimal_indent_and_trail
+ * (P("Table")^-1 * parsers.colon)
+ * parsers.optionalspace
local function strip_trailing_spaces(s)
return s:gsub("%s*$","")
end
- local table_row = pipe_table_row(true
- , (C((parsers.linechar - parsers.pipe)^1)
- / strip_trailing_spaces
- / self.parser_functions.parse_inlines)
- , parsers.pipe
- , (C((parsers.linechar - parsers.pipe)^0)
- / strip_trailing_spaces
- / self.parser_functions.parse_inlines))
+ local table_row
+ = pipe_table_row(true
+ , (C((parsers.linechar - parsers.pipe)^1)
+ / strip_trailing_spaces
+ / self.parser_functions.parse_inlines)
+ , parsers.pipe
+ , (C((parsers.linechar - parsers.pipe)^0)
+ / strip_trailing_spaces
+ / self.parser_functions.parse_inlines))
local table_caption
if table_captions then
@@ -32275,7 +33298,8 @@ M.extensions.pipe_tables = function(table_captions, table_attributes)
+ ( parsers.newline
* #( parsers.optionalspace
* parsers.linechar)
- * C(parsers.optionalspace) / writer.space))
+ * C(parsers.optionalspace)
+ / writer.space))
* (parsers.linechar
- parsers.lbrace)^0)^1)
/ self.parser_functions.parse_inlines)
@@ -32289,7 +33313,8 @@ M.extensions.pipe_tables = function(table_captions, table_attributes)
+ ( parsers.newline
* #( parsers.optionalspace
* parsers.linechar)
- * C(parsers.optionalspace) / writer.space))^1)
+ * C(parsers.optionalspace)
+ / writer.space))^1)
/ self.parser_functions.parse_inlines
* parsers.newline
end
@@ -32297,12 +33322,15 @@ M.extensions.pipe_tables = function(table_captions, table_attributes)
table_caption = parsers.fail
end
- local PipeTable = Ct(table_row * parsers.newline * (parsers.check_minimal_indent_and_trail / {})
- * table_hline * parsers.newline
- * ((parsers.check_minimal_indent / {}) * table_row * parsers.newline)^0)
- / make_pipe_table_rectangular
- * table_caption^-1
- / writer.table
+ local PipeTable
+ = Ct( table_row * parsers.newline
+ * (parsers.check_minimal_indent_and_trail / {})
+ * table_hline * parsers.newline
+ * ( (parsers.check_minimal_indent / {})
+ * table_row * parsers.newline)^0)
+ / make_pipe_table_rectangular
+ * table_caption^-1
+ / writer.table
self.insert_pattern("Block after Blockquote",
PipeTable, "PipeTable")
@@ -32470,7 +33498,8 @@ M.extensions.superscripts = function()
local writer = self.writer
local Superscript = (
- parsers.between(parsers.Str, parsers.circumflex, parsers.circumflex)
+ parsers.between(parsers.Str, parsers.circumflex,
+ parsers.circumflex)
) / writer.superscript
self.insert_pattern("Inline after LinkAndEmph",
@@ -32533,11 +33562,13 @@ M.extensions.tex_math = function(tex_math_dollars,
return str:gsub("^%s*(.-)$", "%1")
end
- local allowed_before_closing = B( parsers.backslash * parsers.any
- + parsers.any * (parsers.any - parsers.backslash))
+ local allowed_before_closing
+ = B( parsers.backslash * parsers.any
+ + parsers.any * (parsers.any - parsers.backslash))
- local allowed_before_closing_no_space = B( parsers.backslash * parsers.any
- + parsers.any * (parsers.nonspacechar - parsers.backslash))
+ local allowed_before_closing_no_space
+ = B( parsers.backslash * parsers.any
+ + parsers.any * (parsers.nonspacechar - parsers.backslash))
% \end{macrocode}
% \begin{markdown}
@@ -32546,18 +33577,20 @@ M.extensions.tex_math = function(tex_math_dollars,
%
% \end{markdown}
% \begin{macrocode}
- local dollar_math_content = (parsers.newline * (parsers.check_optional_indent / "")
- + parsers.backslash^-1
- * parsers.linechar)
- - parsers.blankline^2
- - parsers.dollar
+ local dollar_math_content
+ = (parsers.newline * (parsers.check_optional_indent / "")
+ + parsers.backslash^-1
+ * parsers.linechar)
+ - parsers.blankline^2
+ - parsers.dollar
local inline_math_opening_dollars = parsers.dollar
* #(parsers.nonspacechar)
- local inline_math_closing_dollars = allowed_before_closing_no_space
- * parsers.dollar
- * -#(parsers.digit)
+ local inline_math_closing_dollars
+ = allowed_before_closing_no_space
+ * parsers.dollar
+ * -#(parsers.digit)
local inline_math_dollars = between(Cs( dollar_math_content),
inline_math_opening_dollars,
@@ -32580,9 +33613,10 @@ M.extensions.tex_math = function(tex_math_dollars,
%
% \end{markdown}
% \begin{macrocode}
- local backslash_math_content = (parsers.newline * (parsers.check_optional_indent / "")
- + parsers.linechar)
- - parsers.blankline^2
+ local backslash_math_content
+ = (parsers.newline * (parsers.check_optional_indent / "")
+ + parsers.linechar)
+ - parsers.blankline^2
% \end{macrocode}
% \begin{markdown}
%
@@ -32702,11 +33736,15 @@ end
% \acro{yaml} metadata block syntax extension. When the
% `expect_jekyll_data` parameter is `true`, then a markdown document
% may begin directly with \acro{yaml} metadata and may contain nothing
-% but \acro{yaml} metadata.
+% but \acro{yaml} metadata. When both `expect_jekyll_data` and
+% `ensure_jekyll_data` parameters are `true`, then a a markdown document must
+% begin directly with \acro{yaml} metadata and must contain nothing but
+% \acro{yaml} metadata.
%
% \end{markdown}
% \begin{macrocode}
-M.extensions.jekyll_data = function(expect_jekyll_data)
+M.extensions.jekyll_data = function(expect_jekyll_data,
+ ensure_jekyll_data)
return {
name = "built-in jekyll_data syntax extension",
extend_writer = function(self)
@@ -32719,7 +33757,8 @@ M.extensions.jekyll_data = function(expect_jekyll_data)
% the key `p` in the parent table; if `p` is nil, then the table has no parent.
% All scalar keys and values encountered in the table will be cast to a string
% following \acro{yaml} serialization rules. String values will also be
-% transformed using the function `t`.
+% transformed using the function `t` for the typographic output format used by
+% the \mref{markdownRendererJekyllDataTypographicString} macro.
%
% \end{markdown}
% \begin{macrocode}
@@ -32764,17 +33803,18 @@ M.extensions.jekyll_data = function(expect_jekyll_data)
::not_a_sequence::
if is_sequence then
- table.insert(buf, "\\markdownRendererJekyllDataSequenceBegin{")
- table.insert(buf, self.identifier(p or "null"))
- table.insert(buf, "}{")
- table.insert(buf, #keys)
- table.insert(buf, "}")
+ table.insert(buf,
+ "\\markdownRendererJekyllDataSequenceBegin{")
+ table.insert(buf, self.identifier(p or "null"))
+ table.insert(buf, "}{")
+ table.insert(buf, #keys)
+ table.insert(buf, "}")
else
- table.insert(buf, "\\markdownRendererJekyllDataMappingBegin{")
- table.insert(buf, self.identifier(p or "null"))
- table.insert(buf, "}{")
- table.insert(buf, #keys)
- table.insert(buf, "}")
+ table.insert(buf, "\\markdownRendererJekyllDataMappingBegin{")
+ table.insert(buf, self.identifier(p or "null"))
+ table.insert(buf, "}{")
+ table.insert(buf, #keys)
+ table.insert(buf, "}")
end
for _, k in ipairs(keys) do
@@ -32802,7 +33842,14 @@ M.extensions.jekyll_data = function(expect_jekyll_data)
table.insert(buf, v)
table.insert(buf, "}")
elseif typ == "string" then
- table.insert(buf, "\\markdownRendererJekyllDataString{")
+ table.insert(buf,
+ "\\markdownRendererJekyllDataProgrammaticString{")
+ table.insert(buf, k)
+ table.insert(buf, "}{")
+ table.insert(buf, self.identifier(v))
+ table.insert(buf, "}")
+ table.insert(buf,
+ "\\markdownRendererJekyllDataTypographicString{")
table.insert(buf, k)
table.insert(buf, "}{")
table.insert(buf, t(v))
@@ -32812,8 +33859,10 @@ M.extensions.jekyll_data = function(expect_jekyll_data)
table.insert(buf, k)
table.insert(buf, "}")
else
- error(format("Unexpected type %s for value of " ..
- "YAML key %s", typ, k))
+ local error = self.error(format(
+ "Unexpected type %s for value of "
+ .. "YAML key %s.", typ, k))
+ table.insert(buf, error)
end
end
end
@@ -32835,38 +33884,49 @@ M.extensions.jekyll_data = function(expect_jekyll_data)
local writer = self.writer
local JekyllData
- = Cmt( C((parsers.line - P("---") - P("..."))^0)
- , function(s, i, text) -- luacheck: ignore s i
- local data
- local ran_ok, _ = pcall(function()
- -- TODO: Replace with `require("tinyyaml")` in TeX Live 2023
- local tinyyaml = require("markdown-tinyyaml")
- data = tinyyaml.parse(text, {timestamps=false})
- end)
- if ran_ok and data ~= nil then
- return true, writer.jekyllData(data, function(s)
- return self.parser_functions.parse_blocks_nested(s)
- end, nil)
- else
- return false
- end
- end
- )
+ = Cmt( C((parsers.line - P("---") - P("..."))^0)
+ , function(s, i, text) -- luacheck: ignore s i
+ local data
+ local ran_ok, _ = pcall(function()
+ -- TODO: Use `require("tinyyaml")` in TeX Live 2023
+ local tinyyaml = require("markdown-tinyyaml")
+ data = tinyyaml.parse(text, {timestamps=false})
+ end)
+ if ran_ok and data ~= nil then
+ return true, writer.jekyllData(data, function(s)
+ return self.parser_functions.parse_blocks_nested(s)
+ end, nil)
+ else
+ return false
+ end
+ end
+ )
local UnexpectedJekyllData
- = P("---")
- * parsers.blankline / 0
- * #(-parsers.blankline) -- if followed by blank, it's thematic break
- * JekyllData
- * (P("---") + P("..."))
+ = P("---")
+ * parsers.blankline / 0
+ -- if followed by blank, it's thematic break
+ * #(-parsers.blankline)
+ * JekyllData
+ * (P("---") + P("..."))
local ExpectedJekyllData
- = ( P("---")
- * parsers.blankline / 0
- * #(-parsers.blankline) -- if followed by blank, it's thematic break
- )^-1
- * JekyllData
- * (P("---") + P("..."))^-1
+ = ( P("---")
+ * parsers.blankline / 0
+ -- if followed by blank, it's thematic break
+ * #(-parsers.blankline)
+ )^-1
+ * JekyllData
+ * (P("---") + P("..."))^-1
+
+ if ensure_jekyll_data then
+ ExpectedJekyllData = ExpectedJekyllData
+ * parsers.eof
+ else
+ ExpectedJekyllData = ( ExpectedJekyllData
+ * (V("Blank")^0 / writer.interblocksep)
+ )^-1
+ end
self.insert_pattern("Block before Blockquote",
UnexpectedJekyllData, "UnexpectedJekyllData")
@@ -32881,9 +33941,123 @@ end
%
%### Conversion from Markdown to Plain \TeX{}
%
-% The \luamref{new} function returns a conversion function that takes a
-% markdown string and turns it into a plain \TeX{} output. See Section
-% <#sec:lua-conversion>.
+% The \luamref{new} function of file `markdown.lua` loads file
+% `markdown-parser.lua` and calls its own function \luamref{new} unless option
+% \Opt{eagerCache} or \Opt{finalizeCache} has been enabled and a cached
+% conversion output exists, in which case it is returned without loading file
+% `markdown-parser.lua`.
+%
+% \end{markdown}
+% \iffalse
+%</lua>
+%<*lua-loader>
+% \fi
+% \begin{macrocode}
+function M.new(options)
+% \end{macrocode}
+% \par
+% \begin{markdown}
+%
+% Make the `options` table inherit from the \luamref{defaultOptions} table.
+%
+% \end{markdown}
+% \begin{macrocode}
+ options = options or {}
+ setmetatable(options, { __index = function (_, key)
+ return defaultOptions[key] end })
+% \end{macrocode}
+% \par
+% \begin{markdown}
+%
+% Return a conversion function that tries to produce a cached conversion output
+% exists. If no cached conversion output exists, we load the file
+% `markdown-parser.lua` and use it to convert the input.
+%
+% \end{markdown}
+% \begin{macrocode}
+ local parser_convert = nil
+ return function(input)
+ local function convert(input)
+ if parser_convert == nil then
+% \end{macrocode}
+% \par
+% \begin{markdown}
+%
+% Lazy-load `markdown-parser.lua` and check that it originates from the same
+% version of the Markdown package.
+%
+% \end{markdown}
+% \begin{macrocode}
+ local parser = require("markdown-parser")
+ if metadata.version ~= parser.metadata.version then
+ warn("markdown.lua " .. metadata.version .. " used with " ..
+ "markdown-parser.lua " .. parser.metadata.version .. ".")
+ end
+ parser_convert = parser.new(options)
+ end
+ return parser_convert(input)
+ end
+% \end{macrocode}
+% \begin{markdown}
+% If we cache markdown documents, produce the cache file and transform its
+% filename to plain \TeX{} output.
+%
+% When determining the name of the cache file, create salt for the hashing
+% function out of the package version and the passed options recognized by the
+% Lua interface (see Section <#sec:lua-options>).
+% \end{markdown}
+% \begin{macrocode}
+ local output
+ if options.eagerCache or options.finalizeCache then
+ local salt = util.salt(options)
+ local name = util.cache(options.cacheDir, input, salt, convert,
+ ".md.tex")
+ output = [[\input{]] .. name .. [[}\relax]]
+% \end{macrocode}
+% \begin{markdown}
+% Otherwise, return the result of the conversion directly.
+% \end{markdown}
+% \begin{macrocode}
+ else
+ output = convert(input)
+ end
+% \end{macrocode}
+% \begin{markdown}
+% If the \Opt{finalizeCache} option is enabled, populate the frozen cache in
+% the file \Opt{frozenCacheFileName} with an entry for markdown document
+% number \Opt{frozenCacheCounter}.
+% \end{markdown}
+% \begin{macrocode}
+ if options.finalizeCache then
+ local file, mode
+ if options.frozenCacheCounter > 0 then
+ mode = "a"
+ else
+ mode = "w"
+ end
+ file = assert(io.open(options.frozenCacheFileName, mode),
+ [[Could not open file "]] .. options.frozenCacheFileName
+ .. [[" for writing]])
+ assert(file:write(
+ [[\expandafter\global\expandafter\def\csname ]]
+ .. [[markdownFrozenCache]] .. options.frozenCacheCounter
+ .. [[\endcsname{]] .. output .. [[}]] .. "\n"))
+ assert(file:close())
+ end
+ return output
+ end
+end
+% \end{macrocode}
+% \iffalse
+%</lua-loader>
+%<*lua>
+% \fi
+% \par
+% \begin{markdown}
+%
+% The \luamref{new} function from file `markdown-parser.lua` returns a
+% conversion function that takes a markdown string and turns it into a plain
+% \TeX{} output. See Section <#sec:lua-conversion>.
%
% \end{markdown}
% \begin{macrocode}
@@ -32916,7 +34090,15 @@ function M.new(options)
goto miss
end
end
- elseif singletonCache.options[k] ~= options[k] then
+% \end{macrocode}
+% \begin{markdown}
+%
+% The \Opt{cacheDir} option is disregarded.
+%
+% \end{markdown}
+% \begin{macrocode}
+ elseif k ~= "cacheDir"
+ and singletonCache.options[k] ~= options[k] then
goto miss
end
end
@@ -32977,7 +34159,7 @@ function M.new(options)
if options.jekyllData then
local jekyll_data_extension = M.extensions.jekyll_data(
- options.expectJekyllData)
+ options.expectJekyllData, options.ensureJekyllData)
table.insert(extensions, jekyll_data_extension)
end
@@ -33040,7 +34222,8 @@ function M.new(options)
end
if options.citations then
- local citations_extension = M.extensions.citations(options.citationNbsps)
+ local citations_extension
+ = M.extensions.citations(options.citationNbsps)
table.insert(extensions, citations_extension)
end
@@ -33065,7 +34248,9 @@ function M.new(options)
%
% \end{markdown}
% \begin{macrocode}
- local pathname = kpse.lookup(filename)
+ local pathname = assert(kpse.find_file(filename),
+ [[Could not locate user-defined syntax extension "]]
+ .. filename)
local input_file = assert(io.open(pathname, "r"),
[[Could not open user-defined syntax extension "]]
.. pathname .. [[" for reading]])
@@ -33095,7 +34280,8 @@ function M.new(options)
.. type(user_extension.api_version)
.. [[" but "number" was expected]])
assert(user_extension.api_version > 0
- and user_extension.api_version <= metadata.user_extension_api_version,
+ and user_extension.api_version
+ <= metadata.user_extension_api_version,
[[User-defined syntax extension "]] .. pathname
.. [[" uses syntax extension API version "]]
.. user_extension.api_version .. [[ but markdown.lua ]]
@@ -33113,7 +34299,8 @@ function M.new(options)
.. [[" but "number" was expected]])
assert(user_extension.grammar_version == metadata.grammar_version,
[[User-defined syntax extension "]] .. pathname
- .. [[" uses grammar version "]] .. user_extension.grammar_version
+ .. [[" uses grammar version "]]
+ .. user_extension.grammar_version
.. [[ but markdown.lua ]] .. metadata.version
.. [[ uses grammar version ]] .. metadata.grammar_version
.. [[, which is incompatible]])
@@ -33195,11 +34382,16 @@ function M.new(options)
% \begin{macrocode}
return convert
end
-
-return M
% \end{macrocode}
% \iffalse
%</lua>
+%<*lua,lua-loader>
+% \fi
+% \begin{macrocode}
+return M
+% \end{macrocode}
+% \iffalse
+%</lua,lua-loader>
%<*lua-cli>
% \fi
% \par
@@ -33278,7 +34470,7 @@ end
% \end{markdown}
% \begin{macrocode}
if options.cacheDir then
- lfs.rmdir(options["cacheDir"])
+ lfs.rmdir(options.cacheDir)
end
% \end{macrocode}
% \iffalse
@@ -33553,18 +34745,22 @@ end
\def\markdownRendererUlEndTightPrototype{}%
\def\markdownRendererOlBeginPrototype{}%
\def\markdownRendererOlBeginTightPrototype{}%
-\def\markdownRendererFancyOlBeginPrototype#1#2{\markdownRendererOlBegin}%
-\def\markdownRendererFancyOlBeginTightPrototype#1#2{\markdownRendererOlBeginTight}%
+\def\markdownRendererFancyOlBeginPrototype#1#2{%
+ \markdownRendererOlBegin}%
+\def\markdownRendererFancyOlBeginTightPrototype#1#2{%
+ \markdownRendererOlBeginTight}%
\def\markdownRendererOlItemPrototype{}%
\def\markdownRendererOlItemWithNumberPrototype#1{}%
\def\markdownRendererOlItemEndPrototype{}%
\def\markdownRendererFancyOlItemPrototype{\markdownRendererOlItem}%
-\def\markdownRendererFancyOlItemWithNumberPrototype{\markdownRendererOlItemWithNumber}%
+\def\markdownRendererFancyOlItemWithNumberPrototype{%
+ \markdownRendererOlItemWithNumber}%
\def\markdownRendererFancyOlItemEndPrototype{}%
\def\markdownRendererOlEndPrototype{}%
\def\markdownRendererOlEndTightPrototype{}%
\def\markdownRendererFancyOlEndPrototype{\markdownRendererOlEnd}%
-\def\markdownRendererFancyOlEndTightPrototype{\markdownRendererOlEndTight}%
+\def\markdownRendererFancyOlEndTightPrototype{%
+ \markdownRendererOlEndTight}%
\def\markdownRendererDlBeginPrototype{}%
\def\markdownRendererDlBeginTightPrototype{}%
\def\markdownRendererDlItemPrototype#1{#1}%
@@ -33638,6 +34834,28 @@ end
\ExplSyntaxOff
\def\markdownRendererSectionBeginPrototype{}%
\def\markdownRendererSectionEndPrototype{}%
+\ExplSyntaxOn
+\cs_gset:Npn
+ \markdownRendererWarningPrototype
+ #1#2#3#4
+ {
+ \tl_set:Nn
+ \l_tmpa_tl
+ { #2 }
+ \tl_if_empty:nF
+ { #4 }
+ {
+ \tl_put_right:Nn
+ \l_tmpa_tl
+ { \iow_newline: #4 }
+ }
+ \exp_args:NV
+ \markdownWarning
+ \l_tmpa_tl
+ }
+\ExplSyntaxOff
+\def\markdownRendererErrorPrototype#1#2#3#4{%
+ \markdownError{#2}{#4}}%
% \end{macrocode}
% \par
% \begin{markdown}
@@ -33652,7 +34870,7 @@ end
% \begin{macrocode}
\ExplSyntaxOn
\cs_new:Nn
- \@@_plain_tex_default_input_raw_inline_renderer_prototype:nn
+ \@@_plain_tex_default_input_raw_inline:nn
{
\str_case:nn
{ #2 }
@@ -33662,7 +34880,7 @@ end
}
}
\cs_new:Nn
- \@@_plain_tex_default_input_raw_block_renderer_prototype:nn
+ \@@_plain_tex_default_input_raw_block:nn
{
\str_case:nn
{ #2 }
@@ -33674,14 +34892,14 @@ end
\cs_gset:Npn
\markdownRendererInputRawInlinePrototype#1#2
{
- \@@_plain_tex_default_input_raw_inline_renderer_prototype:nn
+ \@@_plain_tex_default_input_raw_inline:nn
{ #1 }
{ #2 }
}
\cs_gset:Npn
\markdownRendererInputRawBlockPrototype#1#2
{
- \@@_plain_tex_default_input_raw_block_renderer_prototype:nn
+ \@@_plain_tex_default_input_raw_block:nn
{ #1 }
{ #2 }
}
@@ -33918,7 +35136,17 @@ end
{ #1 }
{ #2 }
}
-\def\markdownRendererJekyllDataStringPrototype#1#2{
+% \end{macrocode}
+% \par
+% \begin{markdown}
+%
+% We will process all string scalar values assuming that they may contain
+% markdown markup and are intended for typesetting.
+%
+% \end{markdown}
+% \begin{macrocode}
+\def\markdownRendererJekyllDataProgrammaticStringPrototype#1#2{}
+\def\markdownRendererJekyllDataTypographicStringPrototype#1#2{
\markdown_jekyll_data_set_keyvals:nn
{ #1 }
{ #2 }
@@ -34000,7 +35228,7 @@ end
\l_tmpa_tl
\tl_gput_right:Nx
\g_@@_formatted_lua_options_tl
- { #1~=~ \l_tmpa_tl ,~ }
+ { #1~=~ \l_tmpa_tl ,~ }
}
{
\str_if_eq_p:VV
@@ -34017,9 +35245,18 @@ end
\clist_map_inline:Vn
\l_tmpa_tl
{
- \tl_gput_right:Nx
+ \@@_lua_escape:xN
+ { ##1 }
+ \l_tmpb_tl
+ \tl_gput_right:Nn
+ \g_@@_formatted_lua_options_tl
+ { " }
+ \tl_gput_right:NV
\g_@@_formatted_lua_options_tl
- { "##1" ,~ }
+ \l_tmpb_tl
+ \tl_gput_right:Nn
+ \g_@@_formatted_lua_options_tl
+ { " ,~ }
}
\tl_gput_right:Nx
\g_@@_formatted_lua_options_tl
@@ -34030,9 +35267,18 @@ end
\@@_get_option_value:nN
{ #1 }
\l_tmpa_tl
- \tl_gput_right:Nx
+ \@@_lua_escape:xN
+ { \l_tmpa_tl }
+ \l_tmpb_tl
+ \tl_gput_right:Nn
+ \g_@@_formatted_lua_options_tl
+ { #1~=~ " }
+ \tl_gput_right:NV
\g_@@_formatted_lua_options_tl
- { #1~=~ " \l_tmpa_tl " ,~ }
+ \l_tmpb_tl
+ \tl_gput_right:Nn
+ \g_@@_formatted_lua_options_tl
+ { " ,~ }
}
}
\cs_generate_variant:Nn
@@ -34040,7 +35286,61 @@ end
{ Vn }
\let\markdownPrepareLuaOptions=\@@_format_lua_options:
\def\markdownLuaOptions{{ \g_@@_formatted_lua_options_tl }}
-\ExplSyntaxOff
+\sys_if_engine_luatex:TF
+ {
+ \cs_new:Nn
+ \@@_lua_escape:nN
+ {
+ \tl_set:Nx
+ #2
+ {
+ \lua_escape:n
+ { #1 }
+ }
+ }
+ }
+ {
+ \regex_const:Nn
+ \c_@@_lua_escape_regex
+ { [\\"'] }
+ \cs_new:Nn
+ \@@_lua_escape:nN
+ {
+ \tl_set:Nn
+ #2
+ { #1 }
+ \regex_replace_all:NnN
+ \c_@@_lua_escape_regex
+ { \u { c_backslash_str } \0 }
+ #2
+ }
+ }
+\cs_generate_variant:Nn
+ \@@_lua_escape:nN
+ { xN }
+% \end{macrocode}
+% \begin{markdown}
+%
+% After the \mdef{markdownPrepareInputFilename} macro has been
+% fully expanded, the \mdef{markdownInputFilename} macro will
+% expands to a Lua string that contains the input filename passed
+% as the first argument.
+%
+% \end{markdown}
+% \begin{macrocode}
+\tl_new:N
+ \markdownInputFilename
+\cs_new:Npn
+ \markdownPrepareInputFilename
+ #1
+ {
+ \@@_lua_escape:xN
+ { #1 }
+ \markdownInputFilename
+ \tl_gset:Nx
+ \markdownInputFilename
+ { " \markdownInputFilename " }
+ }
% \end{macrocode}
% \par
% \begin{markdown}
@@ -34051,17 +35351,19 @@ end
%
% \end{markdown}
% \begin{macrocode}
-\def\markdownPrepare{%
+\cs_new:Npn
+ \markdownPrepare
+ {
% \end{macrocode}
% \begin{markdown}
% First, ensure that the \Opt{cacheDir} directory exists.
% \end{markdown}
% \begin{macrocode}
- local lfs = require("lfs")
- local cacheDir = "\markdownOptionCacheDir"
- if not lfs.isdir(cacheDir) then
- assert(lfs.mkdir(cacheDir))
- end
+ local~lfs = require("lfs")
+ local~options = \markdownLuaOptions
+ if~not~lfs.isdir(options.cacheDir) then~
+ assert(lfs.mkdir(options.cacheDir))
+ end~
% \end{macrocode}
% \begin{markdown}
% Next, load the `markdown` module and create a converter function using
@@ -34069,9 +35371,30 @@ end
% \mref{markdownLuaOptions} macro.
% \end{markdown}
% \begin{macrocode}
- local md = require("markdown")
- local convert = md.new(\markdownLuaOptions)
-}%
+ local~md = require("markdown")
+ local~convert = md.new(options)
+ }
+% \end{macrocode}
+% \par
+% \begin{markdown}
+%
+% The \mdef{markdownConvert} macro contains the Lua code that is executed
+% during the conversion from markdown to plain \TeX{}. It opens the
+% input file, converts it, and prints the conversion result.
+%
+% \end{markdown}
+% \begin{macrocode}
+\cs_new:Npn
+ \markdownConvert
+ {
+ local~filename = \markdownInputFilename
+ local~file = assert(io.open(filename, "r"),
+ [[Could~not~open~file~"]] .. filename .. [["~for~reading]])
+ local~input = assert(file:read("*a"))
+ assert(file:close())
+ print(convert(input))
+ }
+\ExplSyntaxOff
% \end{macrocode}
% \par
% \begin{markdown}
@@ -34087,7 +35410,9 @@ end
% Remove the `options.cacheDir` directory if it is empty.
% \end{markdown}
% \begin{macrocode}
- lfs.rmdir(cacheDir)
+ if options.cacheDir then
+ lfs.rmdir(options.cacheDir)
+ end
}%
% \end{macrocode}
% \par
@@ -34447,12 +35772,14 @@ end
\msg_new:nnn
{ markdown }
{ buffering-markinline }
- { Buffering~inline~markdown~input~into~the~temporary~input~file~"#1". }
+ { Buffering~inline~markdown~input~into~
+ the~temporary~input~file~"#1". }
\msg_new:nnnn
{ markdown }
{ markinline-peek-failure }
{ Use~of~\iow_char:N \\ markinline~doesn't~match~its~definition }
- { The~macro~should~be~followed~by~inline~markdown~text~in~curly~braces }
+ { The~macro~should~be~followed~by~inline~
+ markdown~text~in~curly~braces }
\ExplSyntaxOff
% \end{macrocode}
% \begin{markdown}
@@ -34471,6 +35798,13 @@ end
\markdownInput
#1
{
+ \@@_if_option:nTF
+ { frozenCache }
+ {
+ \markdownInputRaw
+ { #1 }
+ }
+ {
% \end{macrocode}
% \begin{markdown}
%
@@ -34480,19 +35814,23 @@ end
%
% \end{markdown}
% \begin{macrocode}
- \file_get_full_name:nNTF
- { #1 }
- \l_tmpa_tl
- {
- \exp_args:NV
- \markdownInputRaw
+ \tl_set:Nx
\l_tmpa_tl
- }
- {
- \msg_error:nnnV
- { markdown }
- { markdown-file-does-not-exist }
{ #1 }
+ \file_get_full_name:VNTF
+ \l_tmpa_tl
+ \l_tmpb_tl
+ {
+ \exp_args:NV
+ \markdownInputRaw
+ \l_tmpb_tl
+ }
+ {
+ \msg_error:nnV
+ { markdown }
+ { markdown-file-does-not-exist }
+ \l_tmpa_tl
+ }
}
}
\msg_new:nnn
@@ -34546,7 +35884,8 @@ end
|fi
|markdownInfo{Including markdown document number
"|the|markdownOptionFrozenCacheCounter" from frozen cache}%
- |csname markdownFrozenCache|the|markdownOptionFrozenCacheCounter|endcsname
+ |csname markdownFrozenCache%
+ |the|markdownOptionFrozenCacheCounter|endcsname
|global|advance|markdownOptionFrozenCacheCounter by 1|relax
}{%
|markdownInfo{Including markdown document "&1"}%
@@ -34560,13 +35899,10 @@ end
|openin|markdownInputFileStream&1
|closein|markdownInputFileStream
|markdownPrepareLuaOptions
+ |markdownPrepareInputFilename{&1}%
|markdownLuaExecute{%
|markdownPrepare
- local file = assert(io.open("&1", "r"),
- [[Could not open file "&1" for reading]])
- local input = assert(file:read("*a"))
- assert(file:close())
- print(convert(input))
+ |markdownConvert
|markdownCleanup}%
% \end{macrocode}
% \begin{markdown}
@@ -34770,13 +36106,26 @@ end
% we let the \mref{markdownReadAndConvert} macro process the rest of the
% \LaTeX{} environment.
%
+% We also make provision for using the \mref{markdown} command as a part of a
+% different \LaTeX{} environment as follows:
+%
+% ``` tex
+% \newenvironment{foo}\%
+% {code before \markdown[some, options]}\%
+% {\markdownEnd code after}
+% ```
+%
% \end{markdown}
% \begin{macrocode}
- \c { markdownReadAndConvert@markdown } { }
+ \c { exp_args:NV }
+ \c { markdownReadAndConvert@ }
+ \c { @currenvir }
}
{
\group_end:
- \markdownReadAndConvert@markdown { }
+ \exp_args:NV
+ \markdownReadAndConvert@
+ \@currenvir
}
}
{ \markdownEnd }
@@ -34790,7 +36139,8 @@ end
{ #1 }
\@@_setup:n
{ #1 }
- \markdownReadAndConvert@markdown *
+ \markdownReadAndConvert@
+ { markdown* }
}
{ \markdownEnd }
\msg_new:nnn
@@ -34800,6 +36150,9 @@ end
The~markdown*~LaTeX~environment~has~been~deprecated~and~will~
be~removed~in~the~next~major~version~of~the~Markdown~package.
}
+\cs_generate_variant:Nn
+ \@@_setup:n
+ { V }
\ExplSyntaxOff
\begingroup
% \end{macrocode}
@@ -34813,25 +36166,14 @@ end
% \begin{macrocode}
\catcode`\|=0\catcode`\<=1\catcode`\>=2%
\catcode`\\=12|catcode`|{=12|catcode`|}=12%
- |gdef|markdownReadAndConvert@markdown#1<%
- |markdownReadAndConvert<\end{markdown#1}>%
- <|end<markdown#1>>>%
+ |gdef|markdownReadAndConvert@#1<%
+ |markdownReadAndConvert<\end{#1}>%
+ <|end<#1>>>%
|endgroup
% \end{macrocode}
% \par
% \begin{markdown}
%
-%### Options
-% The supplied package options are processed using the \mref{markdownSetup} macro.
-%
-% \end{markdown}
-% \begin{macrocode}
-\DeclareOption*{%
- \expandafter\markdownSetup\expandafter{\CurrentOption}}%
-\ProcessOptions\relax
-% \end{macrocode}
-% \begin{markdown}
-%
%### Themes {#latex-themes-implementation}
%
% This section overrides the plain \TeX{} implementation of the theme-loading
@@ -34919,9 +36261,8 @@ end
{ #1 }
\AtEndOfPackage
{
- \@@_load_theme:nn
+ \@@_set_theme:n
{ #1 }
- { #2 }
}
\fi
}
@@ -35030,7 +36371,8 @@ end
% \end{markdown}
% \begin{macrocode}
}{%
- \markdown@witiko@dot@oldRendererInputFencedCodePrototype{#1}{#2}{#3}%
+ \markdown@witiko@dot@oldRendererInputFencedCodePrototype
+ {#1}{#2}{#3}%
}%
}%
\next#2 \relax}%
@@ -35194,6 +36536,25 @@ end
% See Section <#sec:latex-token-renderer-prototypes> for the actual
% definitions.
%
+%### Options
+% The supplied package options are processed using the \mref{markdownSetup} macro.
+%
+% \end{markdown}
+% \iffalse
+%</themes-witiko-markdown-defaults-latex>
+%<*latex>
+% \fi
+% \begin{macrocode}
+\DeclareOption*{%
+ \expandafter\markdownSetup\expandafter{\CurrentOption}}%
+\ProcessOptions\relax
+% \end{macrocode}
+% \iffalse
+%</latex>
+%<*themes-witiko-markdown-defaults-latex>
+% \fi
+% \begin{markdown}
+%
%### Token Renderer Prototypes {#latex-token-renderer-prototypes}
%
% The following configuration should be considered placeholder. If the option
@@ -35687,6 +37048,17 @@ end
\catcode`\#=12\relax
}
{
+ \ltx@ifpackageloaded
+ { minted2 }
+ {
+ \catcode`\#=6\relax
+ \exp_args:NV
+ \inputminted
+ \l_tmpa_tl
+ { #1 }
+ \catcode`\#=12\relax
+ }
+ {
% \end{macrocode}
% \par
% \begin{markdown}
@@ -35695,9 +37067,9 @@ end
%
% \end{markdown}
% \begin{macrocode}
- \ltx@ifpackageloaded
- { listings }
- { \lstinputlisting[language=\l_tmpa_tl]{#1} }
+ \ltx@ifpackageloaded
+ { listings }
+ { \lstinputlisting[language=\l_tmpa_tl]{#1} }
% \end{macrocode}
% \par
% \begin{markdown}
@@ -35707,7 +37079,8 @@ end
%
% \end{markdown}
% \begin{macrocode}
- { \markdownRendererInputFencedCode{#1}{}{} }
+ { \markdownRendererInputFencedCode{#1}{}{} }
+ }
}
}
}
@@ -35846,8 +37219,9 @@ end
\advance\markdownLaTeXCitationsCounter by 1\relax
\ifx\relax#4\relax
\ifx\relax#5\relax
- \ifnum\markdownLaTeXCitationsCounter>\markdownLaTeXCitationsTotal\relax
- \cite{#1#2#6}% Without prenotes and postnotes, just accumulate cites
+ \ifnum\markdownLaTeXCitationsCounter>\markdownLaTeXCitationsTotal
+ \relax
+ \cite{#1#2#6}% No prenotes/postnotes, just accumulate cites
\expandafter\expandafter\expandafter
\expandafter\expandafter\expandafter\expandafter
\@gobblethree
@@ -35857,7 +37231,8 @@ end
\cite{#1}%
\fi
\cite[#5]{#6}%
- \ifnum\markdownLaTeXCitationsCounter>\markdownLaTeXCitationsTotal\relax
+ \ifnum\markdownLaTeXCitationsCounter>\markdownLaTeXCitationsTotal
+ \relax
\else
\expandafter\expandafter\expandafter
\expandafter\expandafter\expandafter\expandafter
@@ -35884,7 +37259,8 @@ end
\space % Insert a space before the prenote in later citations
\fi
#4~\expandafter\cite\ifx\relax#5\relax{#6}\else[#5]{#6}\fi
- \ifnum\markdownLaTeXCitationsCounter>\markdownLaTeXCitationsTotal\relax
+ \ifnum\markdownLaTeXCitationsCounter>\markdownLaTeXCitationsTotal
+ \relax
\else
\expandafter\expandafter\expandafter
\expandafter\expandafter\expandafter\expandafter
@@ -35904,8 +37280,9 @@ end
\advance\markdownLaTeXCitationsCounter by 1\relax
\ifx\relax#3\relax
\ifx\relax#4\relax
- \ifnum\markdownLaTeXCitationsCounter>\markdownLaTeXCitationsTotal\relax
- \citep{#1,#5}% Without prenotes and postnotes, just accumulate cites
+ \ifnum\markdownLaTeXCitationsCounter>\markdownLaTeXCitationsTotal
+ \relax
+ \citep{#1,#5}% No prenotes/postnotes, just accumulate cites
\expandafter\expandafter\expandafter
\expandafter\expandafter\expandafter\expandafter
\@gobbletwo
@@ -35915,7 +37292,8 @@ end
\citep{#1}%
\fi
\citep[][#4]{#5}%
- \ifnum\markdownLaTeXCitationsCounter>\markdownLaTeXCitationsTotal\relax
+ \ifnum\markdownLaTeXCitationsCounter>\markdownLaTeXCitationsTotal
+ \relax
\else
\expandafter\expandafter\expandafter
\expandafter\expandafter\expandafter\expandafter
@@ -35935,7 +37313,8 @@ end
\citep{#1}%
\fi
\citep[#3][#4]{#5}%
- \ifnum\markdownLaTeXCitationsCounter>\markdownLaTeXCitationsTotal\relax
+ \ifnum\markdownLaTeXCitationsCounter>\markdownLaTeXCitationsTotal
+ \relax
\else
\expandafter\expandafter\expandafter
\expandafter\expandafter\expandafter\expandafter
@@ -35950,8 +37329,9 @@ end
\advance\markdownLaTeXCitationsCounter by 1\relax
\ifx\relax#3\relax
\ifx\relax#4\relax
- \ifnum\markdownLaTeXCitationsCounter>\markdownLaTeXCitationsTotal\relax
- \citet{#1,#5}% Without prenotes and postnotes, just accumulate cites
+ \ifnum\markdownLaTeXCitationsCounter>\markdownLaTeXCitationsTotal
+ \relax
+ \citet{#1,#5}% No prenotes/postnotes, just accumulate cites
\expandafter\expandafter\expandafter
\expandafter\expandafter\expandafter\expandafter
\@gobbletwo
@@ -35961,10 +37341,13 @@ end
\citet{#1}%
\fi
, \citet[#3][#4]{#5}%
- \ifnum\markdownLaTeXCitationsCounter<\markdownLaTeXCitationsTotal\relax
+ \ifnum\markdownLaTeXCitationsCounter<\markdownLaTeXCitationsTotal
+ \relax
,
\else
- \ifnum\markdownLaTeXCitationsCounter=\markdownLaTeXCitationsTotal\relax
+ \ifnum
+ \markdownLaTeXCitationsCounter=\markdownLaTeXCitationsTotal
+ \relax
,
\fi
\fi
@@ -35983,10 +37366,13 @@ end
\citet{#1}%
\fi
, \citet[#3][#4]{#5}%
- \ifnum\markdownLaTeXCitationsCounter<\markdownLaTeXCitationsTotal\relax
+ \ifnum\markdownLaTeXCitationsCounter<\markdownLaTeXCitationsTotal
+ \relax
,
\else
- \ifnum\markdownLaTeXCitationsCounter=\markdownLaTeXCitationsTotal\relax
+ \ifnum
+ \markdownLaTeXCitationsCounter=\markdownLaTeXCitationsTotal
+ \relax
,
\fi
\fi
@@ -36001,13 +37387,15 @@ end
% BibLaTeX implementation
\def\markdownLaTeXBibLaTeXCitations#1#2#3#4#5{%
\advance\markdownLaTeXCitationsCounter by 1\relax
- \ifnum\markdownLaTeXCitationsCounter>\markdownLaTeXCitationsTotal\relax
+ \ifnum\markdownLaTeXCitationsCounter>\markdownLaTeXCitationsTotal
+ \relax
\autocites#1[#3][#4]{#5}%
\expandafter\@gobbletwo
\fi\markdownLaTeXBibLaTeXCitations{#1[#3][#4]{#5}}}
\def\markdownLaTeXBibLaTeXTextCitations#1#2#3#4#5{%
\advance\markdownLaTeXCitationsCounter by 1\relax
- \ifnum\markdownLaTeXCitationsCounter>\markdownLaTeXCitationsTotal\relax
+ \ifnum\markdownLaTeXCitationsCounter>\markdownLaTeXCitationsTotal
+ \relax
\textcites#1[#3][#4]{#5}%
\expandafter\@gobbletwo
\fi\markdownLaTeXBibLaTeXTextCitations{#1[#3][#4]{#5}}}
@@ -36100,7 +37488,8 @@ end
{
\markdownLaTeXRendererAutolink { #2 } { #3 }
}{
- \markdownLaTeXRendererDirectOrIndirectLink { #1 } { #2 } { #3 } { #4 }
+ \markdownLaTeXRendererDirectOrIndirectLink
+ { #1 } { #2 } { #3 } { #4 }
}
}
\def\markdownLaTeXRendererAutolink#1#2{%
@@ -36399,13 +37788,13 @@ end
{
{ latex }
{
- \@@_plain_tex_default_input_raw_inline_renderer_prototype:nn
+ \@@_plain_tex_default_input_raw_inline:nn
{ #1 }
{ tex }
}
}
{
- \@@_plain_tex_default_input_raw_inline_renderer_prototype:nn
+ \@@_plain_tex_default_input_raw_inline:nn
{ #1 }
{ #2 }
}
@@ -36418,13 +37807,13 @@ end
{
{ latex }
{
- \@@_plain_tex_default_input_raw_block_renderer_prototype:nn
+ \@@_plain_tex_default_input_raw_block:nn
{ #1 }
{ tex }
}
}
{
- \@@_plain_tex_default_input_raw_block_renderer_prototype:nn
+ \@@_plain_tex_default_input_raw_block:nn
{ #1 }
{ #2 }
}
@@ -36607,7 +37996,7 @@ end
% \end{macrocode}
% \iffalse
%</context>
-%<*themes-witiko-markdown-defaults-context>
+%<*themes-witiko-markdown-defaults-ctx>
% \fi
% \par
% \begin{markdown}
@@ -36789,7 +38178,8 @@ end
\def\markdownRendererStrikeThroughPrototype#1{\overstrikes{#1}}
\def\markdownRendererSuperscriptPrototype#1{\high{#1}}
\def\markdownRendererSubscriptPrototype#1{\low{#1}}
-\def\markdownRendererDisplayMathPrototype#1{\startformula#1\stopformula}%
+\def\markdownRendererDisplayMathPrototype#1{%
+ \startformula#1\stopformula}%
% \end{macrocode}
% \par
% \begin{markdown}
@@ -36815,8 +38205,10 @@ end
\placetable{#1}{\the\markdownConTeXtTable}}%
\fi
\begingroup
- \setupTABLE[r][each][topframe=off, bottomframe=off, leftframe=off, rightframe=off]
- \setupTABLE[c][each][topframe=off, bottomframe=off, leftframe=off, rightframe=off]
+ \setupTABLE[r][each][topframe=off, bottomframe=off,
+ leftframe=off, rightframe=off]
+ \setupTABLE[c][each][topframe=off, bottomframe=off,
+ leftframe=off, rightframe=off]
\setupTABLE[r][1][topframe=on, bottomframe=on]
\setupTABLE[r][#1][bottomframe=on]
\markdownConTeXtRowCounter=0%
@@ -36854,14 +38246,16 @@ end
\fi\if#1r%
\setupTABLE[c][\the\markdownConTeXtColumnCounter][align=left]
\fi
- \ifnum\markdownConTeXtColumnCounter<\markdownConTeXtColumnTotal\relax\else
+ \ifnum\markdownConTeXtColumnCounter<\markdownConTeXtColumnTotal\relax
+ \else
\expandafter\gobbleoneargument
\fi\markdownConTeXtReadAlignments}
\def\markdownConTeXtRenderTableCell#1{%
\advance\markdownConTeXtColumnCounter by 1\relax
\markdownConTeXtTable=\expandafter{%
\the\markdownConTeXtTable\bTD#1\eTD}%
- \ifnum\markdownConTeXtColumnCounter<\markdownConTeXtColumnTotal\relax\else
+ \ifnum\markdownConTeXtColumnCounter<\markdownConTeXtColumnTotal\relax
+ \else
\expandafter\gobbleoneargument
\fi\markdownConTeXtRenderTableCell}
% \end{macrocode}
@@ -36884,13 +38278,13 @@ end
{
{ latex }
{
- \@@_plain_tex_default_input_raw_inline_renderer_prototype:nn
+ \@@_plain_tex_default_input_raw_inline:nn
{ #1 }
{ context }
}
}
{
- \@@_plain_tex_default_input_raw_inline_renderer_prototype:nn
+ \@@_plain_tex_default_input_raw_inline:nn
{ #1 }
{ #2 }
}
@@ -36903,13 +38297,13 @@ end
{
{ context }
{
- \@@_plain_tex_default_input_raw_block_renderer_prototype:nn
+ \@@_plain_tex_default_input_raw_block:nn
{ #1 }
{ tex }
}
}
{
- \@@_plain_tex_default_input_raw_block_renderer_prototype:nn
+ \@@_plain_tex_default_input_raw_block:nn
{ #1 }
{ #2 }
}
@@ -36923,7 +38317,7 @@ end
\protect
% \end{macrocode}
% \iffalse
-%</themes-witiko-markdown-defaults-context>
+%</themes-witiko-markdown-defaults-ctx>
%<*context>
% \fi
% \par
diff --git a/macros/generic/markdown/markdown.html b/macros/generic/markdown/markdown.html
index 81e62b2044..ba2a2d34f5 100644
--- a/macros/generic/markdown/markdown.html
+++ b/macros/generic/markdown/markdown.html
@@ -93,7 +93,7 @@
<header id="title-block-header">
<h1 class="title">Markdown Package User Manual</h1>
<p class="author">Vít Starý Novotný, Andrej Genčur</p>
-<p class="date">3.6.2-0-g6c30af7e 2024-07-14</p>
+<p class="date">3.7.1-0-g8e726800 2024-09-30</p>
</header>
<nav id="TOC" role="doc-toc">
<ul>
@@ -227,10 +227,10 @@ class="tex">T<sub>e</sub>X</span> distribution, you will need to install
it.</p>
<p>From <a href="https://github.com/witiko/markdown/releases"
title="Releases - witiko/markdown">Releases</a>, download <a
-href="https://github.com/witiko/markdown/releases/download/3.6.2/markdown.zip"
-title="Release 3.6.2 - witiko/markdown">an archive
+href="https://github.com/witiko/markdown/releases/download/3.7.1/markdown.zip"
+title="Release 3.7.1 - witiko/markdown">an archive
<code>markdown.zip</code> for this version of the Markdown package
-(3.6.2)</a> or a different version that you wish to install. Then, unzip
+(3.7.1)</a> or a different version that you wish to install. Then, unzip
the archive. If you downloaded an archive for a different version of the
Markdown package, you should now locate a file named
<code>markdown.html</code> with the user manual for that version, open
@@ -245,7 +245,8 @@ enter the directory named <code>markdown</code> and run the
<p>Either of the two abovelisted approaches should produce the following
files:</p>
<ul>
-<li><code>markdown.lua</code>: The Lua module</li>
+<li><code>markdown.lua</code>, <code>markdown-parser.lua</code>, and
+<code>markdown-unicode-data.lua</code>: The Lua module</li>
<li><code>libraries/markdown-tinyyaml.lua</code>: An external library
for reading <abbr>yaml</abbr></li>
<li><code>markdown-cli.lua</code>: The Lua command-line interface</li>
@@ -275,6 +276,8 @@ class="header-section-number">1.2.1</span> Local Installation</h3>
generally where the individual files should be placed:</p>
<ul>
<li><code>⟨TEXMF⟩/tex/luatex/markdown/markdown.lua</code></li>
+<li><code>⟨TEXMF⟩/tex/luatex/markdown/markdown-parser.lua</code></li>
+<li><code>⟨TEXMF⟩/tex/luatex/markdown/markdown-unicode-data.lua</code></li>
<li><code>⟨TEXMF⟩/tex/luatex/markdown/markdown-tinyyaml.lua</code></li>
<li><code>⟨TEXMF⟩/scripts/markdown/markdown-cli.lua</code></li>
<li><code>⟨TEXMF⟩/tex/generic/markdown/markdown.tex</code></li>
@@ -302,6 +305,8 @@ them together. This way your document can be portably typeset on legacy
<p>This is where the individual files should be placed:</p>
<ul>
<li><code>./markdown.lua</code></li>
+<li><code>./markdown-parser.lua</code></li>
+<li><code>./markdown-unicode-data.lua</code></li>
<li><code>./markdown-tinyyaml.lua</code></li>
<li><code>./markdown-cli.lua</code></li>
<li><code>./markdown/markdown.tex</code></li>
@@ -770,8 +775,8 @@ accepts the same options as the plain <span
class="tex">T<sub>e</sub>X</span> interface, but now the options are
specified as ⟨<em>key</em>⟩<span
class="math inline"> = </span>⟨<em>value</em>⟩ pairs and they are passed
-either as package options, in the <code>\markdownSetup</code> command,
-or as parameters for the <code>markdown*</code> <span
+either as package options, in the <code>markdownSetup</code> command, or
+as parameters for the <code>markdown*</code> <span
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> environment.</p>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
@@ -858,19 +863,22 @@ class="tex">T<sub>e</sub>X</span>t interfaces.</p>
class="header-section-number">2.2.1.1</span> Option
<code>eagerCache</code></h4>
<dl>
-<dt><code>eagerCache</code> (default value: <code>false</code>)</dt>
+<dt><code>eagerCache</code> (default value: <code>true</code>)</dt>
<dd>
<dl>
<dt>true</dt>
<dd>
<p>Converted markdown documents will be cached in
-<strong><code>cacheDir</code></strong>. This can be useful for
+<code><strong>cacheDir</strong></code>. This can be useful for
post-processing the converted documents and for recovering historical
-versions of the documents from the cache. However, it also produces a
-large number of auxiliary files on the disk and obscures the output of
-the Lua command-line interface when it is used for plumbing.</p>
+versions of the documents from the cache. Furthermore, it can also
+significantly improve the processing speed for documents that require
+multiple compilation runs, since each markdown document is only
+converted once. However, it also produces a large number of auxiliary
+files on the disk and obscures the output of the Lua command-line
+interface when it is used for plumbing.</p>
<p>This behavior will always be used if the
-<strong><code>finalizeCache</code></strong> option is enabled.</p>
+<code><strong>finalizeCache</strong></code> option is enabled.</p>
</dd>
</dl>
</dd>
@@ -880,9 +888,14 @@ the Lua command-line interface when it is used for plumbing.</p>
<dd>
<p>Converted markdown documents will not be cached. This decreases the
number of auxiliary files that we produce and makes it easier to use the
-Lua command-line interface for plumbing.</p>
+Lua command-line interface for plumbing. However, it makes it impossible
+to post-process the converted documents and recover historical versions
+of the documents from the cache. Furthermore, it can significantly
+reduce the processing speed for documents that require multiple
+compilation runs, since each markdown document is converted multiple
+times needlessly.</p>
<p>This behavior will only be used when the
-<strong><code>finalizeCache</code></strong> option is disabled.</p>
+<code><strong>finalizeCache</strong></code> option is disabled.</p>
</dd>
</dl>
</dd>
@@ -893,7 +906,7 @@ Lua command-line interface for plumbing.</p>
<div class="sourceCode" id="cb46"><pre
class="sourceCode md"><code class="sourceCode markdown"><span id="cb46-1"><a href="#cb46-1" aria-hidden="true" tabindex="-1"></a>Hello *world*!</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal with the
-<strong><code>eagerCache</code></strong> option disabled:</p>
+<code><strong>eagerCache</strong></code> option disabled:</p>
<div class="sourceCode" id="cb47"><pre
class="sourceCode sh"><code class="sourceCode bash"><span id="cb47-1"><a href="#cb47-1" aria-hidden="true" tabindex="-1"></a><span class="ex">texlua</span> ⟨CLI pathname⟩ eagerCache=false <span class="at">--</span> hello.md hello.tex</span></code></pre></div>
<p>where ⟨<em>CLI pathname</em>⟩ corresponds to the location of the Lua
@@ -912,7 +925,7 @@ code:</p>
class="sourceCode tex"><code class="sourceCode latex"><span id="cb48-1"><a href="#cb48-1" aria-hidden="true" tabindex="-1"></a>Hello <span class="fu">\markdownRendererEmphasis</span>{world}!<span class="fu">\relax</span></span></code></pre></div>
<hr />
<p>Invoke LuaTeX from the terminal again, this time with the
-<strong><code>eagerCache</code></strong> option enabled:</p>
+<code><strong>eagerCache</strong></code> option enabled:</p>
<div class="sourceCode" id="cb49"><pre
class="sourceCode tex"><code class="sourceCode latex"><span id="cb49-1"><a href="#cb49-1" aria-hidden="true" tabindex="-1"></a>texlua ⟨CLI pathname⟩ eagerCache=true -- hello.md hello.tex</span></code></pre></div>
<p>A <span class="tex">T<sub>e</sub>X</span> document named
@@ -935,7 +948,7 @@ class="header-section-number">2.2.1.2</span> Option
<dt>true</dt>
<dd>
<p>Conversion functions produced by the function
-\luamref{new}<code>(options)</code> will be cached in an LRU cache of
+<code>new</code><code>(options)</code> will be cached in an LRU cache of
size 1 keyed by <code>options</code>. This is more time- and
space-efficient than always producing a new conversion function but may
expose bugs related to the idempotence of conversion functions.</p>
@@ -948,11 +961,12 @@ Markdown package.</p>
<dl>
<dt>false</dt>
<dd>
-<p>Every call to the function \luamref{new}<code>(options)</code> will
-produce a new conversion function that will not be cached. This is
+<p>Every call to the function <code>new</code><code>(options)</code>
+will produce a new conversion function that will not be cached. This is
slower than caching conversion functions and may expose bugs related to
-memory leaks in the creation of conversion functions, see also issue <a
-href="https://github.com/witiko/markdown/pull/226#issuecomment-1599641634">#226</a>.</p>
+memory leaks in the creation of conversion functions, see also <a
+href="https://github.com/witiko/markdown/pull/226#issuecomment-1599641634">#226
+(comment)</a>.</p>
<p>This was the default behavior until version 3.0.0 of the Markdown
package.</p>
</dd>
@@ -1003,7 +1017,7 @@ class="header-section-number">2.2.1.3</span> Option
href="https://unicode.org/faq/normalization.html">Unicode normalization
forms</a> before conversion. The Unicode normalization norm used is
determined by option
-<strong><code>unicodeNormalizationForm</code></strong>.</p>
+<code><strong>unicodeNormalizationForm</strong></code>.</p>
</dd>
</dl>
</dd>
@@ -1027,7 +1041,7 @@ class="header-section-number">2.2.1.4</span> Option
<dl>
<dt>nfc</dt>
<dd>
-<p>When option <strong><code>unicodeNormalization</code></strong> has
+<p>When option <code><strong>unicodeNormalization</strong></code> has
been enabled, markdown documents will be normalized using Unicode
Normalization Form C (NFC) before conversion.</p>
</dd>
@@ -1037,7 +1051,7 @@ Normalization Form C (NFC) before conversion.</p>
<dl>
<dt>nfd</dt>
<dd>
-<p>When option <strong><code>unicodeNormalization</code></strong> has
+<p>When option <code><strong>unicodeNormalization</strong></code> has
been enabled, markdown documents will be normalized using Unicode
Normalization Form D (NFD) before conversion.</p>
</dd>
@@ -1047,7 +1061,7 @@ Normalization Form D (NFD) before conversion.</p>
<dl>
<dt>nfkc</dt>
<dd>
-<p>When option <strong><code>unicodeNormalization</code></strong> has
+<p>When option <code><strong>unicodeNormalization</strong></code> has
been enabled, markdown documents will be normalized using Unicode
Normalization Form KC (NFKC) before conversion.</p>
</dd>
@@ -1057,7 +1071,7 @@ Normalization Form KC (NFKC) before conversion.</p>
<dl>
<dt>nfkd</dt>
<dd>
-<p>When option <strong><code>unicodeNormalization</code></strong> has
+<p>When option <code><strong>unicodeNormalization</strong></code> has
been enabled, markdown documents will be normalized using Unicode
Normalization Form KD (NFKD) before conversion.</p>
</dd>
@@ -1206,7 +1220,7 @@ class="header-section-number">2.2.1.6</span> Option
<dd>
<p>The filename of the <abbr>JSON</abbr> file that maps filename
extensions to programming language names in the iA Writer content blocks
-when the <strong><code>contentBlocks</code></strong> option is
+when the <code><strong>contentBlocks</strong></code> option is
enabled.</p>
</dd>
</dl>
@@ -1370,13 +1384,13 @@ class="header-section-number">2.2.1.7</span> Option
<code>"debug-extensions.json"</code>)</dt>
<dd>
<p>The filename of the <abbr>JSON</abbr> file that will be produced when
-the <strong><code>debugExtensions</code></strong> option is enabled.
+the <code><strong>debugExtensions</strong></code> option is enabled.
This file will contain the extensible subset of the <abbr>peg</abbr>
grammar of markdown after built-in syntax extensions (see options
-<strong><code>citations</code></strong>,
-<strong><code>contentBlocks</code></strong>,
-<strong><code>definitionLists</code></strong>, etc.) and user-defined
-syntax extensions (see option <strong><code>extensions</code></strong>)
+<code><strong>citations</strong></code>,
+<code><strong>contentBlocks</strong></code>,
+<code><strong>definitionLists</strong></code>, etc.) and user-defined
+syntax extensions (see option <code><strong>extensions</strong></code>)
have been applied.</p>
</dd>
</dl>
@@ -1388,13 +1402,13 @@ class="header-section-number">2.2.1.8</span> Option
<code>"frozenCache.tex"</code>)</dt>
<dd>
<p>A path to an output file (frozen cache) that will be created when the
-<strong><code>finalizeCache</code></strong> option is enabled and will
+<code><strong>finalizeCache</strong></code> option is enabled and will
contain a mapping between an enumeration of markdown documents and their
auxiliary cache files.</p>
<p>The frozen cache makes it possible to later typeset a plain <span
class="tex">T<sub>e</sub>X</span> document that contains markdown
documents without invoking Lua using the
-<strong><code>frozenCache</code></strong> plain <span
+<code><strong>frozenCache</strong></code> plain <span
class="tex">T<sub>e</sub>X</span> option. As a result, the plain <span
class="tex">T<sub>e</sub>X</span> document becomes more portable, but
further changes in the order and the content of markdown documents will
@@ -1611,7 +1625,7 @@ class="sourceCode md"><code class="sourceCode markdown"><span id="cb96-1"><a hre
</dd>
</dl>
<p>See also the option
-<strong><code>gfmAutoIdentifiers</code></strong>.</p>
+<code><strong>gfmAutoIdentifiers</strong></code>.</p>
<h4 data-number="2.2.1.10" id="option-blankbeforeblockquote"><span
class="header-section-number">2.2.1.10</span> Option
<code>blankBeforeBlockquote</code></h4>
@@ -3385,13 +3399,13 @@ class="header-section-number">2.2.1.22</span> Option
<dd>
<p>Produce a <abbr>JSON</abbr> file that will contain the extensible
subset of the <abbr>peg</abbr> grammar of markdown after built-in syntax
-extensions (see options <strong><code>citations</code></strong>,
-<strong><code>contentBlocks</code></strong>,
-<strong><code>definitionLists</code></strong>, etc.) and user-defined
-syntax extensions (see option <strong><code>extensions</code></strong>)
+extensions (see options <code><strong>citations</strong></code>,
+<code><strong>contentBlocks</strong></code>,
+<code><strong>definitionLists</strong></code>, etc.) and user-defined
+syntax extensions (see option <code><strong>extensions</strong></code>)
have been applied. This helps you to see how the different extensions
interact. The name of the produced <abbr>JSON</abbr> file is controlled
-by the <strong><code>debugExtensionsFileName</code></strong> option.</p>
+by the <code><strong>debugExtensionsFileName</strong></code> option.</p>
</dd>
</dl>
</dd>
@@ -3613,8 +3627,39 @@ contain the following text:</p>
</dd>
</dl>
</blockquote>
-<h4 data-number="2.2.1.24" id="option-expectjekylldata"><span
+<h4 data-number="2.2.1.24" id="option-ensurejekylldata"><span
class="header-section-number">2.2.1.24</span> Option
+<code>ensureJekyllData</code></h4>
+<dl>
+<dt><code>ensureJekyllData</code> (default value:
+<code>false</code>)</dt>
+<dd>
+<dl>
+<dt>false</dt>
+<dd>
+<p>When the <code><strong>jekyllData</strong></code> and
+<code><strong>expectJekyllData</strong></code> options are enabled, then
+a markdown document may begin directly with <abbr>yaml</abbr> metadata
+and may contain nothing but <abbr>yaml</abbr> metadata. Otherwise, the
+markdown document is processed as markdown text.</p>
+</dd>
+</dl>
+</dd>
+<dd>
+<dl>
+<dt>true</dt>
+<dd>
+<p>When the <code><strong>jekyllData</strong></code> and
+<code><strong>expectJekyllData</strong></code> options are enabled, then
+a markdown document must begin directly with <abbr>yaml</abbr> metadata
+and must contain nothing but <abbr>yaml</abbr> metadata. Otherwise, an
+error is produced.</p>
+</dd>
+</dl>
+</dd>
+</dl>
+<h4 data-number="2.2.1.25" id="option-expectjekylldata"><span
+class="header-section-number">2.2.1.25</span> Option
<code>expectJekyllData</code></h4>
<dl>
<dt><code>expectJekyllData</code> (default value:
@@ -3623,7 +3668,7 @@ class="header-section-number">2.2.1.24</span> Option
<dl>
<dt>false</dt>
<dd>
-<p>When the <strong><code>jekyllData</code></strong> option is enabled,
+<p>When the <code><strong>jekyllData</strong></code> option is enabled,
then a markdown document may begin with <abbr>yaml</abbr> metadata if
and only if the metadata begin with the end-of-directives marker
(<code>---</code>) and they end with either the end-of-directives or the
@@ -3655,7 +3700,7 @@ class="sourceCode latex"><code class="sourceCode latex"><span id="cb216-1"><a hr
<dl>
<dt>true</dt>
<dd>
-<p>When the <strong><code>jekyllData</code></strong> option is enabled,
+<p>When the <code><strong>jekyllData</strong></code> option is enabled,
then a markdown document may begin directly with <abbr>yaml</abbr>
metadata and may contain nothing but <abbr>yaml</abbr> metadata.</p>
<div class="sourceCode" id="cb217"><pre
@@ -3713,14 +3758,14 @@ contain the following text:</p>
<blockquote>
<p>Jane Doe is 99 years old.</p>
</blockquote>
-<h4 data-number="2.2.1.25" id="option-extensions"><span
-class="header-section-number">2.2.1.25</span> Option
+<h4 data-number="2.2.1.26" id="option-extensions"><span
+class="header-section-number">2.2.1.26</span> Option
<code>extensions</code></h4>
<dl>
<dt><code>extensions</code> (default value: <code>{}</code>)</dt>
<dd>
<p>The filenames of user-defined syntax extensions that will be applied
-to the markdown reader. If the <strong><code>kpathsea</code></strong>
+to the markdown reader. If the <code><strong>kpathsea</strong></code>
library is available, files will be searched for not only in the current
working directory but also in the <span
class="tex">T<sub>e</sub>X</span> directory structure.</p>
@@ -3773,8 +3818,8 @@ contain the following text:</p>
<blockquote>
<p>This is <del>a lunar roving vehicle</del> strike-through text.</p>
</blockquote>
-<h4 data-number="2.2.1.26" id="option-fancylists"><span
-class="header-section-number">2.2.1.26</span> Option
+<h4 data-number="2.2.1.27" id="option-fancylists"><span
+class="header-section-number">2.2.1.27</span> Option
<code>fancyLists</code></h4>
<dl>
<dt><code>fancyLists</code> (default value: <code>false</code>)</dt>
@@ -3854,8 +3899,8 @@ contain the following text:</p>
<li>third item</li>
</ol>
</blockquote>
-<h4 data-number="2.2.1.27" id="option-fencedcode"><span
-class="header-section-number">2.2.1.27</span> Option
+<h4 data-number="2.2.1.28" id="option-fencedcode"><span
+class="header-section-number">2.2.1.28</span> Option
<code>fencedCode</code></h4>
<dl>
<dt><code>fencedCode</code> (default value: <code>true</code>)</dt>
@@ -3990,8 +4035,8 @@ class="sourceCode html"><code class="sourceCode html"><span id="cb237-1"><a href
<span id="cb237-7"><a href="#cb237-7" aria-hidden="true" tabindex="-1"></a> <span class="dt">&lt;/</span><span class="kw">code</span><span class="dt">&gt;</span></span>
<span id="cb237-8"><a href="#cb237-8" aria-hidden="true" tabindex="-1"></a><span class="dt">&lt;/</span><span class="kw">pre</span><span class="dt">&gt;</span></span></code></pre></div>
</blockquote>
-<h4 data-number="2.2.1.28" id="option-fencedcodeattributes"><span
-class="header-section-number">2.2.1.28</span> Option
+<h4 data-number="2.2.1.29" id="option-fencedcodeattributes"><span
+class="header-section-number">2.2.1.29</span> Option
<code>fencedCodeAttributes</code></h4>
<dl>
<dt><code>fencedCodeAttributes</code> (default value:
@@ -4067,8 +4112,8 @@ class="sourceCode js linenos"><code class="sourceCode javascript"><span id="cb24
<span id="cb241-2"><a href="#cb241-2" aria-hidden="true" tabindex="-1"></a><span class="fl">2.</span> <span class="fu">moveShip</span>(<span class="dv">5</span> <span class="op">*</span> gravity<span class="op">,</span> DOWN)<span class="op">;</span></span>
<span id="cb241-3"><a href="#cb241-3" aria-hidden="true" tabindex="-1"></a><span class="fl">3.</span> }</span></code></pre></div>
</blockquote>
-<h4 data-number="2.2.1.29" id="fenced-divs"><span
-class="header-section-number">2.2.1.29</span> Option
+<h4 data-number="2.2.1.30" id="fenced-divs"><span
+class="header-section-number">2.2.1.30</span> Option
<code>fencedDivs</code></h4>
<dl>
<dt><code>fencedDivs</code> (default value: <code>false</code>)</dt>
@@ -4123,20 +4168,20 @@ contain the following text:</p>
<blockquote>
<p>Here is a special paragraph.</p>
</blockquote>
-<h4 data-number="2.2.1.30" id="option-finalizecache"><span
-class="header-section-number">2.2.1.30</span> Option
+<h4 data-number="2.2.1.31" id="option-finalizecache"><span
+class="header-section-number">2.2.1.31</span> Option
<code>finalizeCache</code></h4>
<dl>
<dt><code>finalizeCache</code> (default value: <code>false</code>)</dt>
<dd>
<p>Whether an output file specified with the
-<strong><code>frozenCacheFileName</code></strong> option (frozen cache)
+<code><strong>frozenCacheFileName</strong></code> option (frozen cache)
that contains a mapping between an enumeration of markdown documents and
their auxiliary cache files will be created.</p>
<p>The frozen cache makes it possible to later typeset a plain <span
class="tex">T<sub>e</sub>X</span> document that contains markdown
documents without invoking Lua using the
-<strong><code>frozenCache</code></strong> plain <span
+<code><strong>frozenCache</strong></code> plain <span
class="tex">T<sub>e</sub>X</span> option. As a result, the plain <span
class="tex">T<sub>e</sub>X</span> document becomes more portable, but
further changes in the order and the content of markdown documents will
@@ -4255,15 +4300,15 @@ contents of the frozen cache using the
the document without accessing the shell or invoking Lua, but the change
in the content of the markdown document from “Hello <em>world</em>!” to
“Hi <em>world</em>!” was not reflected.</p>
-<h4 data-number="2.2.1.31" id="option-frozencachecounter"><span
-class="header-section-number">2.2.1.31</span> Option
+<h4 data-number="2.2.1.32" id="option-frozencachecounter"><span
+class="header-section-number">2.2.1.32</span> Option
<code>frozenCacheCounter</code></h4>
<dl>
<dt><code>frozenCacheCounter</code> (default value: <code>0</code>)</dt>
<dd>
<p>The number of the current markdown document that will be stored in an
output file (frozen cache) when the
-<strong><code>finalizeCache</code></strong> is enabled. When the
+<code><strong>finalizeCache</strong></code> is enabled. When the
document number is 0, then a new frozen cache will be created.
Otherwise, the frozen cache will be appended.</p>
<p>Each frozen cache entry will define a <span
@@ -4296,8 +4341,8 @@ class="sourceCode sh"><code class="sourceCode bash"><span id="cb258-1"><a href="
contain the text “Hello <em>world</em>!” A frozen cache with two entries
will also be produced as we requested using the
<code>frozenCacheCounter</code> option.</p>
-<h4 data-number="2.2.1.32" id="option-gfmautoidentifiers"><span
-class="header-section-number">2.2.1.32</span> Option
+<h4 data-number="2.2.1.33" id="option-gfmautoidentifiers"><span
+class="header-section-number">2.2.1.33</span> Option
<code>gfmAutoIdentifiers</code></h4>
<dl>
<dt><code>gfmAutoIdentifiers</code> (default value:
@@ -4323,9 +4368,9 @@ extension.</p>
</dd>
</dl>
<p>See also the option
-<strong><code>autoIdentifiers</code></strong>.</p>
-<h4 data-number="2.2.1.33" id="option-hashenumerators"><span
-class="header-section-number">2.2.1.33</span> Option
+<code><strong>autoIdentifiers</strong></code>.</p>
+<h4 data-number="2.2.1.34" id="option-hashenumerators"><span
+class="header-section-number">2.2.1.34</span> Option
<code>hashEnumerators</code></h4>
<dl>
<dt><code>hashEnumerators</code> (default value:
@@ -4427,8 +4472,8 @@ contain the following text:</p>
<li>Parish</li>
</ol>
</blockquote>
-<h4 data-number="2.2.1.34" id="header-attributes"><span
-class="header-section-number">2.2.1.34</span> Option
+<h4 data-number="2.2.1.35" id="header-attributes"><span
+class="header-section-number">2.2.1.35</span> Option
<code>headerAttributes</code></h4>
<dl>
<dt><code>headerAttributes</code> (default value:
@@ -4457,8 +4502,8 @@ class="sourceCode md"><code class="sourceCode markdown"><span id="cb265-1"><a hr
</dl>
</dd>
</dl>
-<h4 data-number="2.2.1.35" id="option-html"><span
-class="header-section-number">2.2.1.35</span> Option
+<h4 data-number="2.2.1.36" id="option-html"><span
+class="header-section-number">2.2.1.36</span> Option
<code>html</code></h4>
<dl>
<dt><code>html</code> (default value: <code>true</code>)</dt>
@@ -4695,8 +4740,8 @@ comment –&gt; support. There is no &lt;? HTML instruction ?&gt;
support.</p>
<p>There is support. There is support. There is support.</p>
</blockquote>
-<h4 data-number="2.2.1.36" id="option-hybrid"><span
-class="header-section-number">2.2.1.36</span> Option
+<h4 data-number="2.2.1.37" id="option-hybrid"><span
+class="header-section-number">2.2.1.37</span> Option
<code>hybrid</code></h4>
<dl>
<dt><code>hybrid</code> (default value: <code>false</code>)</dt>
@@ -4728,35 +4773,83 @@ prepared with this package in mind.</p>
</dl>
</dd>
</dl>
+<p>The <code><strong>hybrid</strong></code> option makes it difficult to
+untangle <span class="tex">T<sub>e</sub>X</span> input from markdown
+text, which makes documents written with the
+<code><strong>hybrid</strong></code> option less interoperable and more
+difficult to read for authors. Therefore, the option has been
+soft-deprecated in version 3.7.1 of the Markdown package: It will never
+be removed but using it prints a warning and is discouraged.</p>
+<p>Consider one of the following better alternatives for mixing <span
+class="tex">T<sub>e</sub>X</span> and markdown:</p>
+<ul>
+<li><p>With the <code><strong>contentBlocks</strong></code> option,
+authors can move large blocks of TeX code to separate files and include
+them in their markdown documents as external resources:</p>
+<div class="sourceCode" id="cb277"><pre
+class="sourceCode md"><code class="sourceCode markdown"><span id="cb277-1"><a href="#cb277-1" aria-hidden="true" tabindex="-1"></a><span class="an">Here is a mathematical formula:</span></span>
+<span id="cb277-2"><a href="#cb277-2" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb277-3"><a href="#cb277-3" aria-hidden="true" tabindex="-1"></a> /math-formula.tex</span></code></pre></div></li>
+<li><p>With the <code><strong>rawAttribute</strong></code> option,
+authors can denote raw text spans and code blocks that will be
+interpreted as <span class="tex">T<sub>e</sub>X</span> code:</p>
+<div class="sourceCode" id="cb278"><pre
+class="sourceCode md"><code class="sourceCode markdown"><span id="cb278-1"><a href="#cb278-1" aria-hidden="true" tabindex="-1"></a><span class="in">`$H_2 O$`</span>{=tex} is a liquid.</span>
+<span id="cb278-2"><a href="#cb278-2" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb278-3"><a href="#cb278-3" aria-hidden="true" tabindex="-1"></a>Here is a mathematical formula:</span>
+<span id="cb278-4"><a href="#cb278-4" aria-hidden="true" tabindex="-1"></a><span class="in">``` {=tex}</span></span>
+<span id="cb278-5"><a href="#cb278-5" aria-hidden="true" tabindex="-1"></a><span class="in">\[distance[i] =</span></span>
+<span id="cb278-6"><a href="#cb278-6" aria-hidden="true" tabindex="-1"></a><span class="in"> \begin{dcases}</span></span>
+<span id="cb278-7"><a href="#cb278-7" aria-hidden="true" tabindex="-1"></a><span class="in"> a &amp; b \\</span></span>
+<span id="cb278-8"><a href="#cb278-8" aria-hidden="true" tabindex="-1"></a><span class="in"> c &amp; d</span></span>
+<span id="cb278-9"><a href="#cb278-9" aria-hidden="true" tabindex="-1"></a><span class="in"> \end{dcases}</span></span>
+<span id="cb278-10"><a href="#cb278-10" aria-hidden="true" tabindex="-1"></a><span class="in">\]</span></span>
+<span id="cb278-11"><a href="#cb278-11" aria-hidden="true" tabindex="-1"></a><span class="in">```</span></span></code></pre></div></li>
+<li><p>With options <code><strong>texMathDollars</strong></code>,
+<code><strong>texMathSingleBackslash</strong></code>, and
+<code><strong>texMathDoubleBackslash</strong></code>, authors can freely
+type <span class="tex">T<sub>e</sub>X</span> commands between dollar
+signs or backslash-escaped brackets:</p>
+<div class="sourceCode" id="cb279"><pre
+class="sourceCode md"><code class="sourceCode markdown"><span id="cb279-1"><a href="#cb279-1" aria-hidden="true" tabindex="-1"></a>$H_2 O$ is a liquid.</span>
+<span id="cb279-2"><a href="#cb279-2" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb279-3"><a href="#cb279-3" aria-hidden="true" tabindex="-1"></a>Here is a mathematical formula:</span>
+<span id="cb279-4"><a href="#cb279-4" aria-hidden="true" tabindex="-1"></a><span class="sc">\[</span>distance<span class="co">[</span><span class="ot">i</span><span class="co">]</span> =</span>
+<span id="cb279-5"><a href="#cb279-5" aria-hidden="true" tabindex="-1"></a> \begin{dcases}</span>
+<span id="cb279-6"><a href="#cb279-6" aria-hidden="true" tabindex="-1"></a> a &amp; b <span class="sc">\\</span></span>
+<span id="cb279-7"><a href="#cb279-7" aria-hidden="true" tabindex="-1"></a> c &amp; d</span>
+<span id="cb279-8"><a href="#cb279-8" aria-hidden="true" tabindex="-1"></a> \end{dcases}</span>
+<span id="cb279-9"><a href="#cb279-9" aria-hidden="true" tabindex="-1"></a><span class="sc">\]</span></span></code></pre></div></li>
+</ul>
<h5 class="unnumbered" id="lua-module-example-11">Lua Module
Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb277"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb277-1"><a href="#cb277-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
-<span id="cb277-2"><a href="#cb277-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> lmfonts</span>
-<span id="cb277-3"><a href="#cb277-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\begingroup</span></span>
-<span id="cb277-4"><a href="#cb277-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\catcode</span>`<span class="fu">\%</span>=12</span>
-<span id="cb277-5"><a href="#cb277-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\catcode</span>`<span class="fu">\#</span>=12</span>
-<span id="cb277-6"><a href="#cb277-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\directlua</span>{</span>
-<span id="cb277-7"><a href="#cb277-7" aria-hidden="true" tabindex="-1"></a> local markdown = require(&quot;markdown&quot;)</span>
-<span id="cb277-8"><a href="#cb277-8" aria-hidden="true" tabindex="-1"></a> local input, convert_safe, convert_unsafe, paragraph</span>
-<span id="cb277-9"><a href="#cb277-9" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb277-10"><a href="#cb277-10" aria-hidden="true" tabindex="-1"></a> input = [[<span class="ss">$</span><span class="sc">\string\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span>.]]</span>
-<span id="cb277-11"><a href="#cb277-11" aria-hidden="true" tabindex="-1"></a> convert_safe = markdown.new()</span>
-<span id="cb277-12"><a href="#cb277-12" aria-hidden="true" tabindex="-1"></a> convert_unsafe = markdown.new({hybrid = true})</span>
-<span id="cb277-13"><a href="#cb277-13" aria-hidden="true" tabindex="-1"></a> paragraph = [[<span class="fu">\par</span>]]</span>
-<span id="cb277-14"><a href="#cb277-14" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb277-15"><a href="#cb277-15" aria-hidden="true" tabindex="-1"></a> tex.sprint(</span>
-<span id="cb277-16"><a href="#cb277-16" aria-hidden="true" tabindex="-1"></a> convert_safe(input) .. paragraph ..</span>
-<span id="cb277-17"><a href="#cb277-17" aria-hidden="true" tabindex="-1"></a> convert_unsafe(input)</span>
-<span id="cb277-18"><a href="#cb277-18" aria-hidden="true" tabindex="-1"></a> )</span>
-<span id="cb277-19"><a href="#cb277-19" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb277-20"><a href="#cb277-20" aria-hidden="true" tabindex="-1"></a><span class="fu">\endgroup</span></span>
-<span id="cb277-21"><a href="#cb277-21" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb280"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb280-1"><a href="#cb280-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
+<span id="cb280-2"><a href="#cb280-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> lmfonts</span>
+<span id="cb280-3"><a href="#cb280-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\begingroup</span></span>
+<span id="cb280-4"><a href="#cb280-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\catcode</span>`<span class="fu">\%</span>=12</span>
+<span id="cb280-5"><a href="#cb280-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\catcode</span>`<span class="fu">\#</span>=12</span>
+<span id="cb280-6"><a href="#cb280-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\directlua</span>{</span>
+<span id="cb280-7"><a href="#cb280-7" aria-hidden="true" tabindex="-1"></a> local markdown = require(&quot;markdown&quot;)</span>
+<span id="cb280-8"><a href="#cb280-8" aria-hidden="true" tabindex="-1"></a> local input, convert_safe, convert_unsafe, paragraph</span>
+<span id="cb280-9"><a href="#cb280-9" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb280-10"><a href="#cb280-10" aria-hidden="true" tabindex="-1"></a> input = [[<span class="ss">$</span><span class="sc">\string\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span>.]]</span>
+<span id="cb280-11"><a href="#cb280-11" aria-hidden="true" tabindex="-1"></a> convert_safe = markdown.new()</span>
+<span id="cb280-12"><a href="#cb280-12" aria-hidden="true" tabindex="-1"></a> convert_unsafe = markdown.new({hybrid = true})</span>
+<span id="cb280-13"><a href="#cb280-13" aria-hidden="true" tabindex="-1"></a> paragraph = [[<span class="fu">\par</span>]]</span>
+<span id="cb280-14"><a href="#cb280-14" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb280-15"><a href="#cb280-15" aria-hidden="true" tabindex="-1"></a> tex.sprint(</span>
+<span id="cb280-16"><a href="#cb280-16" aria-hidden="true" tabindex="-1"></a> convert_safe(input) .. paragraph ..</span>
+<span id="cb280-17"><a href="#cb280-17" aria-hidden="true" tabindex="-1"></a> convert_unsafe(input)</span>
+<span id="cb280-18"><a href="#cb280-18" aria-hidden="true" tabindex="-1"></a> )</span>
+<span id="cb280-19"><a href="#cb280-19" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb280-20"><a href="#cb280-20" aria-hidden="true" tabindex="-1"></a><span class="fu">\endgroup</span></span>
+<span id="cb280-21"><a href="#cb280-21" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Then, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb278"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb278-1"><a href="#cb278-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb281"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb281-1"><a href="#cb281-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -4767,26 +4860,26 @@ contain the following text:</p>
<h5 class="unnumbered" id="lua-cli-example-10">Lua CLI Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb279"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb279-1"><a href="#cb279-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
-<span id="cb279-2"><a href="#cb279-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> lmfonts</span>
-<span id="cb279-3"><a href="#cb279-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\begingroup</span></span>
-<span id="cb279-4"><a href="#cb279-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\catcode</span>`<span class="fu">\%</span>=12</span>
-<span id="cb279-5"><a href="#cb279-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\catcode</span>`<span class="fu">\#</span>=12</span>
-<span id="cb279-6"><a href="#cb279-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> optionfalse</span>
-<span id="cb279-7"><a href="#cb279-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\par</span></span>
-<span id="cb279-8"><a href="#cb279-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> optiontrue</span>
-<span id="cb279-9"><a href="#cb279-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\endgroup</span></span>
-<span id="cb279-10"><a href="#cb279-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb282"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb282-1"><a href="#cb282-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
+<span id="cb282-2"><a href="#cb282-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> lmfonts</span>
+<span id="cb282-3"><a href="#cb282-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\begingroup</span></span>
+<span id="cb282-4"><a href="#cb282-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\catcode</span>`<span class="fu">\%</span>=12</span>
+<span id="cb282-5"><a href="#cb282-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\catcode</span>`<span class="fu">\#</span>=12</span>
+<span id="cb282-6"><a href="#cb282-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> optionfalse</span>
+<span id="cb282-7"><a href="#cb282-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\par</span></span>
+<span id="cb282-8"><a href="#cb282-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> optiontrue</span>
+<span id="cb282-9"><a href="#cb282-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\endgroup</span></span>
+<span id="cb282-10"><a href="#cb282-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Using a text editor, create a text document named
<code>content.md</code> with the following content:</p>
-<div class="sourceCode" id="cb280"><pre
-class="sourceCode md"><code class="sourceCode markdown"><span id="cb280-1"><a href="#cb280-1" aria-hidden="true" tabindex="-1"></a>$\sqrt{-1}$ *equals* $i$.</span></code></pre></div>
+<div class="sourceCode" id="cb283"><pre
+class="sourceCode md"><code class="sourceCode markdown"><span id="cb283-1"><a href="#cb283-1" aria-hidden="true" tabindex="-1"></a>$\sqrt{-1}$ *equals* $i$.</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb281"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb281-1"><a href="#cb281-1" aria-hidden="true" tabindex="-1"></a><span class="ex">texlua</span> ⟨CLI pathname⟩ <span class="at">--</span> content.md optionfalse.tex</span>
-<span id="cb281-2"><a href="#cb281-2" aria-hidden="true" tabindex="-1"></a><span class="ex">texlua</span> ⟨CLI pathname⟩ hybrid=true <span class="at">--</span> content.md optiontrue.tex</span>
-<span id="cb281-3"><a href="#cb281-3" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb284"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb284-1"><a href="#cb284-1" aria-hidden="true" tabindex="-1"></a><span class="ex">texlua</span> ⟨CLI pathname⟩ <span class="at">--</span> content.md optionfalse.tex</span>
+<span id="cb284-2"><a href="#cb284-2" aria-hidden="true" tabindex="-1"></a><span class="ex">texlua</span> ⟨CLI pathname⟩ hybrid=true <span class="at">--</span> content.md optiontrue.tex</span>
+<span id="cb284-3"><a href="#cb284-3" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
<p>where ⟨<em>CLI pathname</em>⟩ corresponds to the location of the Lua
CLI script file, such as
<code>~/texmf/scripts/markdown/markdown-cli.lua</code> on UN*X systems
@@ -4807,23 +4900,23 @@ contain the following text:</p>
class="tex">T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb282"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb282-1"><a href="#cb282-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
-<span id="cb282-2"><a href="#cb282-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> lmfonts</span>
-<span id="cb282-3"><a href="#cb282-3" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb282-4"><a href="#cb282-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
-<span id="cb282-5"><a href="#cb282-5" aria-hidden="true" tabindex="-1"></a><span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span>.</span>
-<span id="cb282-6"><a href="#cb282-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
-<span id="cb282-7"><a href="#cb282-7" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb282-8"><a href="#cb282-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionHybrid</span>{true}</span>
-<span id="cb282-9"><a href="#cb282-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
-<span id="cb282-10"><a href="#cb282-10" aria-hidden="true" tabindex="-1"></a><span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span>.</span>
-<span id="cb282-11"><a href="#cb282-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
-<span id="cb282-12"><a href="#cb282-12" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb282-13"><a href="#cb282-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb285"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb285-1"><a href="#cb285-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
+<span id="cb285-2"><a href="#cb285-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> lmfonts</span>
+<span id="cb285-3"><a href="#cb285-3" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb285-4"><a href="#cb285-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
+<span id="cb285-5"><a href="#cb285-5" aria-hidden="true" tabindex="-1"></a><span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span>.</span>
+<span id="cb285-6"><a href="#cb285-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
+<span id="cb285-7"><a href="#cb285-7" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb285-8"><a href="#cb285-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionHybrid</span>{true}</span>
+<span id="cb285-9"><a href="#cb285-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
+<span id="cb285-10"><a href="#cb285-10" aria-hidden="true" tabindex="-1"></a><span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span>.</span>
+<span id="cb285-11"><a href="#cb285-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
+<span id="cb285-12"><a href="#cb285-12" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb285-13"><a href="#cb285-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb283"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb283-1"><a href="#cb283-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb286"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb286-1"><a href="#cb286-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -4835,23 +4928,23 @@ contain the following text:</p>
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb284"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb284-1"><a href="#cb284-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb284-2"><a href="#cb284-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span>
-<span id="cb284-3"><a href="#cb284-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb284-4"><a href="#cb284-4" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb284-5"><a href="#cb284-5" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb284-6"><a href="#cb284-6" aria-hidden="true" tabindex="-1"></a><span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span>.</span>
-<span id="cb284-7"><a href="#cb284-7" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb284-8"><a href="#cb284-8" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb284-9"><a href="#cb284-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}[hybrid]</span>
-<span id="cb284-10"><a href="#cb284-10" aria-hidden="true" tabindex="-1"></a><span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span>.</span>
-<span id="cb284-11"><a href="#cb284-11" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb284-12"><a href="#cb284-12" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb284-13"><a href="#cb284-13" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb287"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb287-1"><a href="#cb287-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb287-2"><a href="#cb287-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span>
+<span id="cb287-3"><a href="#cb287-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb287-4"><a href="#cb287-4" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb287-5"><a href="#cb287-5" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb287-6"><a href="#cb287-6" aria-hidden="true" tabindex="-1"></a><span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span>.</span>
+<span id="cb287-7"><a href="#cb287-7" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb287-8"><a href="#cb287-8" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb287-9"><a href="#cb287-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}[hybrid]</span>
+<span id="cb287-10"><a href="#cb287-10" aria-hidden="true" tabindex="-1"></a><span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span>.</span>
+<span id="cb287-11"><a href="#cb287-11" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb287-12"><a href="#cb287-12" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb287-13"><a href="#cb287-13" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb285"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb285-1"><a href="#cb285-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb288"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb288-1"><a href="#cb288-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -4863,23 +4956,23 @@ contain the following text:</p>
class="tex">T<sub>e</sub>X</span>t Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb286"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb286-1"><a href="#cb286-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
-<span id="cb286-2"><a href="#cb286-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
-<span id="cb286-3"><a href="#cb286-3" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb286-4"><a href="#cb286-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb286-5"><a href="#cb286-5" aria-hidden="true" tabindex="-1"></a><span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span>.</span>
-<span id="cb286-6"><a href="#cb286-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb286-7"><a href="#cb286-7" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb286-8"><a href="#cb286-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[hybrid = yes]</span>
-<span id="cb286-9"><a href="#cb286-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb286-10"><a href="#cb286-10" aria-hidden="true" tabindex="-1"></a><span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span>.</span>
-<span id="cb286-11"><a href="#cb286-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb286-12"><a href="#cb286-12" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb286-13"><a href="#cb286-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
+<div class="sourceCode" id="cb289"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb289-1"><a href="#cb289-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
+<span id="cb289-2"><a href="#cb289-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
+<span id="cb289-3"><a href="#cb289-3" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb289-4"><a href="#cb289-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb289-5"><a href="#cb289-5" aria-hidden="true" tabindex="-1"></a><span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span>.</span>
+<span id="cb289-6"><a href="#cb289-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb289-7"><a href="#cb289-7" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb289-8"><a href="#cb289-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[hybrid = yes]</span>
+<span id="cb289-9"><a href="#cb289-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb289-10"><a href="#cb289-10" aria-hidden="true" tabindex="-1"></a><span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span>.</span>
+<span id="cb289-11"><a href="#cb289-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb289-12"><a href="#cb289-12" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb289-13"><a href="#cb289-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb287"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb287-1"><a href="#cb287-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb290"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb290-1"><a href="#cb290-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -4887,8 +4980,8 @@ contain the following text:</p>
<p><math><msqrt><mo>−</mo><mn>1</mn></msqrt></math> <em>equals</em>
<math><mi>i</mi></math>.</p>
</blockquote>
-<h4 data-number="2.2.1.37" id="option-inlinecodeattributes"><span
-class="header-section-number">2.2.1.37</span> Option
+<h4 data-number="2.2.1.38" id="option-inlinecodeattributes"><span
+class="header-section-number">2.2.1.38</span> Option
<code>inlineCodeAttributes</code></h4>
<dl>
<dt><code>inlineCodeAttributes</code> (default value:
@@ -4900,8 +4993,8 @@ class="header-section-number">2.2.1.37</span> Option
<p>Enable the Pandoc <a
href="https://pandoc.org/MANUAL.html#extension-inline_code_attributes">inline
code span attribute extension</a>:</p>
-<div class="sourceCode" id="cb288"><pre
-class="sourceCode md"><code class="sourceCode markdown"><span id="cb288-1"><a href="#cb288-1" aria-hidden="true" tabindex="-1"></a><span class="in">`&lt;$&gt;`</span>{.haskell}</span></code></pre></div>
+<div class="sourceCode" id="cb291"><pre
+class="sourceCode md"><code class="sourceCode markdown"><span id="cb291-1"><a href="#cb291-1" aria-hidden="true" tabindex="-1"></a><span class="in">`&lt;$&gt;`</span>{.haskell}</span></code></pre></div>
</dd>
</dl>
</dd>
@@ -4918,52 +5011,52 @@ class="sourceCode md"><code class="sourceCode markdown"><span id="cb288-1"><a hr
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb289"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb289-1"><a href="#cb289-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb289-2"><a href="#cb289-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[inlineCodeAttributes]{<span class="ex">markdown</span>}</span>
-<span id="cb289-3"><a href="#cb289-3" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">expl3</span>}</span>
-<span id="cb289-4"><a href="#cb289-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\ExplSyntaxOn</span></span>
-<span id="cb289-5"><a href="#cb289-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb289-6"><a href="#cb289-6" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb289-7"><a href="#cb289-7" aria-hidden="true" tabindex="-1"></a> codeSpanAttributeContextBegin = {</span>
-<span id="cb289-8"><a href="#cb289-8" aria-hidden="true" tabindex="-1"></a> <span class="fu">\group</span>_begin:</span>
-<span id="cb289-9"><a href="#cb289-9" aria-hidden="true" tabindex="-1"></a> <span class="fu">\color</span>_group_begin:</span>
-<span id="cb289-10"><a href="#cb289-10" aria-hidden="true" tabindex="-1"></a> <span class="fu">\markdownSetup</span>{</span>
-<span id="cb289-11"><a href="#cb289-11" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb289-12"><a href="#cb289-12" aria-hidden="true" tabindex="-1"></a> attributeKeyValue = {</span>
-<span id="cb289-13"><a href="#cb289-13" aria-hidden="true" tabindex="-1"></a> <span class="fu">\str</span>_if_eq:nnT</span>
-<span id="cb289-14"><a href="#cb289-14" aria-hidden="true" tabindex="-1"></a> { ##1 }</span>
-<span id="cb289-15"><a href="#cb289-15" aria-hidden="true" tabindex="-1"></a> { color }</span>
-<span id="cb289-16"><a href="#cb289-16" aria-hidden="true" tabindex="-1"></a> {</span>
-<span id="cb289-17"><a href="#cb289-17" aria-hidden="true" tabindex="-1"></a> <span class="fu">\color</span>_select:n { ##2 }</span>
-<span id="cb289-18"><a href="#cb289-18" aria-hidden="true" tabindex="-1"></a> }</span>
-<span id="cb289-19"><a href="#cb289-19" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb289-20"><a href="#cb289-20" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb289-21"><a href="#cb289-21" aria-hidden="true" tabindex="-1"></a> }</span>
-<span id="cb289-22"><a href="#cb289-22" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb289-23"><a href="#cb289-23" aria-hidden="true" tabindex="-1"></a> codeSpanAttributeContextEnd = {</span>
-<span id="cb289-24"><a href="#cb289-24" aria-hidden="true" tabindex="-1"></a> <span class="fu">\color</span>_group_end:</span>
-<span id="cb289-25"><a href="#cb289-25" aria-hidden="true" tabindex="-1"></a> <span class="fu">\group</span>_end:</span>
-<span id="cb289-26"><a href="#cb289-26" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb289-27"><a href="#cb289-27" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb289-28"><a href="#cb289-28" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb289-29"><a href="#cb289-29" aria-hidden="true" tabindex="-1"></a><span class="fu">\ExplSyntaxOff</span></span>
-<span id="cb289-30"><a href="#cb289-30" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb289-31"><a href="#cb289-31" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb289-32"><a href="#cb289-32" aria-hidden="true" tabindex="-1"></a>Here is some `colored text`{color=red}.</span>
-<span id="cb289-33"><a href="#cb289-33" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb289-34"><a href="#cb289-34" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb292"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb292-1"><a href="#cb292-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb292-2"><a href="#cb292-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[inlineCodeAttributes]{<span class="ex">markdown</span>}</span>
+<span id="cb292-3"><a href="#cb292-3" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">expl3</span>}</span>
+<span id="cb292-4"><a href="#cb292-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\ExplSyntaxOn</span></span>
+<span id="cb292-5"><a href="#cb292-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb292-6"><a href="#cb292-6" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb292-7"><a href="#cb292-7" aria-hidden="true" tabindex="-1"></a> codeSpanAttributeContextBegin = {</span>
+<span id="cb292-8"><a href="#cb292-8" aria-hidden="true" tabindex="-1"></a> <span class="fu">\group</span>_begin:</span>
+<span id="cb292-9"><a href="#cb292-9" aria-hidden="true" tabindex="-1"></a> <span class="fu">\color</span>_group_begin:</span>
+<span id="cb292-10"><a href="#cb292-10" aria-hidden="true" tabindex="-1"></a> <span class="fu">\markdownSetup</span>{</span>
+<span id="cb292-11"><a href="#cb292-11" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb292-12"><a href="#cb292-12" aria-hidden="true" tabindex="-1"></a> attributeKeyValue = {</span>
+<span id="cb292-13"><a href="#cb292-13" aria-hidden="true" tabindex="-1"></a> <span class="fu">\str</span>_if_eq:nnT</span>
+<span id="cb292-14"><a href="#cb292-14" aria-hidden="true" tabindex="-1"></a> { ##1 }</span>
+<span id="cb292-15"><a href="#cb292-15" aria-hidden="true" tabindex="-1"></a> { color }</span>
+<span id="cb292-16"><a href="#cb292-16" aria-hidden="true" tabindex="-1"></a> {</span>
+<span id="cb292-17"><a href="#cb292-17" aria-hidden="true" tabindex="-1"></a> <span class="fu">\color</span>_select:n { ##2 }</span>
+<span id="cb292-18"><a href="#cb292-18" aria-hidden="true" tabindex="-1"></a> }</span>
+<span id="cb292-19"><a href="#cb292-19" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb292-20"><a href="#cb292-20" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb292-21"><a href="#cb292-21" aria-hidden="true" tabindex="-1"></a> }</span>
+<span id="cb292-22"><a href="#cb292-22" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb292-23"><a href="#cb292-23" aria-hidden="true" tabindex="-1"></a> codeSpanAttributeContextEnd = {</span>
+<span id="cb292-24"><a href="#cb292-24" aria-hidden="true" tabindex="-1"></a> <span class="fu">\color</span>_group_end:</span>
+<span id="cb292-25"><a href="#cb292-25" aria-hidden="true" tabindex="-1"></a> <span class="fu">\group</span>_end:</span>
+<span id="cb292-26"><a href="#cb292-26" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb292-27"><a href="#cb292-27" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb292-28"><a href="#cb292-28" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb292-29"><a href="#cb292-29" aria-hidden="true" tabindex="-1"></a><span class="fu">\ExplSyntaxOff</span></span>
+<span id="cb292-30"><a href="#cb292-30" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb292-31"><a href="#cb292-31" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb292-32"><a href="#cb292-32" aria-hidden="true" tabindex="-1"></a>Here is some `colored text`{color=red}.</span>
+<span id="cb292-33"><a href="#cb292-33" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb292-34"><a href="#cb292-34" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb290"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb290-1"><a href="#cb290-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb293"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb293-1"><a href="#cb293-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
<p>Here is some <span
style="color: red"><code>colored text</code></span>.</p>
</blockquote>
-<h4 data-number="2.2.1.38" id="option-inlinenotes"><span
-class="header-section-number">2.2.1.38</span> Option
+<h4 data-number="2.2.1.39" id="option-inlinenotes"><span
+class="header-section-number">2.2.1.39</span> Option
<code>inlineNotes</code></h4>
<dl>
<dt><code>inlineNotes</code> (default value: <code>false</code>)</dt>
@@ -4974,10 +5067,10 @@ class="header-section-number">2.2.1.38</span> Option
<p>Enable the Pandoc <a
href="https://pandoc.org/MANUAL.html#extension-inline_notes">inline note
syntax extension</a>:</p>
-<div class="sourceCode" id="cb291"><pre
-class="sourceCode md"><code class="sourceCode markdown"><span id="cb291-1"><a href="#cb291-1" aria-hidden="true" tabindex="-1"></a>Here is an inline note.^[Inlines notes are easier to</span>
-<span id="cb291-2"><a href="#cb291-2" aria-hidden="true" tabindex="-1"></a>write, since you don&#39;t have to pick an identifier and</span>
-<span id="cb291-3"><a href="#cb291-3" aria-hidden="true" tabindex="-1"></a>move down to type the note.]</span></code></pre></div>
+<div class="sourceCode" id="cb294"><pre
+class="sourceCode md"><code class="sourceCode markdown"><span id="cb294-1"><a href="#cb294-1" aria-hidden="true" tabindex="-1"></a>Here is an inline note.^[Inlines notes are easier to</span>
+<span id="cb294-2"><a href="#cb294-2" aria-hidden="true" tabindex="-1"></a>write, since you don&#39;t have to pick an identifier and</span>
+<span id="cb294-3"><a href="#cb294-3" aria-hidden="true" tabindex="-1"></a>move down to type the note.]</span></code></pre></div>
</dd>
</dl>
</dd>
@@ -4994,19 +5087,19 @@ class="sourceCode md"><code class="sourceCode markdown"><span id="cb291-1"><a hr
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb292"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb292-1"><a href="#cb292-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb292-2"><a href="#cb292-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[inlineNotes]{<span class="ex">markdown</span>}</span>
-<span id="cb292-3"><a href="#cb292-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb292-4"><a href="#cb292-4" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb292-5"><a href="#cb292-5" aria-hidden="true" tabindex="-1"></a>Here is an inline note.^[Inlines notes are easier to</span>
-<span id="cb292-6"><a href="#cb292-6" aria-hidden="true" tabindex="-1"></a>write, since you don&#39;t have to pick an identifier and</span>
-<span id="cb292-7"><a href="#cb292-7" aria-hidden="true" tabindex="-1"></a>move down to type the note.]</span>
-<span id="cb292-8"><a href="#cb292-8" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb292-9"><a href="#cb292-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb295"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb295-1"><a href="#cb295-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb295-2"><a href="#cb295-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[inlineNotes]{<span class="ex">markdown</span>}</span>
+<span id="cb295-3"><a href="#cb295-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb295-4"><a href="#cb295-4" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb295-5"><a href="#cb295-5" aria-hidden="true" tabindex="-1"></a>Here is an inline note.^[Inlines notes are easier to</span>
+<span id="cb295-6"><a href="#cb295-6" aria-hidden="true" tabindex="-1"></a>write, since you don&#39;t have to pick an identifier and</span>
+<span id="cb295-7"><a href="#cb295-7" aria-hidden="true" tabindex="-1"></a>move down to type the note.]</span>
+<span id="cb295-8"><a href="#cb295-8" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb295-9"><a href="#cb295-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb293"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb293-1"><a href="#cb293-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb296"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb296-1"><a href="#cb296-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -5017,27 +5110,27 @@ id="fnref1" role="doc-noteref"><sup>1</sup></a></p>
class="tex">T<sub>e</sub>X</span>t Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb294"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb294-1"><a href="#cb294-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
-<span id="cb294-2"><a href="#cb294-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[inlineNotes = yes]</span>
-<span id="cb294-3"><a href="#cb294-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
-<span id="cb294-4"><a href="#cb294-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb294-5"><a href="#cb294-5" aria-hidden="true" tabindex="-1"></a>Here is an inline note.^[Inlines notes are easier to</span>
-<span id="cb294-6"><a href="#cb294-6" aria-hidden="true" tabindex="-1"></a>write, since you don&#39;t have to pick an identifier and</span>
-<span id="cb294-7"><a href="#cb294-7" aria-hidden="true" tabindex="-1"></a>move down to type the note.]</span>
-<span id="cb294-8"><a href="#cb294-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb294-9"><a href="#cb294-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
+<div class="sourceCode" id="cb297"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb297-1"><a href="#cb297-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
+<span id="cb297-2"><a href="#cb297-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[inlineNotes = yes]</span>
+<span id="cb297-3"><a href="#cb297-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
+<span id="cb297-4"><a href="#cb297-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb297-5"><a href="#cb297-5" aria-hidden="true" tabindex="-1"></a>Here is an inline note.^[Inlines notes are easier to</span>
+<span id="cb297-6"><a href="#cb297-6" aria-hidden="true" tabindex="-1"></a>write, since you don&#39;t have to pick an identifier and</span>
+<span id="cb297-7"><a href="#cb297-7" aria-hidden="true" tabindex="-1"></a>move down to type the note.]</span>
+<span id="cb297-8"><a href="#cb297-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb297-9"><a href="#cb297-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb295"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb295-1"><a href="#cb295-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb298"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb298-1"><a href="#cb298-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
<p>Here is an inline note.<a href="#fn2" class="footnote-ref"
id="fnref2" role="doc-noteref"><sup>2</sup></a></p>
</blockquote>
-<h4 data-number="2.2.1.39" id="option-jekylldata"><span
-class="header-section-number">2.2.1.39</span> Option
+<h4 data-number="2.2.1.40" id="option-jekylldata"><span
+class="header-section-number">2.2.1.40</span> Option
<code>jekyllData</code></h4>
<dl>
<dt><code>jekyllData</code> (default value: <code>false</code>)</dt>
@@ -5049,18 +5142,18 @@ class="header-section-number">2.2.1.39</span> Option
href="https://pandoc.org/MANUAL.html#extension-yaml_metadata_block"><abbr>yaml</abbr>
metadata block syntax extension</a> for entering metadata in
<abbr>yaml</abbr>:</p>
-<div class="sourceCode" id="cb296"><pre
-class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb296-1"><a href="#cb296-1" aria-hidden="true" tabindex="-1"></a><span class="pp">---</span></span>
-<span id="cb296-2"><a href="#cb296-2" aria-hidden="true" tabindex="-1"></a><span class="fu">title</span><span class="kw">:</span><span class="at"> </span><span class="st">&#39;This is the title: it contains a colon&#39;</span></span>
-<span id="cb296-3"><a href="#cb296-3" aria-hidden="true" tabindex="-1"></a><span class="fu">author</span><span class="kw">:</span></span>
-<span id="cb296-4"><a href="#cb296-4" aria-hidden="true" tabindex="-1"></a><span class="kw">-</span><span class="at"> Author One</span></span>
-<span id="cb296-5"><a href="#cb296-5" aria-hidden="true" tabindex="-1"></a><span class="kw">-</span><span class="at"> Author Two</span></span>
-<span id="cb296-6"><a href="#cb296-6" aria-hidden="true" tabindex="-1"></a><span class="fu">keywords</span><span class="kw">:</span><span class="at"> </span><span class="kw">[</span><span class="at">nothing</span><span class="kw">,</span><span class="at"> nothingness</span><span class="kw">]</span></span>
-<span id="cb296-7"><a href="#cb296-7" aria-hidden="true" tabindex="-1"></a><span class="fu">abstract</span><span class="kw">: </span><span class="ch">|</span></span>
-<span id="cb296-8"><a href="#cb296-8" aria-hidden="true" tabindex="-1"></a> This is the abstract.</span>
-<span id="cb296-9"><a href="#cb296-9" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb296-10"><a href="#cb296-10" aria-hidden="true" tabindex="-1"></a> It consists of two paragraphs.</span>
-<span id="cb296-11"><a href="#cb296-11" aria-hidden="true" tabindex="-1"></a><span class="pp">---</span></span></code></pre></div>
+<div class="sourceCode" id="cb299"><pre
+class="sourceCode yaml"><code class="sourceCode yaml"><span id="cb299-1"><a href="#cb299-1" aria-hidden="true" tabindex="-1"></a><span class="pp">---</span></span>
+<span id="cb299-2"><a href="#cb299-2" aria-hidden="true" tabindex="-1"></a><span class="fu">title</span><span class="kw">:</span><span class="at"> </span><span class="st">&#39;This is the title: it contains a colon&#39;</span></span>
+<span id="cb299-3"><a href="#cb299-3" aria-hidden="true" tabindex="-1"></a><span class="fu">author</span><span class="kw">:</span></span>
+<span id="cb299-4"><a href="#cb299-4" aria-hidden="true" tabindex="-1"></a><span class="kw">-</span><span class="at"> Author One</span></span>
+<span id="cb299-5"><a href="#cb299-5" aria-hidden="true" tabindex="-1"></a><span class="kw">-</span><span class="at"> Author Two</span></span>
+<span id="cb299-6"><a href="#cb299-6" aria-hidden="true" tabindex="-1"></a><span class="fu">keywords</span><span class="kw">:</span><span class="at"> </span><span class="kw">[</span><span class="at">nothing</span><span class="kw">,</span><span class="at"> nothingness</span><span class="kw">]</span></span>
+<span id="cb299-7"><a href="#cb299-7" aria-hidden="true" tabindex="-1"></a><span class="fu">abstract</span><span class="kw">: </span><span class="ch">|</span></span>
+<span id="cb299-8"><a href="#cb299-8" aria-hidden="true" tabindex="-1"></a> This is the abstract.</span>
+<span id="cb299-9"><a href="#cb299-9" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb299-10"><a href="#cb299-10" aria-hidden="true" tabindex="-1"></a> It consists of two paragraphs.</span>
+<span id="cb299-11"><a href="#cb299-11" aria-hidden="true" tabindex="-1"></a><span class="pp">---</span></span></code></pre></div>
</dd>
</dl>
</dd>
@@ -5078,29 +5171,29 @@ for entering metadata in <abbr>yaml</abbr>.</p>
class="tex">T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb297"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb297-1"><a href="#cb297-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
-<span id="cb297-2"><a href="#cb297-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionJekyllData</span>{true}</span>
-<span id="cb297-3"><a href="#cb297-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\ExplSyntaxOn</span></span>
-<span id="cb297-4"><a href="#cb297-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\keys</span>_define:nn</span>
-<span id="cb297-5"><a href="#cb297-5" aria-hidden="true" tabindex="-1"></a> { markdown/jekyllData }</span>
-<span id="cb297-6"><a href="#cb297-6" aria-hidden="true" tabindex="-1"></a> {</span>
-<span id="cb297-7"><a href="#cb297-7" aria-hidden="true" tabindex="-1"></a> name .code:n = { <span class="fu">\gdef\name</span>{#1} },</span>
-<span id="cb297-8"><a href="#cb297-8" aria-hidden="true" tabindex="-1"></a> age .code:n = { <span class="fu">\gdef\age</span>{#1} },</span>
-<span id="cb297-9"><a href="#cb297-9" aria-hidden="true" tabindex="-1"></a> }</span>
-<span id="cb297-10"><a href="#cb297-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\ExplSyntaxOff</span></span>
-<span id="cb297-11"><a href="#cb297-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererJekyllDataEnd</span>{<span class="co">%</span></span>
-<span id="cb297-12"><a href="#cb297-12" aria-hidden="true" tabindex="-1"></a> <span class="fu">\name</span>{} is <span class="fu">\age</span>{} years old.}</span>
-<span id="cb297-13"><a href="#cb297-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
-<span id="cb297-14"><a href="#cb297-14" aria-hidden="true" tabindex="-1"></a>---</span>
-<span id="cb297-15"><a href="#cb297-15" aria-hidden="true" tabindex="-1"></a>name: Jane Doe</span>
-<span id="cb297-16"><a href="#cb297-16" aria-hidden="true" tabindex="-1"></a>age: 99</span>
-<span id="cb297-17"><a href="#cb297-17" aria-hidden="true" tabindex="-1"></a>---</span>
-<span id="cb297-18"><a href="#cb297-18" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
-<span id="cb297-19"><a href="#cb297-19" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb300"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb300-1"><a href="#cb300-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
+<span id="cb300-2"><a href="#cb300-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionJekyllData</span>{true}</span>
+<span id="cb300-3"><a href="#cb300-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\ExplSyntaxOn</span></span>
+<span id="cb300-4"><a href="#cb300-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\keys</span>_define:nn</span>
+<span id="cb300-5"><a href="#cb300-5" aria-hidden="true" tabindex="-1"></a> { markdown/jekyllData }</span>
+<span id="cb300-6"><a href="#cb300-6" aria-hidden="true" tabindex="-1"></a> {</span>
+<span id="cb300-7"><a href="#cb300-7" aria-hidden="true" tabindex="-1"></a> name .code:n = { <span class="fu">\gdef\name</span>{#1} },</span>
+<span id="cb300-8"><a href="#cb300-8" aria-hidden="true" tabindex="-1"></a> age .code:n = { <span class="fu">\gdef\age</span>{#1} },</span>
+<span id="cb300-9"><a href="#cb300-9" aria-hidden="true" tabindex="-1"></a> }</span>
+<span id="cb300-10"><a href="#cb300-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\ExplSyntaxOff</span></span>
+<span id="cb300-11"><a href="#cb300-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererJekyllDataEnd</span>{<span class="co">%</span></span>
+<span id="cb300-12"><a href="#cb300-12" aria-hidden="true" tabindex="-1"></a> <span class="fu">\name</span>{} is <span class="fu">\age</span>{} years old.}</span>
+<span id="cb300-13"><a href="#cb300-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
+<span id="cb300-14"><a href="#cb300-14" aria-hidden="true" tabindex="-1"></a>---</span>
+<span id="cb300-15"><a href="#cb300-15" aria-hidden="true" tabindex="-1"></a>name: Jane Doe</span>
+<span id="cb300-16"><a href="#cb300-16" aria-hidden="true" tabindex="-1"></a>age: 99</span>
+<span id="cb300-17"><a href="#cb300-17" aria-hidden="true" tabindex="-1"></a>---</span>
+<span id="cb300-18"><a href="#cb300-18" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
+<span id="cb300-19"><a href="#cb300-19" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb298"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb298-1"><a href="#cb298-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb301"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb301-1"><a href="#cb301-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -5110,31 +5203,31 @@ contain the following text:</p>
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb299"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb299-1"><a href="#cb299-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb299-2"><a href="#cb299-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[jekyllData]{<span class="ex">markdown</span>}</span>
-<span id="cb299-3"><a href="#cb299-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb299-4"><a href="#cb299-4" aria-hidden="true" tabindex="-1"></a> jekyllDataRenderers = {</span>
-<span id="cb299-5"><a href="#cb299-5" aria-hidden="true" tabindex="-1"></a> name = {<span class="fu">\gdef\name</span>{#1}},</span>
-<span id="cb299-6"><a href="#cb299-6" aria-hidden="true" tabindex="-1"></a> code = {<span class="fu">\gdef\age</span>{#1}},</span>
-<span id="cb299-7"><a href="#cb299-7" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb299-8"><a href="#cb299-8" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb299-9"><a href="#cb299-9" aria-hidden="true" tabindex="-1"></a> jekyllDataEnd = {<span class="fu">\name</span>{} is <span class="fu">\age</span>{} years old.},</span>
-<span id="cb299-10"><a href="#cb299-10" aria-hidden="true" tabindex="-1"></a> }</span>
-<span id="cb299-11"><a href="#cb299-11" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb299-12"><a href="#cb299-12" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb299-13"><a href="#cb299-13" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb299-14"><a href="#cb299-14" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb299-15"><a href="#cb299-15" aria-hidden="true" tabindex="-1"></a>---</span>
-<span id="cb299-16"><a href="#cb299-16" aria-hidden="true" tabindex="-1"></a>name: Jane Doe</span>
-<span id="cb299-17"><a href="#cb299-17" aria-hidden="true" tabindex="-1"></a>age: 99</span>
-<span id="cb299-18"><a href="#cb299-18" aria-hidden="true" tabindex="-1"></a>---</span>
-<span id="cb299-19"><a href="#cb299-19" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb299-20"><a href="#cb299-20" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb299-21"><a href="#cb299-21" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb302"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb302-1"><a href="#cb302-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb302-2"><a href="#cb302-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[jekyllData]{<span class="ex">markdown</span>}</span>
+<span id="cb302-3"><a href="#cb302-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb302-4"><a href="#cb302-4" aria-hidden="true" tabindex="-1"></a> jekyllDataRenderers = {</span>
+<span id="cb302-5"><a href="#cb302-5" aria-hidden="true" tabindex="-1"></a> name = {<span class="fu">\gdef\name</span>{#1}},</span>
+<span id="cb302-6"><a href="#cb302-6" aria-hidden="true" tabindex="-1"></a> code = {<span class="fu">\gdef\age</span>{#1}},</span>
+<span id="cb302-7"><a href="#cb302-7" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb302-8"><a href="#cb302-8" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb302-9"><a href="#cb302-9" aria-hidden="true" tabindex="-1"></a> jekyllDataEnd = {<span class="fu">\name</span>{} is <span class="fu">\age</span>{} years old.},</span>
+<span id="cb302-10"><a href="#cb302-10" aria-hidden="true" tabindex="-1"></a> }</span>
+<span id="cb302-11"><a href="#cb302-11" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb302-12"><a href="#cb302-12" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb302-13"><a href="#cb302-13" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb302-14"><a href="#cb302-14" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb302-15"><a href="#cb302-15" aria-hidden="true" tabindex="-1"></a>---</span>
+<span id="cb302-16"><a href="#cb302-16" aria-hidden="true" tabindex="-1"></a>name: Jane Doe</span>
+<span id="cb302-17"><a href="#cb302-17" aria-hidden="true" tabindex="-1"></a>age: 99</span>
+<span id="cb302-18"><a href="#cb302-18" aria-hidden="true" tabindex="-1"></a>---</span>
+<span id="cb302-19"><a href="#cb302-19" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb302-20"><a href="#cb302-20" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb302-21"><a href="#cb302-21" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb300"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb300-1"><a href="#cb300-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb303"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb303-1"><a href="#cb303-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -5144,39 +5237,39 @@ contain the following text:</p>
class="tex">T<sub>e</sub>X</span>t Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb301"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb301-1"><a href="#cb301-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
-<span id="cb301-2"><a href="#cb301-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[jekyllData = yes]</span>
-<span id="cb301-3"><a href="#cb301-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\ExplSyntaxOn</span></span>
-<span id="cb301-4"><a href="#cb301-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\keys</span>_define:nn</span>
-<span id="cb301-5"><a href="#cb301-5" aria-hidden="true" tabindex="-1"></a> { markdown/jekyllData }</span>
-<span id="cb301-6"><a href="#cb301-6" aria-hidden="true" tabindex="-1"></a> {</span>
-<span id="cb301-7"><a href="#cb301-7" aria-hidden="true" tabindex="-1"></a> name .code:n = { <span class="fu">\gdef\name</span>{#1} },</span>
-<span id="cb301-8"><a href="#cb301-8" aria-hidden="true" tabindex="-1"></a> age .code:n = { <span class="fu">\gdef\age</span>{#1} },</span>
-<span id="cb301-9"><a href="#cb301-9" aria-hidden="true" tabindex="-1"></a> }</span>
-<span id="cb301-10"><a href="#cb301-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\ExplSyntaxOff</span></span>
-<span id="cb301-11"><a href="#cb301-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererJekyllDataEnd</span>{<span class="co">%</span></span>
-<span id="cb301-12"><a href="#cb301-12" aria-hidden="true" tabindex="-1"></a> <span class="fu">\name</span>{} is <span class="fu">\age</span>{} years old.}</span>
-<span id="cb301-13"><a href="#cb301-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
-<span id="cb301-14"><a href="#cb301-14" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb301-15"><a href="#cb301-15" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb301-16"><a href="#cb301-16" aria-hidden="true" tabindex="-1"></a>---</span>
-<span id="cb301-17"><a href="#cb301-17" aria-hidden="true" tabindex="-1"></a>name: Jane Doe</span>
-<span id="cb301-18"><a href="#cb301-18" aria-hidden="true" tabindex="-1"></a>age: 99</span>
-<span id="cb301-19"><a href="#cb301-19" aria-hidden="true" tabindex="-1"></a>---</span>
-<span id="cb301-20"><a href="#cb301-20" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb301-21"><a href="#cb301-21" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb301-22"><a href="#cb301-22" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
+<div class="sourceCode" id="cb304"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb304-1"><a href="#cb304-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
+<span id="cb304-2"><a href="#cb304-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[jekyllData = yes]</span>
+<span id="cb304-3"><a href="#cb304-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\ExplSyntaxOn</span></span>
+<span id="cb304-4"><a href="#cb304-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\keys</span>_define:nn</span>
+<span id="cb304-5"><a href="#cb304-5" aria-hidden="true" tabindex="-1"></a> { markdown/jekyllData }</span>
+<span id="cb304-6"><a href="#cb304-6" aria-hidden="true" tabindex="-1"></a> {</span>
+<span id="cb304-7"><a href="#cb304-7" aria-hidden="true" tabindex="-1"></a> name .code:n = { <span class="fu">\gdef\name</span>{#1} },</span>
+<span id="cb304-8"><a href="#cb304-8" aria-hidden="true" tabindex="-1"></a> age .code:n = { <span class="fu">\gdef\age</span>{#1} },</span>
+<span id="cb304-9"><a href="#cb304-9" aria-hidden="true" tabindex="-1"></a> }</span>
+<span id="cb304-10"><a href="#cb304-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\ExplSyntaxOff</span></span>
+<span id="cb304-11"><a href="#cb304-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererJekyllDataEnd</span>{<span class="co">%</span></span>
+<span id="cb304-12"><a href="#cb304-12" aria-hidden="true" tabindex="-1"></a> <span class="fu">\name</span>{} is <span class="fu">\age</span>{} years old.}</span>
+<span id="cb304-13"><a href="#cb304-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
+<span id="cb304-14"><a href="#cb304-14" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb304-15"><a href="#cb304-15" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb304-16"><a href="#cb304-16" aria-hidden="true" tabindex="-1"></a>---</span>
+<span id="cb304-17"><a href="#cb304-17" aria-hidden="true" tabindex="-1"></a>name: Jane Doe</span>
+<span id="cb304-18"><a href="#cb304-18" aria-hidden="true" tabindex="-1"></a>age: 99</span>
+<span id="cb304-19"><a href="#cb304-19" aria-hidden="true" tabindex="-1"></a>---</span>
+<span id="cb304-20"><a href="#cb304-20" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb304-21"><a href="#cb304-21" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb304-22"><a href="#cb304-22" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb302"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb302-1"><a href="#cb302-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb305"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb305-1"><a href="#cb305-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
<p>Jane Doe is 99 years old.</p>
</blockquote>
-<h4 data-number="2.2.1.40" id="option-linkattributes"><span
-class="header-section-number">2.2.1.40</span> Option
+<h4 data-number="2.2.1.41" id="option-linkattributes"><span
+class="header-section-number">2.2.1.41</span> Option
<code>linkAttributes</code></h4>
<dl>
<dt><code>linkAttributes</code> (default value: <code>false</code>)</dt>
@@ -5187,11 +5280,11 @@ class="header-section-number">2.2.1.40</span> Option
<p>Enable the Pandoc <a
href="https://pandoc.org/MANUAL.html#extension-link_attributes">link and
image attribute syntax extension</a>:</p>
-<div class="sourceCode" id="cb303"><pre
-class="sourceCode md"><code class="sourceCode markdown"><span id="cb303-1"><a href="#cb303-1" aria-hidden="true" tabindex="-1"></a>An inline <span class="al">![image](foo.jpg)</span>{#id .class width=30 height=20px}</span>
-<span id="cb303-2"><a href="#cb303-2" aria-hidden="true" tabindex="-1"></a>and a reference <span class="al">![image][ref]</span> with attributes.</span>
-<span id="cb303-3"><a href="#cb303-3" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb303-4"><a href="#cb303-4" aria-hidden="true" tabindex="-1"></a><span class="ot">[ref]: </span>foo.jpg &quot;optional title&quot; {#id .class key=val key2=val2}</span></code></pre></div>
+<div class="sourceCode" id="cb306"><pre
+class="sourceCode md"><code class="sourceCode markdown"><span id="cb306-1"><a href="#cb306-1" aria-hidden="true" tabindex="-1"></a>An inline <span class="al">![image](foo.jpg)</span>{#id .class width=30 height=20px}</span>
+<span id="cb306-2"><a href="#cb306-2" aria-hidden="true" tabindex="-1"></a>and a reference <span class="al">![image][ref]</span> with attributes.</span>
+<span id="cb306-3"><a href="#cb306-3" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb306-4"><a href="#cb306-4" aria-hidden="true" tabindex="-1"></a><span class="ot">[ref]: </span>foo.jpg &quot;optional title&quot; {#id .class key=val key2=val2}</span></code></pre></div>
</dd>
</dl>
</dd>
@@ -5208,47 +5301,47 @@ class="sourceCode md"><code class="sourceCode markdown"><span id="cb303-1"><a hr
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb304"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb304-1"><a href="#cb304-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb304-2"><a href="#cb304-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[linkAttributes]{<span class="ex">markdown</span>}</span>
-<span id="cb304-3"><a href="#cb304-3" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">expl3, graphicx</span>}</span>
-<span id="cb304-4"><a href="#cb304-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\ExplSyntaxOn</span></span>
-<span id="cb304-5"><a href="#cb304-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb304-6"><a href="#cb304-6" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb304-7"><a href="#cb304-7" aria-hidden="true" tabindex="-1"></a> imageAttributeContextBegin = {</span>
-<span id="cb304-8"><a href="#cb304-8" aria-hidden="true" tabindex="-1"></a> <span class="fu">\group</span>_begin:</span>
-<span id="cb304-9"><a href="#cb304-9" aria-hidden="true" tabindex="-1"></a> <span class="fu">\markdownSetup</span>{</span>
-<span id="cb304-10"><a href="#cb304-10" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb304-11"><a href="#cb304-11" aria-hidden="true" tabindex="-1"></a> attributeKeyValue = {</span>
-<span id="cb304-12"><a href="#cb304-12" aria-hidden="true" tabindex="-1"></a> <span class="fu">\setkeys</span></span>
-<span id="cb304-13"><a href="#cb304-13" aria-hidden="true" tabindex="-1"></a> { Gin }</span>
-<span id="cb304-14"><a href="#cb304-14" aria-hidden="true" tabindex="-1"></a> { { ##1 } = { ##2 } }</span>
-<span id="cb304-15"><a href="#cb304-15" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb304-16"><a href="#cb304-16" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb304-17"><a href="#cb304-17" aria-hidden="true" tabindex="-1"></a> }</span>
-<span id="cb304-18"><a href="#cb304-18" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb304-19"><a href="#cb304-19" aria-hidden="true" tabindex="-1"></a> imageAttributeContextEnd = {</span>
-<span id="cb304-20"><a href="#cb304-20" aria-hidden="true" tabindex="-1"></a> <span class="fu">\group</span>_end:</span>
-<span id="cb304-21"><a href="#cb304-21" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb304-22"><a href="#cb304-22" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb304-23"><a href="#cb304-23" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb304-24"><a href="#cb304-24" aria-hidden="true" tabindex="-1"></a><span class="fu">\ExplSyntaxOff</span></span>
-<span id="cb304-25"><a href="#cb304-25" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb304-26"><a href="#cb304-26" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb304-27"><a href="#cb304-27" aria-hidden="true" tabindex="-1"></a>Here is an example image:</span>
-<span id="cb304-28"><a href="#cb304-28" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb304-29"><a href="#cb304-29" aria-hidden="true" tabindex="-1"></a> ![example image](example-image){width=5cm height=4cm}</span>
-<span id="cb304-30"><a href="#cb304-30" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb304-31"><a href="#cb304-31" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb307"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb307-1"><a href="#cb307-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb307-2"><a href="#cb307-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[linkAttributes]{<span class="ex">markdown</span>}</span>
+<span id="cb307-3"><a href="#cb307-3" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">expl3, graphicx</span>}</span>
+<span id="cb307-4"><a href="#cb307-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\ExplSyntaxOn</span></span>
+<span id="cb307-5"><a href="#cb307-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb307-6"><a href="#cb307-6" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb307-7"><a href="#cb307-7" aria-hidden="true" tabindex="-1"></a> imageAttributeContextBegin = {</span>
+<span id="cb307-8"><a href="#cb307-8" aria-hidden="true" tabindex="-1"></a> <span class="fu">\group</span>_begin:</span>
+<span id="cb307-9"><a href="#cb307-9" aria-hidden="true" tabindex="-1"></a> <span class="fu">\markdownSetup</span>{</span>
+<span id="cb307-10"><a href="#cb307-10" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb307-11"><a href="#cb307-11" aria-hidden="true" tabindex="-1"></a> attributeKeyValue = {</span>
+<span id="cb307-12"><a href="#cb307-12" aria-hidden="true" tabindex="-1"></a> <span class="fu">\setkeys</span></span>
+<span id="cb307-13"><a href="#cb307-13" aria-hidden="true" tabindex="-1"></a> { Gin }</span>
+<span id="cb307-14"><a href="#cb307-14" aria-hidden="true" tabindex="-1"></a> { { ##1 } = { ##2 } }</span>
+<span id="cb307-15"><a href="#cb307-15" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb307-16"><a href="#cb307-16" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb307-17"><a href="#cb307-17" aria-hidden="true" tabindex="-1"></a> }</span>
+<span id="cb307-18"><a href="#cb307-18" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb307-19"><a href="#cb307-19" aria-hidden="true" tabindex="-1"></a> imageAttributeContextEnd = {</span>
+<span id="cb307-20"><a href="#cb307-20" aria-hidden="true" tabindex="-1"></a> <span class="fu">\group</span>_end:</span>
+<span id="cb307-21"><a href="#cb307-21" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb307-22"><a href="#cb307-22" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb307-23"><a href="#cb307-23" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb307-24"><a href="#cb307-24" aria-hidden="true" tabindex="-1"></a><span class="fu">\ExplSyntaxOff</span></span>
+<span id="cb307-25"><a href="#cb307-25" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb307-26"><a href="#cb307-26" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb307-27"><a href="#cb307-27" aria-hidden="true" tabindex="-1"></a>Here is an example image:</span>
+<span id="cb307-28"><a href="#cb307-28" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb307-29"><a href="#cb307-29" aria-hidden="true" tabindex="-1"></a> ![example image](example-image){width=5cm height=4cm}</span>
+<span id="cb307-30"><a href="#cb307-30" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb307-31"><a href="#cb307-31" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb305"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb305-1"><a href="#cb305-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb308"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb308-1"><a href="#cb308-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain an example image (from <a href="https://ctan.org/pkg/mwe"
title="mwe – Packages and image files for MWEs">Martin Scharrer’s mwe
package</a>) displayed at size 5cm × 4cm.</p>
-<h4 data-number="2.2.1.41" id="option-lineblocks"><span
-class="header-section-number">2.2.1.41</span> Option
+<h4 data-number="2.2.1.42" id="option-lineblocks"><span
+class="header-section-number">2.2.1.42</span> Option
<code>lineBlocks</code></h4>
<dl>
<dt><code>lineBlocks</code> (default value: <code>false</code>)</dt>
@@ -5259,12 +5352,12 @@ class="header-section-number">2.2.1.41</span> Option
<p>Enable the Pandoc <a
href="https://pandoc.org/MANUAL.html#extension-line_blocks">line block
syntax extension</a>:</p>
-<div class="sourceCode" id="cb306"><pre
-class="sourceCode md"><code class="sourceCode markdown"><span id="cb306-1"><a href="#cb306-1" aria-hidden="true" tabindex="-1"></a>| this is a line block that</span>
-<span id="cb306-2"><a href="#cb306-2" aria-hidden="true" tabindex="-1"></a>| spans multiple</span>
-<span id="cb306-3"><a href="#cb306-3" aria-hidden="true" tabindex="-1"></a>| even</span>
-<span id="cb306-4"><a href="#cb306-4" aria-hidden="true" tabindex="-1"></a> discontinuous</span>
-<span id="cb306-5"><a href="#cb306-5" aria-hidden="true" tabindex="-1"></a>| lines</span></code></pre></div>
+<div class="sourceCode" id="cb309"><pre
+class="sourceCode md"><code class="sourceCode markdown"><span id="cb309-1"><a href="#cb309-1" aria-hidden="true" tabindex="-1"></a>| this is a line block that</span>
+<span id="cb309-2"><a href="#cb309-2" aria-hidden="true" tabindex="-1"></a>| spans multiple</span>
+<span id="cb309-3"><a href="#cb309-3" aria-hidden="true" tabindex="-1"></a>| even</span>
+<span id="cb309-4"><a href="#cb309-4" aria-hidden="true" tabindex="-1"></a> discontinuous</span>
+<span id="cb309-5"><a href="#cb309-5" aria-hidden="true" tabindex="-1"></a>| lines</span></code></pre></div>
</dd>
</dl>
</dd>
@@ -5281,19 +5374,19 @@ class="sourceCode md"><code class="sourceCode markdown"><span id="cb306-1"><a hr
class="tex">T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb307"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb307-1"><a href="#cb307-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
-<span id="cb307-2"><a href="#cb307-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionLineBlocks</span>{true}</span>
-<span id="cb307-3"><a href="#cb307-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
-<span id="cb307-4"><a href="#cb307-4" aria-hidden="true" tabindex="-1"></a>| I would spread the cloths under your feet:</span>
-<span id="cb307-5"><a href="#cb307-5" aria-hidden="true" tabindex="-1"></a>| But I, being poor, have only my dreams;</span>
-<span id="cb307-6"><a href="#cb307-6" aria-hidden="true" tabindex="-1"></a>| I have spread my dreams under your feet;</span>
-<span id="cb307-7"><a href="#cb307-7" aria-hidden="true" tabindex="-1"></a>| Tread softly because you tread on my dreams.</span>
-<span id="cb307-8"><a href="#cb307-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
-<span id="cb307-9"><a href="#cb307-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb310"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb310-1"><a href="#cb310-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
+<span id="cb310-2"><a href="#cb310-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionLineBlocks</span>{true}</span>
+<span id="cb310-3"><a href="#cb310-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
+<span id="cb310-4"><a href="#cb310-4" aria-hidden="true" tabindex="-1"></a>| I would spread the cloths under your feet:</span>
+<span id="cb310-5"><a href="#cb310-5" aria-hidden="true" tabindex="-1"></a>| But I, being poor, have only my dreams;</span>
+<span id="cb310-6"><a href="#cb310-6" aria-hidden="true" tabindex="-1"></a>| I have spread my dreams under your feet;</span>
+<span id="cb310-7"><a href="#cb310-7" aria-hidden="true" tabindex="-1"></a>| Tread softly because you tread on my dreams.</span>
+<span id="cb310-8"><a href="#cb310-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
+<span id="cb310-9"><a href="#cb310-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb308"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb308-1"><a href="#cb308-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb311"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb311-1"><a href="#cb311-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -5306,20 +5399,20 @@ Tread softly because you tread on my dreams.</div>
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb309"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb309-1"><a href="#cb309-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb309-2"><a href="#cb309-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[lineBlocks]{<span class="ex">markdown</span>}</span>
-<span id="cb309-3"><a href="#cb309-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb309-4"><a href="#cb309-4" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb309-5"><a href="#cb309-5" aria-hidden="true" tabindex="-1"></a>| I would spread the cloths under your feet:</span>
-<span id="cb309-6"><a href="#cb309-6" aria-hidden="true" tabindex="-1"></a>| But I, being poor, have only my dreams;</span>
-<span id="cb309-7"><a href="#cb309-7" aria-hidden="true" tabindex="-1"></a>| I have spread my dreams under your feet;</span>
-<span id="cb309-8"><a href="#cb309-8" aria-hidden="true" tabindex="-1"></a>| Tread softly because you tread on my dreams.</span>
-<span id="cb309-9"><a href="#cb309-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb309-10"><a href="#cb309-10" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb312"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb312-1"><a href="#cb312-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb312-2"><a href="#cb312-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[lineBlocks]{<span class="ex">markdown</span>}</span>
+<span id="cb312-3"><a href="#cb312-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb312-4"><a href="#cb312-4" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb312-5"><a href="#cb312-5" aria-hidden="true" tabindex="-1"></a>| I would spread the cloths under your feet:</span>
+<span id="cb312-6"><a href="#cb312-6" aria-hidden="true" tabindex="-1"></a>| But I, being poor, have only my dreams;</span>
+<span id="cb312-7"><a href="#cb312-7" aria-hidden="true" tabindex="-1"></a>| I have spread my dreams under your feet;</span>
+<span id="cb312-8"><a href="#cb312-8" aria-hidden="true" tabindex="-1"></a>| Tread softly because you tread on my dreams.</span>
+<span id="cb312-9"><a href="#cb312-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb312-10"><a href="#cb312-10" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb310"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb310-1"><a href="#cb310-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb313"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb313-1"><a href="#cb313-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -5332,20 +5425,20 @@ Tread softly because you tread on my dreams.</div>
class="tex">T<sub>e</sub>X</span>t Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb311"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb311-1"><a href="#cb311-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
-<span id="cb311-2"><a href="#cb311-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[lineBlocks = yes]</span>
-<span id="cb311-3"><a href="#cb311-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
-<span id="cb311-4"><a href="#cb311-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb311-5"><a href="#cb311-5" aria-hidden="true" tabindex="-1"></a>| I would spread the cloths under your feet:</span>
-<span id="cb311-6"><a href="#cb311-6" aria-hidden="true" tabindex="-1"></a>| But I, being poor, have only my dreams;</span>
-<span id="cb311-7"><a href="#cb311-7" aria-hidden="true" tabindex="-1"></a>| I have spread my dreams under your feet;</span>
-<span id="cb311-8"><a href="#cb311-8" aria-hidden="true" tabindex="-1"></a>| Tread softly because you tread on my dreams.</span>
-<span id="cb311-9"><a href="#cb311-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb311-10"><a href="#cb311-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
+<div class="sourceCode" id="cb314"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb314-1"><a href="#cb314-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
+<span id="cb314-2"><a href="#cb314-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[lineBlocks = yes]</span>
+<span id="cb314-3"><a href="#cb314-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
+<span id="cb314-4"><a href="#cb314-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb314-5"><a href="#cb314-5" aria-hidden="true" tabindex="-1"></a>| I would spread the cloths under your feet:</span>
+<span id="cb314-6"><a href="#cb314-6" aria-hidden="true" tabindex="-1"></a>| But I, being poor, have only my dreams;</span>
+<span id="cb314-7"><a href="#cb314-7" aria-hidden="true" tabindex="-1"></a>| I have spread my dreams under your feet;</span>
+<span id="cb314-8"><a href="#cb314-8" aria-hidden="true" tabindex="-1"></a>| Tread softly because you tread on my dreams.</span>
+<span id="cb314-9"><a href="#cb314-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb314-10"><a href="#cb314-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb312"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb312-1"><a href="#cb312-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb315"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb315-1"><a href="#cb315-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -5354,8 +5447,8 @@ But I, being poor, have only my dreams;<br />
I have spread my dreams under your feet;<br />
Tread softly because you tread on my dreams.</div>
</blockquote>
-<h4 data-number="2.2.1.42" id="option-mark"><span
-class="header-section-number">2.2.1.42</span> Option
+<h4 data-number="2.2.1.43" id="option-mark"><span
+class="header-section-number">2.2.1.43</span> Option
<code>mark</code></h4>
<dl>
<dt><code>mark</code> (default value: <code>false</code>)</dt>
@@ -5366,8 +5459,8 @@ class="header-section-number">2.2.1.42</span> Option
<p>Enable the Pandoc <a
href="https://pandoc.org/MANUAL.html#extension-mark">mark syntax
extension</a>:</p>
-<div class="sourceCode" id="cb313"><pre
-class="sourceCode md"><code class="sourceCode markdown"><span id="cb313-1"><a href="#cb313-1" aria-hidden="true" tabindex="-1"></a>This ==is highlighted text.==</span></code></pre></div>
+<div class="sourceCode" id="cb316"><pre
+class="sourceCode md"><code class="sourceCode markdown"><span id="cb316-1"><a href="#cb316-1" aria-hidden="true" tabindex="-1"></a>This ==is highlighted text.==</span></code></pre></div>
</dd>
</dl>
</dd>
@@ -5384,26 +5477,26 @@ class="sourceCode md"><code class="sourceCode markdown"><span id="cb313-1"><a hr
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb314"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb314-1"><a href="#cb314-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb314-2"><a href="#cb314-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[mark]{<span class="ex">markdown</span>}</span>
-<span id="cb314-3"><a href="#cb314-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb314-4"><a href="#cb314-4" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb314-5"><a href="#cb314-5" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb314-6"><a href="#cb314-6" aria-hidden="true" tabindex="-1"></a>This ==is highlighted text.==</span>
-<span id="cb314-7"><a href="#cb314-7" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb314-8"><a href="#cb314-8" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb314-9"><a href="#cb314-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb317"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb317-1"><a href="#cb317-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb317-2"><a href="#cb317-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[mark]{<span class="ex">markdown</span>}</span>
+<span id="cb317-3"><a href="#cb317-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb317-4"><a href="#cb317-4" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb317-5"><a href="#cb317-5" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb317-6"><a href="#cb317-6" aria-hidden="true" tabindex="-1"></a>This ==is highlighted text.==</span>
+<span id="cb317-7"><a href="#cb317-7" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb317-8"><a href="#cb317-8" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb317-9"><a href="#cb317-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb315"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb315-1"><a href="#cb315-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb318"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb318-1"><a href="#cb318-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
<p>This <mark>is highlighted text.</mark></p>
</blockquote>
-<h4 data-number="2.2.1.43" id="option-notes"><span
-class="header-section-number">2.2.1.43</span> Option
+<h4 data-number="2.2.1.44" id="option-notes"><span
+class="header-section-number">2.2.1.44</span> Option
<code>notes</code></h4>
<dl>
<dt><code>notes</code> (default value: <code>false</code>)</dt>
@@ -5414,24 +5507,24 @@ class="header-section-number">2.2.1.43</span> Option
<p>Enable the Pandoc <a
href="https://pandoc.org/MANUAL.html#extension-footnotes">note syntax
extension</a>:</p>
-<div class="sourceCode" id="cb316"><pre
-class="sourceCode md"><code class="sourceCode markdown"><span id="cb316-1"><a href="#cb316-1" aria-hidden="true" tabindex="-1"></a>Here is a note reference,<span class="ot">[^1]</span> and another.<span class="ot">[^longnote]</span></span>
-<span id="cb316-2"><a href="#cb316-2" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb316-3"><a href="#cb316-3" aria-hidden="true" tabindex="-1"></a><span class="ot">[^1]: </span>Here is the note.</span>
-<span id="cb316-4"><a href="#cb316-4" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb316-5"><a href="#cb316-5" aria-hidden="true" tabindex="-1"></a><span class="ot">[^longnote]: </span>Here&#39;s one with multiple blocks.</span>
-<span id="cb316-6"><a href="#cb316-6" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb316-7"><a href="#cb316-7" aria-hidden="true" tabindex="-1"></a><span class="in"> Subsequent paragraphs are indented to show that they</span></span>
-<span id="cb316-8"><a href="#cb316-8" aria-hidden="true" tabindex="-1"></a>belong to the previous note.</span>
-<span id="cb316-9"><a href="#cb316-9" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb316-10"><a href="#cb316-10" aria-hidden="true" tabindex="-1"></a><span class="in"> { some.code }</span></span>
-<span id="cb316-11"><a href="#cb316-11" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb316-12"><a href="#cb316-12" aria-hidden="true" tabindex="-1"></a><span class="in"> The whole paragraph can be indented, or just the</span></span>
-<span id="cb316-13"><a href="#cb316-13" aria-hidden="true" tabindex="-1"></a><span class="in"> first line. In this way, multi-paragraph notes</span></span>
-<span id="cb316-14"><a href="#cb316-14" aria-hidden="true" tabindex="-1"></a><span class="in"> work like multi-paragraph list items.</span></span>
-<span id="cb316-15"><a href="#cb316-15" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb316-16"><a href="#cb316-16" aria-hidden="true" tabindex="-1"></a>This paragraph won&#39;t be part of the note, because it</span>
-<span id="cb316-17"><a href="#cb316-17" aria-hidden="true" tabindex="-1"></a>isn&#39;t indented.</span></code></pre></div>
+<div class="sourceCode" id="cb319"><pre
+class="sourceCode md"><code class="sourceCode markdown"><span id="cb319-1"><a href="#cb319-1" aria-hidden="true" tabindex="-1"></a>Here is a note reference,<span class="ot">[^1]</span> and another.<span class="ot">[^longnote]</span></span>
+<span id="cb319-2"><a href="#cb319-2" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb319-3"><a href="#cb319-3" aria-hidden="true" tabindex="-1"></a><span class="ot">[^1]: </span>Here is the note.</span>
+<span id="cb319-4"><a href="#cb319-4" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb319-5"><a href="#cb319-5" aria-hidden="true" tabindex="-1"></a><span class="ot">[^longnote]: </span>Here&#39;s one with multiple blocks.</span>
+<span id="cb319-6"><a href="#cb319-6" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb319-7"><a href="#cb319-7" aria-hidden="true" tabindex="-1"></a><span class="in"> Subsequent paragraphs are indented to show that they</span></span>
+<span id="cb319-8"><a href="#cb319-8" aria-hidden="true" tabindex="-1"></a>belong to the previous note.</span>
+<span id="cb319-9"><a href="#cb319-9" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb319-10"><a href="#cb319-10" aria-hidden="true" tabindex="-1"></a><span class="in"> { some.code }</span></span>
+<span id="cb319-11"><a href="#cb319-11" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb319-12"><a href="#cb319-12" aria-hidden="true" tabindex="-1"></a><span class="in"> The whole paragraph can be indented, or just the</span></span>
+<span id="cb319-13"><a href="#cb319-13" aria-hidden="true" tabindex="-1"></a><span class="in"> first line. In this way, multi-paragraph notes</span></span>
+<span id="cb319-14"><a href="#cb319-14" aria-hidden="true" tabindex="-1"></a><span class="in"> work like multi-paragraph list items.</span></span>
+<span id="cb319-15"><a href="#cb319-15" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb319-16"><a href="#cb319-16" aria-hidden="true" tabindex="-1"></a>This paragraph won&#39;t be part of the note, because it</span>
+<span id="cb319-17"><a href="#cb319-17" aria-hidden="true" tabindex="-1"></a>isn&#39;t indented.</span></code></pre></div>
</dd>
</dl>
</dd>
@@ -5448,33 +5541,33 @@ class="sourceCode md"><code class="sourceCode markdown"><span id="cb316-1"><a hr
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb317"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb317-1"><a href="#cb317-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb317-2"><a href="#cb317-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[notes]{<span class="ex">markdown</span>}</span>
-<span id="cb317-3"><a href="#cb317-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb317-4"><a href="#cb317-4" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb317-5"><a href="#cb317-5" aria-hidden="true" tabindex="-1"></a>Here is a note reference,[^1] and another.[^longnote]</span>
-<span id="cb317-6"><a href="#cb317-6" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb317-7"><a href="#cb317-7" aria-hidden="true" tabindex="-1"></a>[^1]: Here is the note.</span>
-<span id="cb317-8"><a href="#cb317-8" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb317-9"><a href="#cb317-9" aria-hidden="true" tabindex="-1"></a>[^longnote]: Here&#39;s one with multiple blocks.</span>
-<span id="cb317-10"><a href="#cb317-10" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb317-11"><a href="#cb317-11" aria-hidden="true" tabindex="-1"></a> Subsequent paragraphs are indented to show that they</span>
-<span id="cb317-12"><a href="#cb317-12" aria-hidden="true" tabindex="-1"></a>belong to the previous note.</span>
-<span id="cb317-13"><a href="#cb317-13" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb317-14"><a href="#cb317-14" aria-hidden="true" tabindex="-1"></a> { some.code }</span>
-<span id="cb317-15"><a href="#cb317-15" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb317-16"><a href="#cb317-16" aria-hidden="true" tabindex="-1"></a> The whole paragraph can be indented, or just the</span>
-<span id="cb317-17"><a href="#cb317-17" aria-hidden="true" tabindex="-1"></a> first line. In this way, multi-paragraph notes</span>
-<span id="cb317-18"><a href="#cb317-18" aria-hidden="true" tabindex="-1"></a> work like multi-paragraph list items.</span>
-<span id="cb317-19"><a href="#cb317-19" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb317-20"><a href="#cb317-20" aria-hidden="true" tabindex="-1"></a>This paragraph won&#39;t be part of the note, because it</span>
-<span id="cb317-21"><a href="#cb317-21" aria-hidden="true" tabindex="-1"></a>isn&#39;t indented.</span>
-<span id="cb317-22"><a href="#cb317-22" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb317-23"><a href="#cb317-23" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb320"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb320-1"><a href="#cb320-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb320-2"><a href="#cb320-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[notes]{<span class="ex">markdown</span>}</span>
+<span id="cb320-3"><a href="#cb320-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb320-4"><a href="#cb320-4" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb320-5"><a href="#cb320-5" aria-hidden="true" tabindex="-1"></a>Here is a note reference,[^1] and another.[^longnote]</span>
+<span id="cb320-6"><a href="#cb320-6" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb320-7"><a href="#cb320-7" aria-hidden="true" tabindex="-1"></a>[^1]: Here is the note.</span>
+<span id="cb320-8"><a href="#cb320-8" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb320-9"><a href="#cb320-9" aria-hidden="true" tabindex="-1"></a>[^longnote]: Here&#39;s one with multiple blocks.</span>
+<span id="cb320-10"><a href="#cb320-10" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb320-11"><a href="#cb320-11" aria-hidden="true" tabindex="-1"></a> Subsequent paragraphs are indented to show that they</span>
+<span id="cb320-12"><a href="#cb320-12" aria-hidden="true" tabindex="-1"></a>belong to the previous note.</span>
+<span id="cb320-13"><a href="#cb320-13" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb320-14"><a href="#cb320-14" aria-hidden="true" tabindex="-1"></a> { some.code }</span>
+<span id="cb320-15"><a href="#cb320-15" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb320-16"><a href="#cb320-16" aria-hidden="true" tabindex="-1"></a> The whole paragraph can be indented, or just the</span>
+<span id="cb320-17"><a href="#cb320-17" aria-hidden="true" tabindex="-1"></a> first line. In this way, multi-paragraph notes</span>
+<span id="cb320-18"><a href="#cb320-18" aria-hidden="true" tabindex="-1"></a> work like multi-paragraph list items.</span>
+<span id="cb320-19"><a href="#cb320-19" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb320-20"><a href="#cb320-20" aria-hidden="true" tabindex="-1"></a>This paragraph won&#39;t be part of the note, because it</span>
+<span id="cb320-21"><a href="#cb320-21" aria-hidden="true" tabindex="-1"></a>isn&#39;t indented.</span>
+<span id="cb320-22"><a href="#cb320-22" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb320-23"><a href="#cb320-23" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb318"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb318-1"><a href="#cb318-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb321"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb321-1"><a href="#cb321-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -5493,33 +5586,33 @@ indented.</p>
class="tex">T<sub>e</sub>X</span>t Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb321"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb321-1"><a href="#cb321-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
-<span id="cb321-2"><a href="#cb321-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[notes = yes]</span>
-<span id="cb321-3"><a href="#cb321-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
-<span id="cb321-4"><a href="#cb321-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb321-5"><a href="#cb321-5" aria-hidden="true" tabindex="-1"></a>Here is a note reference,[^1] and another.[^longnote]</span>
-<span id="cb321-6"><a href="#cb321-6" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb321-7"><a href="#cb321-7" aria-hidden="true" tabindex="-1"></a>[^1]: Here is the note.</span>
-<span id="cb321-8"><a href="#cb321-8" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb321-9"><a href="#cb321-9" aria-hidden="true" tabindex="-1"></a>[^longnote]: Here&#39;s one with multiple blocks.</span>
-<span id="cb321-10"><a href="#cb321-10" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb321-11"><a href="#cb321-11" aria-hidden="true" tabindex="-1"></a> Subsequent paragraphs are indented to show that they</span>
-<span id="cb321-12"><a href="#cb321-12" aria-hidden="true" tabindex="-1"></a>belong to the previous note.</span>
-<span id="cb321-13"><a href="#cb321-13" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb321-14"><a href="#cb321-14" aria-hidden="true" tabindex="-1"></a> { some.code }</span>
-<span id="cb321-15"><a href="#cb321-15" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb321-16"><a href="#cb321-16" aria-hidden="true" tabindex="-1"></a> The whole paragraph can be indented, or just the</span>
-<span id="cb321-17"><a href="#cb321-17" aria-hidden="true" tabindex="-1"></a> first line. In this way, multi-paragraph notes</span>
-<span id="cb321-18"><a href="#cb321-18" aria-hidden="true" tabindex="-1"></a> work like multi-paragraph list items.</span>
-<span id="cb321-19"><a href="#cb321-19" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb321-20"><a href="#cb321-20" aria-hidden="true" tabindex="-1"></a>This paragraph won&#39;t be part of the note, because it</span>
-<span id="cb321-21"><a href="#cb321-21" aria-hidden="true" tabindex="-1"></a>isn&#39;t indented.</span>
-<span id="cb321-22"><a href="#cb321-22" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb321-23"><a href="#cb321-23" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
-<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb322"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb322-1"><a href="#cb322-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb324"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb324-1"><a href="#cb324-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
+<span id="cb324-2"><a href="#cb324-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[notes = yes]</span>
+<span id="cb324-3"><a href="#cb324-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
+<span id="cb324-4"><a href="#cb324-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb324-5"><a href="#cb324-5" aria-hidden="true" tabindex="-1"></a>Here is a note reference,[^1] and another.[^longnote]</span>
+<span id="cb324-6"><a href="#cb324-6" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb324-7"><a href="#cb324-7" aria-hidden="true" tabindex="-1"></a>[^1]: Here is the note.</span>
+<span id="cb324-8"><a href="#cb324-8" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb324-9"><a href="#cb324-9" aria-hidden="true" tabindex="-1"></a>[^longnote]: Here&#39;s one with multiple blocks.</span>
+<span id="cb324-10"><a href="#cb324-10" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb324-11"><a href="#cb324-11" aria-hidden="true" tabindex="-1"></a> Subsequent paragraphs are indented to show that they</span>
+<span id="cb324-12"><a href="#cb324-12" aria-hidden="true" tabindex="-1"></a>belong to the previous note.</span>
+<span id="cb324-13"><a href="#cb324-13" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb324-14"><a href="#cb324-14" aria-hidden="true" tabindex="-1"></a> { some.code }</span>
+<span id="cb324-15"><a href="#cb324-15" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb324-16"><a href="#cb324-16" aria-hidden="true" tabindex="-1"></a> The whole paragraph can be indented, or just the</span>
+<span id="cb324-17"><a href="#cb324-17" aria-hidden="true" tabindex="-1"></a> first line. In this way, multi-paragraph notes</span>
+<span id="cb324-18"><a href="#cb324-18" aria-hidden="true" tabindex="-1"></a> work like multi-paragraph list items.</span>
+<span id="cb324-19"><a href="#cb324-19" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb324-20"><a href="#cb324-20" aria-hidden="true" tabindex="-1"></a>This paragraph won&#39;t be part of the note, because it</span>
+<span id="cb324-21"><a href="#cb324-21" aria-hidden="true" tabindex="-1"></a>isn&#39;t indented.</span>
+<span id="cb324-22"><a href="#cb324-22" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb324-23"><a href="#cb324-23" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
+<p>Next, invoke LuaTeX from the terminal:</p>
+<div class="sourceCode" id="cb325"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb325-1"><a href="#cb325-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -5534,8 +5627,8 @@ work like multi-paragraph list items.</code></pre>
<p>This paragraph won’t be part of the note, because it isn’t
indented.</p>
</blockquote>
-<h4 data-number="2.2.1.44" id="pipe-tables"><span
-class="header-section-number">2.2.1.44</span> Option
+<h4 data-number="2.2.1.45" id="pipe-tables"><span
+class="header-section-number">2.2.1.45</span> Option
<code>pipeTables</code></h4>
<dl>
<dt><code>pipeTables</code> (default value: <code>false</code>)</dt>
@@ -5544,12 +5637,12 @@ class="header-section-number">2.2.1.44</span> Option
<dt>true</dt>
<dd>
<p>Enable the <abbr>PHP</abbr> Markdown pipe table syntax extension:</p>
-<div class="sourceCode" id="cb325"><pre
-class="sourceCode md"><code class="sourceCode markdown"><span id="cb325-1"><a href="#cb325-1" aria-hidden="true" tabindex="-1"></a>| Right | Left | Default | Center |</span>
-<span id="cb325-2"><a href="#cb325-2" aria-hidden="true" tabindex="-1"></a>|------:|:-----|---------|:------:|</span>
-<span id="cb325-3"><a href="#cb325-3" aria-hidden="true" tabindex="-1"></a>| 12 | 12 | 12 | 12 |</span>
-<span id="cb325-4"><a href="#cb325-4" aria-hidden="true" tabindex="-1"></a>| 123 | 123 | 123 | 123 |</span>
-<span id="cb325-5"><a href="#cb325-5" aria-hidden="true" tabindex="-1"></a>| 1 | 1 | 1 | 1 |</span></code></pre></div>
+<div class="sourceCode" id="cb328"><pre
+class="sourceCode md"><code class="sourceCode markdown"><span id="cb328-1"><a href="#cb328-1" aria-hidden="true" tabindex="-1"></a>| Right | Left | Default | Center |</span>
+<span id="cb328-2"><a href="#cb328-2" aria-hidden="true" tabindex="-1"></a>|------:|:-----|---------|:------:|</span>
+<span id="cb328-3"><a href="#cb328-3" aria-hidden="true" tabindex="-1"></a>| 12 | 12 | 12 | 12 |</span>
+<span id="cb328-4"><a href="#cb328-4" aria-hidden="true" tabindex="-1"></a>| 123 | 123 | 123 | 123 |</span>
+<span id="cb328-5"><a href="#cb328-5" aria-hidden="true" tabindex="-1"></a>| 1 | 1 | 1 | 1 |</span></code></pre></div>
</dd>
</dl>
</dd>
@@ -5567,21 +5660,21 @@ extension.</p>
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb326"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb326-1"><a href="#cb326-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb326-2"><a href="#cb326-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[pipeTables]{<span class="ex">markdown</span>}</span>
-<span id="cb326-3"><a href="#cb326-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb326-4"><a href="#cb326-4" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb326-5"><a href="#cb326-5" aria-hidden="true" tabindex="-1"></a>| Right | Left | Default | Center |</span>
-<span id="cb326-6"><a href="#cb326-6" aria-hidden="true" tabindex="-1"></a>|------:|:-----|---------|:------:|</span>
-<span id="cb326-7"><a href="#cb326-7" aria-hidden="true" tabindex="-1"></a>| 12 | 12 | 12 | 12 |</span>
-<span id="cb326-8"><a href="#cb326-8" aria-hidden="true" tabindex="-1"></a>| 123 | 123 | 123 | 123 |</span>
-<span id="cb326-9"><a href="#cb326-9" aria-hidden="true" tabindex="-1"></a>| 1 | 1 | 1 | 1 |</span>
-<span id="cb326-10"><a href="#cb326-10" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb326-11"><a href="#cb326-11" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb329"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb329-1"><a href="#cb329-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb329-2"><a href="#cb329-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[pipeTables]{<span class="ex">markdown</span>}</span>
+<span id="cb329-3"><a href="#cb329-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb329-4"><a href="#cb329-4" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb329-5"><a href="#cb329-5" aria-hidden="true" tabindex="-1"></a>| Right | Left | Default | Center |</span>
+<span id="cb329-6"><a href="#cb329-6" aria-hidden="true" tabindex="-1"></a>|------:|:-----|---------|:------:|</span>
+<span id="cb329-7"><a href="#cb329-7" aria-hidden="true" tabindex="-1"></a>| 12 | 12 | 12 | 12 |</span>
+<span id="cb329-8"><a href="#cb329-8" aria-hidden="true" tabindex="-1"></a>| 123 | 123 | 123 | 123 |</span>
+<span id="cb329-9"><a href="#cb329-9" aria-hidden="true" tabindex="-1"></a>| 1 | 1 | 1 | 1 |</span>
+<span id="cb329-10"><a href="#cb329-10" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb329-11"><a href="#cb329-11" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb327"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb327-1"><a href="#cb327-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb330"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb330-1"><a href="#cb330-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -5620,21 +5713,21 @@ contain the following text:</p>
class="tex">T<sub>e</sub>X</span>t Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb328"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb328-1"><a href="#cb328-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
-<span id="cb328-2"><a href="#cb328-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[pipeTables = yes]</span>
-<span id="cb328-3"><a href="#cb328-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
-<span id="cb328-4"><a href="#cb328-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb328-5"><a href="#cb328-5" aria-hidden="true" tabindex="-1"></a>| Right | Left | Default | Center |</span>
-<span id="cb328-6"><a href="#cb328-6" aria-hidden="true" tabindex="-1"></a>|------:|:-----|---------|:------:|</span>
-<span id="cb328-7"><a href="#cb328-7" aria-hidden="true" tabindex="-1"></a>| 12 | 12 | 12 | 12 |</span>
-<span id="cb328-8"><a href="#cb328-8" aria-hidden="true" tabindex="-1"></a>| 123 | 123 | 123 | 123 |</span>
-<span id="cb328-9"><a href="#cb328-9" aria-hidden="true" tabindex="-1"></a>| 1 | 1 | 1 | 1 |</span>
-<span id="cb328-10"><a href="#cb328-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb328-11"><a href="#cb328-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
+<div class="sourceCode" id="cb331"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb331-1"><a href="#cb331-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
+<span id="cb331-2"><a href="#cb331-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[pipeTables = yes]</span>
+<span id="cb331-3"><a href="#cb331-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
+<span id="cb331-4"><a href="#cb331-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb331-5"><a href="#cb331-5" aria-hidden="true" tabindex="-1"></a>| Right | Left | Default | Center |</span>
+<span id="cb331-6"><a href="#cb331-6" aria-hidden="true" tabindex="-1"></a>|------:|:-----|---------|:------:|</span>
+<span id="cb331-7"><a href="#cb331-7" aria-hidden="true" tabindex="-1"></a>| 12 | 12 | 12 | 12 |</span>
+<span id="cb331-8"><a href="#cb331-8" aria-hidden="true" tabindex="-1"></a>| 123 | 123 | 123 | 123 |</span>
+<span id="cb331-9"><a href="#cb331-9" aria-hidden="true" tabindex="-1"></a>| 1 | 1 | 1 | 1 |</span>
+<span id="cb331-10"><a href="#cb331-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb331-11"><a href="#cb331-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb329"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb329-1"><a href="#cb329-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb332"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb332-1"><a href="#cb332-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -5669,8 +5762,8 @@ contain the following text:</p>
</tbody>
</table>
</blockquote>
-<h4 data-number="2.2.1.45" id="option-preservetabs"><span
-class="header-section-number">2.2.1.45</span> Option
+<h4 data-number="2.2.1.46" id="option-preservetabs"><span
+class="header-section-number">2.2.1.46</span> Option
<code>preserveTabs</code></h4>
<dl>
<dt><code>preserveTabs</code> (default value: <code>true</code>)</dt>
@@ -5691,8 +5784,8 @@ class="header-section-number">2.2.1.45</span> Option
</dl>
</dd>
</dl>
-<h4 data-number="2.2.1.46" id="option-rawattribute"><span
-class="header-section-number">2.2.1.46</span> Option
+<h4 data-number="2.2.1.47" id="option-rawattribute"><span
+class="header-section-number">2.2.1.47</span> Option
<code>rawAttribute</code></h4>
<dl>
<dt><code>rawAttribute</code> (default value: <code>false</code>)</dt>
@@ -5703,24 +5796,24 @@ class="header-section-number">2.2.1.46</span> Option
<p>Enable the Pandoc <a
href="https://pandoc.org/MANUAL.html#extension-raw_attribute">raw
attribute syntax extension</a>:</p>
-<div class="sourceCode" id="cb330"><pre
-class="sourceCode md"><code class="sourceCode markdown"><span id="cb330-1"><a href="#cb330-1" aria-hidden="true" tabindex="-1"></a><span class="in">`$H_2 O$`</span>{=tex} is a liquid.</span></code></pre></div>
-<p>To enable raw blocks, the <strong><code>fencedCode</code></strong>
+<div class="sourceCode" id="cb333"><pre
+class="sourceCode md"><code class="sourceCode markdown"><span id="cb333-1"><a href="#cb333-1" aria-hidden="true" tabindex="-1"></a><span class="in">`$H_2 O$`</span>{=tex} is a liquid.</span></code></pre></div>
+<p>To enable raw blocks, the <code><strong>fencedCode</strong></code>
option must also be enabled:</p>
-<div class="sourceCode" id="cb331"><pre
-class="sourceCode md"><code class="sourceCode markdown"><span id="cb331-1"><a href="#cb331-1" aria-hidden="true" tabindex="-1"></a><span class="an">Here is a mathematical formula:</span></span>
-<span id="cb331-2"><a href="#cb331-2" aria-hidden="true" tabindex="-1"></a><span class="in">``` {=tex}</span></span>
-<span id="cb331-3"><a href="#cb331-3" aria-hidden="true" tabindex="-1"></a><span class="in">\[distance[i] =</span></span>
-<span id="cb331-4"><a href="#cb331-4" aria-hidden="true" tabindex="-1"></a><span class="in"> \begin{dcases}</span></span>
-<span id="cb331-5"><a href="#cb331-5" aria-hidden="true" tabindex="-1"></a><span class="in"> a &amp; b \\</span></span>
-<span id="cb331-6"><a href="#cb331-6" aria-hidden="true" tabindex="-1"></a><span class="in"> c &amp; d</span></span>
-<span id="cb331-7"><a href="#cb331-7" aria-hidden="true" tabindex="-1"></a><span class="in"> \end{dcases}</span></span>
-<span id="cb331-8"><a href="#cb331-8" aria-hidden="true" tabindex="-1"></a><span class="in">\]</span></span>
-<span id="cb331-9"><a href="#cb331-9" aria-hidden="true" tabindex="-1"></a><span class="in">```</span></span></code></pre></div>
-<p>The <strong><code>rawAttribute</code></strong> option is a good
-alternative to the <strong><code>hybrid</code></strong> option. Unlike
-the <strong><code>hybrid</code></strong> option, which affects the
-entire document, the <strong><code>rawAttribute</code></strong> option
+<div class="sourceCode" id="cb334"><pre
+class="sourceCode md"><code class="sourceCode markdown"><span id="cb334-1"><a href="#cb334-1" aria-hidden="true" tabindex="-1"></a><span class="an">Here is a mathematical formula:</span></span>
+<span id="cb334-2"><a href="#cb334-2" aria-hidden="true" tabindex="-1"></a><span class="in">``` {=tex}</span></span>
+<span id="cb334-3"><a href="#cb334-3" aria-hidden="true" tabindex="-1"></a><span class="in">\[distance[i] =</span></span>
+<span id="cb334-4"><a href="#cb334-4" aria-hidden="true" tabindex="-1"></a><span class="in"> \begin{dcases}</span></span>
+<span id="cb334-5"><a href="#cb334-5" aria-hidden="true" tabindex="-1"></a><span class="in"> a &amp; b \\</span></span>
+<span id="cb334-6"><a href="#cb334-6" aria-hidden="true" tabindex="-1"></a><span class="in"> c &amp; d</span></span>
+<span id="cb334-7"><a href="#cb334-7" aria-hidden="true" tabindex="-1"></a><span class="in"> \end{dcases}</span></span>
+<span id="cb334-8"><a href="#cb334-8" aria-hidden="true" tabindex="-1"></a><span class="in">\]</span></span>
+<span id="cb334-9"><a href="#cb334-9" aria-hidden="true" tabindex="-1"></a><span class="in">```</span></span></code></pre></div>
+<p>The <code><strong>rawAttribute</strong></code> option is a good
+alternative to the <code><strong>hybrid</strong></code> option. Unlike
+the <code><strong>hybrid</strong></code> option, which affects the
+entire document, the <code><strong>rawAttribute</strong></code> option
allows you to isolate the parts of your documents that use TeX:</p>
</dd>
</dl>
@@ -5738,29 +5831,29 @@ allows you to isolate the parts of your documents that use TeX:</p>
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb332"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb332-1"><a href="#cb332-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb332-2"><a href="#cb332-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[rawAttribute, fencedCode]{<span class="ex">markdown</span>}</span>
-<span id="cb332-3"><a href="#cb332-3" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">expl3</span>}</span>
-<span id="cb332-4"><a href="#cb332-4" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb332-5"><a href="#cb332-5" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb332-6"><a href="#cb332-6" aria-hidden="true" tabindex="-1"></a>`<span class="ss">$H_2 O$</span>`{=tex} is a liquid.</span>
-<span id="cb332-7"><a href="#cb332-7" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb332-8"><a href="#cb332-8" aria-hidden="true" tabindex="-1"></a>``` {=html}</span>
-<span id="cb332-9"><a href="#cb332-9" aria-hidden="true" tabindex="-1"></a>&lt;p&gt;Here is some HTML content that will be ignored.&lt;/p&gt;</span>
-<span id="cb332-10"><a href="#cb332-10" aria-hidden="true" tabindex="-1"></a>```</span>
-<span id="cb332-11"><a href="#cb332-11" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb332-12"><a href="#cb332-12" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb335"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb335-1"><a href="#cb335-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb335-2"><a href="#cb335-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[rawAttribute, fencedCode]{<span class="ex">markdown</span>}</span>
+<span id="cb335-3"><a href="#cb335-3" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">expl3</span>}</span>
+<span id="cb335-4"><a href="#cb335-4" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb335-5"><a href="#cb335-5" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb335-6"><a href="#cb335-6" aria-hidden="true" tabindex="-1"></a>`<span class="ss">$H_2 O$</span>`{=tex} is a liquid.</span>
+<span id="cb335-7"><a href="#cb335-7" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb335-8"><a href="#cb335-8" aria-hidden="true" tabindex="-1"></a>``` {=html}</span>
+<span id="cb335-9"><a href="#cb335-9" aria-hidden="true" tabindex="-1"></a>&lt;p&gt;Here is some HTML content that will be ignored.&lt;/p&gt;</span>
+<span id="cb335-10"><a href="#cb335-10" aria-hidden="true" tabindex="-1"></a>```</span>
+<span id="cb335-11"><a href="#cb335-11" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb335-12"><a href="#cb335-12" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb333"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb333-1"><a href="#cb333-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb336"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb336-1"><a href="#cb336-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
<p>H<sub>2</sub>O is a liquid.</p>
</blockquote>
-<h4 data-number="2.2.1.47" id="option-relativereferences"><span
-class="header-section-number">2.2.1.47</span> Option
+<h4 data-number="2.2.1.48" id="option-relativereferences"><span
+class="header-section-number">2.2.1.48</span> Option
<code>relativeReferences</code></h4>
<dl>
<dt><code>relativeReferences</code> (default value:
@@ -5772,14 +5865,14 @@ class="header-section-number">2.2.1.47</span> Option
<p>Enable <a
href="https://datatracker.ietf.org/doc/html/rfc3986#section-4.2">relative
references</a> in autolinks:</p>
-<div class="sourceCode" id="cb334"><pre
-class="sourceCode md"><code class="sourceCode markdown"><span id="cb334-1"><a href="#cb334-1" aria-hidden="true" tabindex="-1"></a>I conclude in Section &lt;#conclusion&gt;.</span>
-<span id="cb334-2"><a href="#cb334-2" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb334-3"><a href="#cb334-3" aria-hidden="true" tabindex="-1"></a>Conclusion {#conclusion}</span>
-<span id="cb334-4"><a href="#cb334-4" aria-hidden="true" tabindex="-1"></a><span class="fu">==========</span></span>
-<span id="cb334-5"><a href="#cb334-5" aria-hidden="true" tabindex="-1"></a>In this paper, we have discovered that most</span>
-<span id="cb334-6"><a href="#cb334-6" aria-hidden="true" tabindex="-1"></a>grandmas would rather eat dinner with their</span>
-<span id="cb334-7"><a href="#cb334-7" aria-hidden="true" tabindex="-1"></a>grandchildren than get eaten. Begone, wolf!</span></code></pre></div>
+<div class="sourceCode" id="cb337"><pre
+class="sourceCode md"><code class="sourceCode markdown"><span id="cb337-1"><a href="#cb337-1" aria-hidden="true" tabindex="-1"></a>I conclude in Section &lt;#conclusion&gt;.</span>
+<span id="cb337-2"><a href="#cb337-2" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb337-3"><a href="#cb337-3" aria-hidden="true" tabindex="-1"></a>Conclusion {#conclusion}</span>
+<span id="cb337-4"><a href="#cb337-4" aria-hidden="true" tabindex="-1"></a><span class="fu">==========</span></span>
+<span id="cb337-5"><a href="#cb337-5" aria-hidden="true" tabindex="-1"></a>In this paper, we have discovered that most</span>
+<span id="cb337-6"><a href="#cb337-6" aria-hidden="true" tabindex="-1"></a>grandmas would rather eat dinner with their</span>
+<span id="cb337-7"><a href="#cb337-7" aria-hidden="true" tabindex="-1"></a>grandchildren than get eaten. Begone, wolf!</span></code></pre></div>
</dd>
</dl>
</dd>
@@ -5796,26 +5889,26 @@ class="sourceCode md"><code class="sourceCode markdown"><span id="cb334-1"><a hr
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb335"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb335-1"><a href="#cb335-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb335-2"><a href="#cb335-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[headerAttributes, relativeReferences]{<span class="ex">markdown</span>}</span>
-<span id="cb335-3"><a href="#cb335-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb335-4"><a href="#cb335-4" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb335-5"><a href="#cb335-5" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb335-6"><a href="#cb335-6" aria-hidden="true" tabindex="-1"></a>I conclude in Section &lt;#conclusion&gt;.</span>
-<span id="cb335-7"><a href="#cb335-7" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb335-8"><a href="#cb335-8" aria-hidden="true" tabindex="-1"></a>Conclusion {#conclusion}</span>
-<span id="cb335-9"><a href="#cb335-9" aria-hidden="true" tabindex="-1"></a>==========</span>
-<span id="cb335-10"><a href="#cb335-10" aria-hidden="true" tabindex="-1"></a>In this paper, we have discovered that most</span>
-<span id="cb335-11"><a href="#cb335-11" aria-hidden="true" tabindex="-1"></a>grandmas would rather eat dinner with their</span>
-<span id="cb335-12"><a href="#cb335-12" aria-hidden="true" tabindex="-1"></a>grandchildren than get eaten. Begone, wolf!</span>
-<span id="cb335-13"><a href="#cb335-13" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb335-14"><a href="#cb335-14" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb335-15"><a href="#cb335-15" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb338"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb338-1"><a href="#cb338-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb338-2"><a href="#cb338-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[headerAttributes, relativeReferences]{<span class="ex">markdown</span>}</span>
+<span id="cb338-3"><a href="#cb338-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb338-4"><a href="#cb338-4" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb338-5"><a href="#cb338-5" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb338-6"><a href="#cb338-6" aria-hidden="true" tabindex="-1"></a>I conclude in Section &lt;#conclusion&gt;.</span>
+<span id="cb338-7"><a href="#cb338-7" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb338-8"><a href="#cb338-8" aria-hidden="true" tabindex="-1"></a>Conclusion {#conclusion}</span>
+<span id="cb338-9"><a href="#cb338-9" aria-hidden="true" tabindex="-1"></a>==========</span>
+<span id="cb338-10"><a href="#cb338-10" aria-hidden="true" tabindex="-1"></a>In this paper, we have discovered that most</span>
+<span id="cb338-11"><a href="#cb338-11" aria-hidden="true" tabindex="-1"></a>grandmas would rather eat dinner with their</span>
+<span id="cb338-12"><a href="#cb338-12" aria-hidden="true" tabindex="-1"></a>grandchildren than get eaten. Begone, wolf!</span>
+<span id="cb338-13"><a href="#cb338-13" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb338-14"><a href="#cb338-14" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb338-15"><a href="#cb338-15" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX twice from the terminal:</p>
-<div class="sourceCode" id="cb336"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb336-1"><a href="#cb336-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span>
-<span id="cb336-2"><a href="#cb336-2" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb339"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb339-1"><a href="#cb339-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span>
+<span id="cb339-2"><a href="#cb339-2" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -5824,8 +5917,8 @@ contain the following text:</p>
<p>In this paper, we have discovered that most grandmas would rather eat
dinner with their grandchildren than get eaten. Begone, wolf!</p>
</blockquote>
-<h4 data-number="2.2.1.48" id="option-shiftheadings"><span
-class="header-section-number">2.2.1.48</span> Option
+<h4 data-number="2.2.1.49" id="option-shiftheadings"><span
+class="header-section-number">2.2.1.49</span> Option
<code>shiftHeadings</code></h4>
<dl>
<dt><code>shiftHeadings</code> (default value: <code>0</code>)</dt>
@@ -5841,32 +5934,32 @@ when ⟨<em>shift amount</em>⟩ is positive, and to level 1, when
class="tex">T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>example.md</code> with the following content:</p>
-<div class="sourceCode" id="cb337"><pre
-class="sourceCode md"><code class="sourceCode markdown"><span id="cb337-1"><a href="#cb337-1" aria-hidden="true" tabindex="-1"></a><span class="fu">## A section</span></span></code></pre></div>
+<div class="sourceCode" id="cb340"><pre
+class="sourceCode md"><code class="sourceCode markdown"><span id="cb340-1"><a href="#cb340-1" aria-hidden="true" tabindex="-1"></a><span class="fu">## A section</span></span></code></pre></div>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb338"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb338-1"><a href="#cb338-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
-<span id="cb338-2"><a href="#cb338-2" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb338-3"><a href="#cb338-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\font\normal</span>=cmr10<span class="fu">\normal</span></span>
-<span id="cb338-4"><a href="#cb338-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\font\big</span>=cmr10 at 12pt</span>
-<span id="cb338-5"><a href="#cb338-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererHeadingTwo</span>#1{{<span class="fu">\big</span> #1<span class="fu">\par</span>}}</span>
-<span id="cb338-6"><a href="#cb338-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\font\bigger</span>=cmr10 scaled 1440</span>
-<span id="cb338-7"><a href="#cb338-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererHeadingOne</span>#1{{<span class="fu">\bigger</span> #1<span class="fu">\par</span>}}</span>
-<span id="cb338-8"><a href="#cb338-8" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb338-9"><a href="#cb338-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionShiftHeadings</span>{-1}</span>
-<span id="cb338-10"><a href="#cb338-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownInput</span>{example.md}</span>
-<span id="cb338-11"><a href="#cb338-11" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb338-12"><a href="#cb338-12" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionShiftHeadings</span>{0}</span>
-<span id="cb338-13"><a href="#cb338-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownInput</span>{example.md}</span>
-<span id="cb338-14"><a href="#cb338-14" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb338-15"><a href="#cb338-15" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionShiftHeadings</span>{+1}</span>
-<span id="cb338-16"><a href="#cb338-16" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownInput</span>{example.md}</span>
-<span id="cb338-17"><a href="#cb338-17" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb338-18"><a href="#cb338-18" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb341"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb341-1"><a href="#cb341-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
+<span id="cb341-2"><a href="#cb341-2" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb341-3"><a href="#cb341-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\font\normal</span>=cmr10<span class="fu">\normal</span></span>
+<span id="cb341-4"><a href="#cb341-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\font\big</span>=cmr10 at 12pt</span>
+<span id="cb341-5"><a href="#cb341-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererHeadingTwo</span>#1{{<span class="fu">\big</span> #1<span class="fu">\par</span>}}</span>
+<span id="cb341-6"><a href="#cb341-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\font\bigger</span>=cmr10 scaled 1440</span>
+<span id="cb341-7"><a href="#cb341-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererHeadingOne</span>#1{{<span class="fu">\bigger</span> #1<span class="fu">\par</span>}}</span>
+<span id="cb341-8"><a href="#cb341-8" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb341-9"><a href="#cb341-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionShiftHeadings</span>{-1}</span>
+<span id="cb341-10"><a href="#cb341-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownInput</span>{example.md}</span>
+<span id="cb341-11"><a href="#cb341-11" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb341-12"><a href="#cb341-12" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionShiftHeadings</span>{0}</span>
+<span id="cb341-13"><a href="#cb341-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownInput</span>{example.md}</span>
+<span id="cb341-14"><a href="#cb341-14" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb341-15"><a href="#cb341-15" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionShiftHeadings</span>{+1}</span>
+<span id="cb341-16"><a href="#cb341-16" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownInput</span>{example.md}</span>
+<span id="cb341-17"><a href="#cb341-17" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb341-18"><a href="#cb341-18" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb339"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb339-1"><a href="#cb339-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb342"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb342-1"><a href="#cb342-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -5878,20 +5971,20 @@ contain the following text:</p>
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb340"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb340-1"><a href="#cb340-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb340-2"><a href="#cb340-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span>
-<span id="cb340-3"><a href="#cb340-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">filecontents</span>}[overwrite,nosearch,noheader]{example.md}</span>
-<span id="cb340-4"><a href="#cb340-4" aria-hidden="true" tabindex="-1"></a>## A section</span>
-<span id="cb340-5"><a href="#cb340-5" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">filecontents</span>}</span>
-<span id="cb340-6"><a href="#cb340-6" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb340-7"><a href="#cb340-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownInput</span>[shiftHeadings=-1]{example.md}</span>
-<span id="cb340-8"><a href="#cb340-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownInput</span>{example.md}</span>
-<span id="cb340-9"><a href="#cb340-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownInput</span>[shiftHeadings=+1]{example.md}</span>
-<span id="cb340-10"><a href="#cb340-10" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb343"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb343-1"><a href="#cb343-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb343-2"><a href="#cb343-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span>
+<span id="cb343-3"><a href="#cb343-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">filecontents</span>}[overwrite,nosearch,noheader]{example.md}</span>
+<span id="cb343-4"><a href="#cb343-4" aria-hidden="true" tabindex="-1"></a>## A section</span>
+<span id="cb343-5"><a href="#cb343-5" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">filecontents</span>}</span>
+<span id="cb343-6"><a href="#cb343-6" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb343-7"><a href="#cb343-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownInput</span>[shiftHeadings=-1]{example.md}</span>
+<span id="cb343-8"><a href="#cb343-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownInput</span>{example.md}</span>
+<span id="cb343-9"><a href="#cb343-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownInput</span>[shiftHeadings=+1]{example.md}</span>
+<span id="cb343-10"><a href="#cb343-10" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb341"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb341-1"><a href="#cb341-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb344"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb344-1"><a href="#cb344-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -5903,22 +5996,22 @@ contain the following text:</p>
class="tex">T<sub>e</sub>X</span>t Example</h5>
<p>Using a text editor, create a text document named
<code>example.md</code> with the following content:</p>
-<div class="sourceCode" id="cb342"><pre
-class="sourceCode md"><code class="sourceCode markdown"><span id="cb342-1"><a href="#cb342-1" aria-hidden="true" tabindex="-1"></a><span class="fu">## A section</span></span></code></pre></div>
+<div class="sourceCode" id="cb345"><pre
+class="sourceCode md"><code class="sourceCode markdown"><span id="cb345-1"><a href="#cb345-1" aria-hidden="true" tabindex="-1"></a><span class="fu">## A section</span></span></code></pre></div>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb343"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb343-1"><a href="#cb343-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
-<span id="cb343-2"><a href="#cb343-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
-<span id="cb343-3"><a href="#cb343-3" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb343-4"><a href="#cb343-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\inputmarkdown</span>[shiftHeadings = -1]{example.md}</span>
-<span id="cb343-5"><a href="#cb343-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\inputmarkdown</span>[shiftHeadings = 0]{example.md}</span>
-<span id="cb343-6"><a href="#cb343-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\inputmarkdown</span>[shiftHeadings = +1]{example.md}</span>
-<span id="cb343-7"><a href="#cb343-7" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb343-8"><a href="#cb343-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
+<div class="sourceCode" id="cb346"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb346-1"><a href="#cb346-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
+<span id="cb346-2"><a href="#cb346-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
+<span id="cb346-3"><a href="#cb346-3" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb346-4"><a href="#cb346-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\inputmarkdown</span>[shiftHeadings = -1]{example.md}</span>
+<span id="cb346-5"><a href="#cb346-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\inputmarkdown</span>[shiftHeadings = 0]{example.md}</span>
+<span id="cb346-6"><a href="#cb346-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\inputmarkdown</span>[shiftHeadings = +1]{example.md}</span>
+<span id="cb346-7"><a href="#cb346-7" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb346-8"><a href="#cb346-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb344"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb344-1"><a href="#cb344-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb347"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb347-1"><a href="#cb347-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -5926,8 +6019,8 @@ contain the following text:</p>
<h2 id="a-section-7">A section</h2>
<h3 id="a-section-8">A section</h3>
</blockquote>
-<h4 data-number="2.2.1.49" id="option-slice"><span
-class="header-section-number">2.2.1.49</span> Option
+<h4 data-number="2.2.1.50" id="option-slice"><span
+class="header-section-number">2.2.1.50</span> Option
<code>slice</code></h4>
<dl>
<dt><code>slice</code> (default value: <code>^ $</code>)</dt>
@@ -5962,43 +6055,43 @@ i.e. the entire section with the <abbr>HTML</abbr> attribute
class="tex">T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>hamlet.md</code> with the following content:</p>
-<div class="sourceCode" id="cb345"><pre
-class="sourceCode md"><code class="sourceCode markdown"><span id="cb345-1"><a href="#cb345-1" aria-hidden="true" tabindex="-1"></a><span class="fu"># The Tragedy of Hamlet</span></span>
-<span id="cb345-2"><a href="#cb345-2" aria-hidden="true" tabindex="-1"></a>Shakespeare&#39;s longest play.</span>
-<span id="cb345-3"><a href="#cb345-3" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb345-4"><a href="#cb345-4" aria-hidden="true" tabindex="-1"></a><span class="fu">## Act III {#act-3}</span></span>
-<span id="cb345-5"><a href="#cb345-5" aria-hidden="true" tabindex="-1"></a>Hamlet kills Polonius.</span>
-<span id="cb345-6"><a href="#cb345-6" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb345-7"><a href="#cb345-7" aria-hidden="true" tabindex="-1"></a><span class="fu">## Act V {#act-5}</span></span>
-<span id="cb345-8"><a href="#cb345-8" aria-hidden="true" tabindex="-1"></a>Hamlet dies.</span>
-<span id="cb345-9"><a href="#cb345-9" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb345-10"><a href="#cb345-10" aria-hidden="true" tabindex="-1"></a><span class="fu">## Act I {#act-1}</span></span>
-<span id="cb345-11"><a href="#cb345-11" aria-hidden="true" tabindex="-1"></a>Hamlet talks to ghost.</span></code></pre></div>
+<div class="sourceCode" id="cb348"><pre
+class="sourceCode md"><code class="sourceCode markdown"><span id="cb348-1"><a href="#cb348-1" aria-hidden="true" tabindex="-1"></a><span class="fu"># The Tragedy of Hamlet</span></span>
+<span id="cb348-2"><a href="#cb348-2" aria-hidden="true" tabindex="-1"></a>Shakespeare&#39;s longest play.</span>
+<span id="cb348-3"><a href="#cb348-3" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb348-4"><a href="#cb348-4" aria-hidden="true" tabindex="-1"></a><span class="fu">## Act III {#act-3}</span></span>
+<span id="cb348-5"><a href="#cb348-5" aria-hidden="true" tabindex="-1"></a>Hamlet kills Polonius.</span>
+<span id="cb348-6"><a href="#cb348-6" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb348-7"><a href="#cb348-7" aria-hidden="true" tabindex="-1"></a><span class="fu">## Act V {#act-5}</span></span>
+<span id="cb348-8"><a href="#cb348-8" aria-hidden="true" tabindex="-1"></a>Hamlet dies.</span>
+<span id="cb348-9"><a href="#cb348-9" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb348-10"><a href="#cb348-10" aria-hidden="true" tabindex="-1"></a><span class="fu">## Act I {#act-1}</span></span>
+<span id="cb348-11"><a href="#cb348-11" aria-hidden="true" tabindex="-1"></a>Hamlet talks to ghost.</span></code></pre></div>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb346"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb346-1"><a href="#cb346-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
-<span id="cb346-2"><a href="#cb346-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionHeaderAttributes</span>{true}</span>
-<span id="cb346-3"><a href="#cb346-3" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb346-4"><a href="#cb346-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\font\normal</span>=cmr10<span class="fu">\normal</span></span>
-<span id="cb346-5"><a href="#cb346-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\font\big</span>=cmr10 at 12pt</span>
-<span id="cb346-6"><a href="#cb346-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererHeadingTwo</span>#1{{<span class="fu">\big</span> #1<span class="fu">\par</span>}}</span>
-<span id="cb346-7"><a href="#cb346-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\font\bigger</span>=cmr10 scaled 1440</span>
-<span id="cb346-8"><a href="#cb346-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererHeadingOne</span>#1{{<span class="fu">\bigger</span> #1<span class="fu">\par</span>}}</span>
-<span id="cb346-9"><a href="#cb346-9" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb346-10"><a href="#cb346-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionSlice</span>{^ ^act-3}</span>
-<span id="cb346-11"><a href="#cb346-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownInput</span>{hamlet.md}</span>
-<span id="cb346-12"><a href="#cb346-12" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb346-13"><a href="#cb346-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionSlice</span>{act-1}</span>
-<span id="cb346-14"><a href="#cb346-14" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownInput</span>{hamlet.md}</span>
-<span id="cb346-15"><a href="#cb346-15" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb346-16"><a href="#cb346-16" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionSlice</span>{act-3 act-5}</span>
-<span id="cb346-17"><a href="#cb346-17" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownInput</span>{hamlet.md}</span>
-<span id="cb346-18"><a href="#cb346-18" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb346-19"><a href="#cb346-19" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb349"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb349-1"><a href="#cb349-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
+<span id="cb349-2"><a href="#cb349-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionHeaderAttributes</span>{true}</span>
+<span id="cb349-3"><a href="#cb349-3" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb349-4"><a href="#cb349-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\font\normal</span>=cmr10<span class="fu">\normal</span></span>
+<span id="cb349-5"><a href="#cb349-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\font\big</span>=cmr10 at 12pt</span>
+<span id="cb349-6"><a href="#cb349-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererHeadingTwo</span>#1{{<span class="fu">\big</span> #1<span class="fu">\par</span>}}</span>
+<span id="cb349-7"><a href="#cb349-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\font\bigger</span>=cmr10 scaled 1440</span>
+<span id="cb349-8"><a href="#cb349-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererHeadingOne</span>#1{{<span class="fu">\bigger</span> #1<span class="fu">\par</span>}}</span>
+<span id="cb349-9"><a href="#cb349-9" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb349-10"><a href="#cb349-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionSlice</span>{^ ^act-3}</span>
+<span id="cb349-11"><a href="#cb349-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownInput</span>{hamlet.md}</span>
+<span id="cb349-12"><a href="#cb349-12" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb349-13"><a href="#cb349-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionSlice</span>{act-1}</span>
+<span id="cb349-14"><a href="#cb349-14" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownInput</span>{hamlet.md}</span>
+<span id="cb349-15"><a href="#cb349-15" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb349-16"><a href="#cb349-16" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionSlice</span>{act-3 act-5}</span>
+<span id="cb349-17"><a href="#cb349-17" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownInput</span>{hamlet.md}</span>
+<span id="cb349-18"><a href="#cb349-18" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb349-19"><a href="#cb349-19" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb347"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb347-1"><a href="#cb347-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb350"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb350-1"><a href="#cb350-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -6015,30 +6108,30 @@ contain the following text:</p>
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb348"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb348-1"><a href="#cb348-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb348-2"><a href="#cb348-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[headerAttributes]{<span class="ex">markdown</span>}</span>
-<span id="cb348-3"><a href="#cb348-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">filecontents</span>}[overwrite,nosearch,noheader]{hamlet.md}</span>
-<span id="cb348-4"><a href="#cb348-4" aria-hidden="true" tabindex="-1"></a># The Tragedy of Hamlet</span>
-<span id="cb348-5"><a href="#cb348-5" aria-hidden="true" tabindex="-1"></a>Shakespeare&#39;s longest play.</span>
-<span id="cb348-6"><a href="#cb348-6" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb348-7"><a href="#cb348-7" aria-hidden="true" tabindex="-1"></a>## Act III {#act-3}</span>
-<span id="cb348-8"><a href="#cb348-8" aria-hidden="true" tabindex="-1"></a>Hamlet kills Polonius.</span>
-<span id="cb348-9"><a href="#cb348-9" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb348-10"><a href="#cb348-10" aria-hidden="true" tabindex="-1"></a>## Act V {#act-5}</span>
-<span id="cb348-11"><a href="#cb348-11" aria-hidden="true" tabindex="-1"></a>Hamlet dies.</span>
-<span id="cb348-12"><a href="#cb348-12" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb348-13"><a href="#cb348-13" aria-hidden="true" tabindex="-1"></a>## Act I {#act-1}</span>
-<span id="cb348-14"><a href="#cb348-14" aria-hidden="true" tabindex="-1"></a>Hamlet talks to ghost.</span>
-<span id="cb348-15"><a href="#cb348-15" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">filecontents</span>}</span>
-<span id="cb348-16"><a href="#cb348-16" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb348-17"><a href="#cb348-17" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownInput</span>[slice=^ ^act-3]{hamlet.md}</span>
-<span id="cb348-18"><a href="#cb348-18" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownInput</span>[slice=act-1]{hamlet.md}</span>
-<span id="cb348-19"><a href="#cb348-19" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownInput</span>[slice=act-3 act-5]{hamlet.md}</span>
-<span id="cb348-20"><a href="#cb348-20" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb351"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb351-1"><a href="#cb351-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb351-2"><a href="#cb351-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[headerAttributes]{<span class="ex">markdown</span>}</span>
+<span id="cb351-3"><a href="#cb351-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">filecontents</span>}[overwrite,nosearch,noheader]{hamlet.md}</span>
+<span id="cb351-4"><a href="#cb351-4" aria-hidden="true" tabindex="-1"></a># The Tragedy of Hamlet</span>
+<span id="cb351-5"><a href="#cb351-5" aria-hidden="true" tabindex="-1"></a>Shakespeare&#39;s longest play.</span>
+<span id="cb351-6"><a href="#cb351-6" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb351-7"><a href="#cb351-7" aria-hidden="true" tabindex="-1"></a>## Act III {#act-3}</span>
+<span id="cb351-8"><a href="#cb351-8" aria-hidden="true" tabindex="-1"></a>Hamlet kills Polonius.</span>
+<span id="cb351-9"><a href="#cb351-9" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb351-10"><a href="#cb351-10" aria-hidden="true" tabindex="-1"></a>## Act V {#act-5}</span>
+<span id="cb351-11"><a href="#cb351-11" aria-hidden="true" tabindex="-1"></a>Hamlet dies.</span>
+<span id="cb351-12"><a href="#cb351-12" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb351-13"><a href="#cb351-13" aria-hidden="true" tabindex="-1"></a>## Act I {#act-1}</span>
+<span id="cb351-14"><a href="#cb351-14" aria-hidden="true" tabindex="-1"></a>Hamlet talks to ghost.</span>
+<span id="cb351-15"><a href="#cb351-15" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">filecontents</span>}</span>
+<span id="cb351-16"><a href="#cb351-16" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb351-17"><a href="#cb351-17" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownInput</span>[slice=^ ^act-3]{hamlet.md}</span>
+<span id="cb351-18"><a href="#cb351-18" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownInput</span>[slice=act-1]{hamlet.md}</span>
+<span id="cb351-19"><a href="#cb351-19" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownInput</span>[slice=act-3 act-5]{hamlet.md}</span>
+<span id="cb351-20"><a href="#cb351-20" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb349"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb349-1"><a href="#cb349-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb352"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb352-1"><a href="#cb352-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -6055,33 +6148,33 @@ contain the following text:</p>
class="tex">T<sub>e</sub>X</span>t Example</h5>
<p>Using a text editor, create a text document named
<code>hamlet.md</code> with the following content:</p>
-<div class="sourceCode" id="cb350"><pre
-class="sourceCode md"><code class="sourceCode markdown"><span id="cb350-1"><a href="#cb350-1" aria-hidden="true" tabindex="-1"></a><span class="fu"># The Tragedy of Hamlet</span></span>
-<span id="cb350-2"><a href="#cb350-2" aria-hidden="true" tabindex="-1"></a>Shakespeare&#39;s longest play.</span>
-<span id="cb350-3"><a href="#cb350-3" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb350-4"><a href="#cb350-4" aria-hidden="true" tabindex="-1"></a><span class="fu">## Act III {#act-3}</span></span>
-<span id="cb350-5"><a href="#cb350-5" aria-hidden="true" tabindex="-1"></a>Hamlet kills Polonius.</span>
-<span id="cb350-6"><a href="#cb350-6" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb350-7"><a href="#cb350-7" aria-hidden="true" tabindex="-1"></a><span class="fu">## Act V {#act-5}</span></span>
-<span id="cb350-8"><a href="#cb350-8" aria-hidden="true" tabindex="-1"></a>Hamlet dies.</span>
-<span id="cb350-9"><a href="#cb350-9" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb350-10"><a href="#cb350-10" aria-hidden="true" tabindex="-1"></a><span class="fu">## Act I {#act-1}</span></span>
-<span id="cb350-11"><a href="#cb350-11" aria-hidden="true" tabindex="-1"></a>Hamlet talks to ghost.</span></code></pre></div>
+<div class="sourceCode" id="cb353"><pre
+class="sourceCode md"><code class="sourceCode markdown"><span id="cb353-1"><a href="#cb353-1" aria-hidden="true" tabindex="-1"></a><span class="fu"># The Tragedy of Hamlet</span></span>
+<span id="cb353-2"><a href="#cb353-2" aria-hidden="true" tabindex="-1"></a>Shakespeare&#39;s longest play.</span>
+<span id="cb353-3"><a href="#cb353-3" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb353-4"><a href="#cb353-4" aria-hidden="true" tabindex="-1"></a><span class="fu">## Act III {#act-3}</span></span>
+<span id="cb353-5"><a href="#cb353-5" aria-hidden="true" tabindex="-1"></a>Hamlet kills Polonius.</span>
+<span id="cb353-6"><a href="#cb353-6" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb353-7"><a href="#cb353-7" aria-hidden="true" tabindex="-1"></a><span class="fu">## Act V {#act-5}</span></span>
+<span id="cb353-8"><a href="#cb353-8" aria-hidden="true" tabindex="-1"></a>Hamlet dies.</span>
+<span id="cb353-9"><a href="#cb353-9" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb353-10"><a href="#cb353-10" aria-hidden="true" tabindex="-1"></a><span class="fu">## Act I {#act-1}</span></span>
+<span id="cb353-11"><a href="#cb353-11" aria-hidden="true" tabindex="-1"></a>Hamlet talks to ghost.</span></code></pre></div>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb351"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb351-1"><a href="#cb351-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
-<span id="cb351-2"><a href="#cb351-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[headerAttributes = yes]</span>
-<span id="cb351-3"><a href="#cb351-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
-<span id="cb351-4"><a href="#cb351-4" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb351-5"><a href="#cb351-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\inputmarkdown</span>[slice = ^ ^act-3]{example.md}</span>
-<span id="cb351-6"><a href="#cb351-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\inputmarkdown</span>[slice = act-1]{example.md}</span>
-<span id="cb351-7"><a href="#cb351-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\inputmarkdown</span>[slice = act-3 act-5]{example.md}</span>
-<span id="cb351-8"><a href="#cb351-8" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb351-9"><a href="#cb351-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
+<div class="sourceCode" id="cb354"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb354-1"><a href="#cb354-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
+<span id="cb354-2"><a href="#cb354-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[headerAttributes = yes]</span>
+<span id="cb354-3"><a href="#cb354-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
+<span id="cb354-4"><a href="#cb354-4" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb354-5"><a href="#cb354-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\inputmarkdown</span>[slice = ^ ^act-3]{example.md}</span>
+<span id="cb354-6"><a href="#cb354-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\inputmarkdown</span>[slice = act-1]{example.md}</span>
+<span id="cb354-7"><a href="#cb354-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\inputmarkdown</span>[slice = act-3 act-5]{example.md}</span>
+<span id="cb354-8"><a href="#cb354-8" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb354-9"><a href="#cb354-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb352"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb352-1"><a href="#cb352-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb355"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb355-1"><a href="#cb355-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -6094,8 +6187,8 @@ contain the following text:</p>
<h2 id="act-v-2">Act V</h2>
<p>Hamlet dies.</p>
</blockquote>
-<h4 data-number="2.2.1.50" id="option-smartellipses"><span
-class="header-section-number">2.2.1.50</span> Option
+<h4 data-number="2.2.1.51" id="option-smartellipses"><span
+class="header-section-number">2.2.1.51</span> Option
<code>smartEllipses</code></h4>
<dl>
<dt><code>smartEllipses</code> (default value: <code>false</code>)</dt>
@@ -6104,7 +6197,7 @@ class="header-section-number">2.2.1.50</span> Option
<dt>true</dt>
<dd>
<p>Convert any ellipses in the input to the
-<code>\markdownRendererEllipsis</code> <span
+<code>markdownRendererEllipsis</code> <span
class="tex">T<sub>e</sub>X</span> macro.</p>
</dd>
</dl>
@@ -6122,29 +6215,29 @@ class="tex">T<sub>e</sub>X</span> macro.</p>
Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb353"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb353-1"><a href="#cb353-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
-<span id="cb353-2"><a href="#cb353-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> lmfonts</span>
-<span id="cb353-3"><a href="#cb353-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererEllipsis</span>{. . .}</span>
-<span id="cb353-4"><a href="#cb353-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\begingroup</span></span>
-<span id="cb353-5"><a href="#cb353-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\catcode</span>`<span class="fu">\%</span>=12</span>
-<span id="cb353-6"><a href="#cb353-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\catcode</span>`<span class="fu">\#</span>=12</span>
-<span id="cb353-7"><a href="#cb353-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\directlua</span>{</span>
-<span id="cb353-8"><a href="#cb353-8" aria-hidden="true" tabindex="-1"></a> local markdown = require(&quot;markdown&quot;)</span>
-<span id="cb353-9"><a href="#cb353-9" aria-hidden="true" tabindex="-1"></a> local convert = markdown.new()</span>
-<span id="cb353-10"><a href="#cb353-10" aria-hidden="true" tabindex="-1"></a> local input = &quot;These are just three regular dots ...&quot;</span>
-<span id="cb353-11"><a href="#cb353-11" aria-hidden="true" tabindex="-1"></a> tex.sprint(convert(input)) }</span>
-<span id="cb353-12"><a href="#cb353-12" aria-hidden="true" tabindex="-1"></a><span class="fu">\par</span></span>
-<span id="cb353-13"><a href="#cb353-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\directlua</span>{</span>
-<span id="cb353-14"><a href="#cb353-14" aria-hidden="true" tabindex="-1"></a> local markdown = require(&quot;markdown&quot;)</span>
-<span id="cb353-15"><a href="#cb353-15" aria-hidden="true" tabindex="-1"></a> local convert = markdown.new({smartEllipses = true})</span>
-<span id="cb353-16"><a href="#cb353-16" aria-hidden="true" tabindex="-1"></a> local input = &quot;... and this is a victorian ellipsis.&quot;</span>
-<span id="cb353-17"><a href="#cb353-17" aria-hidden="true" tabindex="-1"></a> tex.sprint(convert(input)) }</span>
-<span id="cb353-18"><a href="#cb353-18" aria-hidden="true" tabindex="-1"></a><span class="fu">\endgroup</span></span>
-<span id="cb353-19"><a href="#cb353-19" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb356"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb356-1"><a href="#cb356-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
+<span id="cb356-2"><a href="#cb356-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> lmfonts</span>
+<span id="cb356-3"><a href="#cb356-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererEllipsis</span>{. . .}</span>
+<span id="cb356-4"><a href="#cb356-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\begingroup</span></span>
+<span id="cb356-5"><a href="#cb356-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\catcode</span>`<span class="fu">\%</span>=12</span>
+<span id="cb356-6"><a href="#cb356-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\catcode</span>`<span class="fu">\#</span>=12</span>
+<span id="cb356-7"><a href="#cb356-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\directlua</span>{</span>
+<span id="cb356-8"><a href="#cb356-8" aria-hidden="true" tabindex="-1"></a> local markdown = require(&quot;markdown&quot;)</span>
+<span id="cb356-9"><a href="#cb356-9" aria-hidden="true" tabindex="-1"></a> local convert = markdown.new()</span>
+<span id="cb356-10"><a href="#cb356-10" aria-hidden="true" tabindex="-1"></a> local input = &quot;These are just three regular dots ...&quot;</span>
+<span id="cb356-11"><a href="#cb356-11" aria-hidden="true" tabindex="-1"></a> tex.sprint(convert(input)) }</span>
+<span id="cb356-12"><a href="#cb356-12" aria-hidden="true" tabindex="-1"></a><span class="fu">\par</span></span>
+<span id="cb356-13"><a href="#cb356-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\directlua</span>{</span>
+<span id="cb356-14"><a href="#cb356-14" aria-hidden="true" tabindex="-1"></a> local markdown = require(&quot;markdown&quot;)</span>
+<span id="cb356-15"><a href="#cb356-15" aria-hidden="true" tabindex="-1"></a> local convert = markdown.new({smartEllipses = true})</span>
+<span id="cb356-16"><a href="#cb356-16" aria-hidden="true" tabindex="-1"></a> local input = &quot;... and this is a victorian ellipsis.&quot;</span>
+<span id="cb356-17"><a href="#cb356-17" aria-hidden="true" tabindex="-1"></a> tex.sprint(convert(input)) }</span>
+<span id="cb356-18"><a href="#cb356-18" aria-hidden="true" tabindex="-1"></a><span class="fu">\endgroup</span></span>
+<span id="cb356-19"><a href="#cb356-19" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Then, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb354"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb354-1"><a href="#cb354-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb357"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb357-1"><a href="#cb357-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -6154,27 +6247,27 @@ contain the following text:</p>
<h5 class="unnumbered" id="lua-cli-example-11">Lua CLI Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb355"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb355-1"><a href="#cb355-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
-<span id="cb355-2"><a href="#cb355-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> lmfonts</span>
-<span id="cb355-3"><a href="#cb355-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererEllipsis</span>{. . .}</span>
-<span id="cb355-4"><a href="#cb355-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\begingroup</span></span>
-<span id="cb355-5"><a href="#cb355-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\catcode</span>`<span class="fu">\%</span>=12</span>
-<span id="cb355-6"><a href="#cb355-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\catcode</span>`<span class="fu">\#</span>=12</span>
-<span id="cb355-7"><a href="#cb355-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> optionfalse</span>
-<span id="cb355-8"><a href="#cb355-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\par</span></span>
-<span id="cb355-9"><a href="#cb355-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> optiontrue</span>
-<span id="cb355-10"><a href="#cb355-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\endgroup</span></span>
-<span id="cb355-11"><a href="#cb355-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb358"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb358-1"><a href="#cb358-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
+<span id="cb358-2"><a href="#cb358-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> lmfonts</span>
+<span id="cb358-3"><a href="#cb358-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererEllipsis</span>{. . .}</span>
+<span id="cb358-4"><a href="#cb358-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\begingroup</span></span>
+<span id="cb358-5"><a href="#cb358-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\catcode</span>`<span class="fu">\%</span>=12</span>
+<span id="cb358-6"><a href="#cb358-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\catcode</span>`<span class="fu">\#</span>=12</span>
+<span id="cb358-7"><a href="#cb358-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> optionfalse</span>
+<span id="cb358-8"><a href="#cb358-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\par</span></span>
+<span id="cb358-9"><a href="#cb358-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> optiontrue</span>
+<span id="cb358-10"><a href="#cb358-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\endgroup</span></span>
+<span id="cb358-11"><a href="#cb358-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Using a text editor, create a text document named
<code>content.md</code> with the following content:</p>
-<div class="sourceCode" id="cb356"><pre
-class="sourceCode md"><code class="sourceCode markdown"><span id="cb356-1"><a href="#cb356-1" aria-hidden="true" tabindex="-1"></a>Are these just three regular dots, a victorian ellipsis, or ... ?</span></code></pre></div>
+<div class="sourceCode" id="cb359"><pre
+class="sourceCode md"><code class="sourceCode markdown"><span id="cb359-1"><a href="#cb359-1" aria-hidden="true" tabindex="-1"></a>Are these just three regular dots, a victorian ellipsis, or ... ?</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb357"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb357-1"><a href="#cb357-1" aria-hidden="true" tabindex="-1"></a><span class="ex">texlua</span> ⟨CLI pathname⟩ <span class="at">--</span> content.md optionfalse.tex</span>
-<span id="cb357-2"><a href="#cb357-2" aria-hidden="true" tabindex="-1"></a><span class="ex">texlua</span> ⟨CLI pathname⟩ smartEllipses=true <span class="at">--</span> content.md optiontrue.tex</span>
-<span id="cb357-3"><a href="#cb357-3" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb360"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb360-1"><a href="#cb360-1" aria-hidden="true" tabindex="-1"></a><span class="ex">texlua</span> ⟨CLI pathname⟩ <span class="at">--</span> content.md optionfalse.tex</span>
+<span id="cb360-2"><a href="#cb360-2" aria-hidden="true" tabindex="-1"></a><span class="ex">texlua</span> ⟨CLI pathname⟩ smartEllipses=true <span class="at">--</span> content.md optiontrue.tex</span>
+<span id="cb360-3"><a href="#cb360-3" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
<p>where ⟨<em>CLI pathname</em>⟩ corresponds to the location of the Lua
CLI script file, such as
<code>~/texmf/scripts/markdown/markdown-cli.lua</code> on UN*X systems
@@ -6195,23 +6288,23 @@ contain the following text:</p>
class="tex">T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb358"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb358-1"><a href="#cb358-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
-<span id="cb358-2"><a href="#cb358-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererEllipsis</span>{. . .}</span>
-<span id="cb358-3"><a href="#cb358-3" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb358-4"><a href="#cb358-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
-<span id="cb358-5"><a href="#cb358-5" aria-hidden="true" tabindex="-1"></a>These are just three regular dots ...</span>
-<span id="cb358-6"><a href="#cb358-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
-<span id="cb358-7"><a href="#cb358-7" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb358-8"><a href="#cb358-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionSmartEllipses</span>{true}</span>
-<span id="cb358-9"><a href="#cb358-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
-<span id="cb358-10"><a href="#cb358-10" aria-hidden="true" tabindex="-1"></a>... and this is a victorian ellipsis.</span>
-<span id="cb358-11"><a href="#cb358-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
-<span id="cb358-12"><a href="#cb358-12" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb358-13"><a href="#cb358-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb361"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb361-1"><a href="#cb361-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
+<span id="cb361-2"><a href="#cb361-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererEllipsis</span>{. . .}</span>
+<span id="cb361-3"><a href="#cb361-3" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb361-4"><a href="#cb361-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
+<span id="cb361-5"><a href="#cb361-5" aria-hidden="true" tabindex="-1"></a>These are just three regular dots ...</span>
+<span id="cb361-6"><a href="#cb361-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
+<span id="cb361-7"><a href="#cb361-7" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb361-8"><a href="#cb361-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionSmartEllipses</span>{true}</span>
+<span id="cb361-9"><a href="#cb361-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
+<span id="cb361-10"><a href="#cb361-10" aria-hidden="true" tabindex="-1"></a>... and this is a victorian ellipsis.</span>
+<span id="cb361-11"><a href="#cb361-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
+<span id="cb361-12"><a href="#cb361-12" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb361-13"><a href="#cb361-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb359"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb359-1"><a href="#cb359-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb362"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb362-1"><a href="#cb362-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -6222,28 +6315,28 @@ contain the following text:</p>
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb360"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb360-1"><a href="#cb360-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb360-2"><a href="#cb360-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span>
-<span id="cb360-3"><a href="#cb360-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb360-4"><a href="#cb360-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb360-5"><a href="#cb360-5" aria-hidden="true" tabindex="-1"></a> ellipsis = {. . .}</span>
-<span id="cb360-6"><a href="#cb360-6" aria-hidden="true" tabindex="-1"></a> }</span>
-<span id="cb360-7"><a href="#cb360-7" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb360-8"><a href="#cb360-8" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb360-9"><a href="#cb360-9" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb360-10"><a href="#cb360-10" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb360-11"><a href="#cb360-11" aria-hidden="true" tabindex="-1"></a>These are just three regular dots ...</span>
-<span id="cb360-12"><a href="#cb360-12" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb360-13"><a href="#cb360-13" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb360-14"><a href="#cb360-14" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}[smartEllipses]</span>
-<span id="cb360-15"><a href="#cb360-15" aria-hidden="true" tabindex="-1"></a>... and this is a victorian ellipsis.</span>
-<span id="cb360-16"><a href="#cb360-16" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb360-17"><a href="#cb360-17" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb360-18"><a href="#cb360-18" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb363"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb363-1"><a href="#cb363-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb363-2"><a href="#cb363-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span>
+<span id="cb363-3"><a href="#cb363-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb363-4"><a href="#cb363-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb363-5"><a href="#cb363-5" aria-hidden="true" tabindex="-1"></a> ellipsis = {. . .}</span>
+<span id="cb363-6"><a href="#cb363-6" aria-hidden="true" tabindex="-1"></a> }</span>
+<span id="cb363-7"><a href="#cb363-7" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb363-8"><a href="#cb363-8" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb363-9"><a href="#cb363-9" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb363-10"><a href="#cb363-10" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb363-11"><a href="#cb363-11" aria-hidden="true" tabindex="-1"></a>These are just three regular dots ...</span>
+<span id="cb363-12"><a href="#cb363-12" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb363-13"><a href="#cb363-13" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb363-14"><a href="#cb363-14" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}[smartEllipses]</span>
+<span id="cb363-15"><a href="#cb363-15" aria-hidden="true" tabindex="-1"></a>... and this is a victorian ellipsis.</span>
+<span id="cb363-16"><a href="#cb363-16" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb363-17"><a href="#cb363-17" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb363-18"><a href="#cb363-18" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb361"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb361-1"><a href="#cb361-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb364"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb364-1"><a href="#cb364-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -6254,32 +6347,32 @@ contain the following text:</p>
class="tex">T<sub>e</sub>X</span>t Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb362"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb362-1"><a href="#cb362-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
-<span id="cb362-2"><a href="#cb362-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererEllipsis</span>{. . .}</span>
-<span id="cb362-3"><a href="#cb362-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
-<span id="cb362-4"><a href="#cb362-4" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb362-5"><a href="#cb362-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb362-6"><a href="#cb362-6" aria-hidden="true" tabindex="-1"></a>These are just three regular dots ...</span>
-<span id="cb362-7"><a href="#cb362-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb362-8"><a href="#cb362-8" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb362-9"><a href="#cb362-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[smartEllipses = yes]</span>
-<span id="cb362-10"><a href="#cb362-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb362-11"><a href="#cb362-11" aria-hidden="true" tabindex="-1"></a>... and this is a victorian ellipsis.</span>
-<span id="cb362-12"><a href="#cb362-12" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb362-13"><a href="#cb362-13" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb362-14"><a href="#cb362-14" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
+<div class="sourceCode" id="cb365"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb365-1"><a href="#cb365-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
+<span id="cb365-2"><a href="#cb365-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererEllipsis</span>{. . .}</span>
+<span id="cb365-3"><a href="#cb365-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
+<span id="cb365-4"><a href="#cb365-4" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb365-5"><a href="#cb365-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb365-6"><a href="#cb365-6" aria-hidden="true" tabindex="-1"></a>These are just three regular dots ...</span>
+<span id="cb365-7"><a href="#cb365-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb365-8"><a href="#cb365-8" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb365-9"><a href="#cb365-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[smartEllipses = yes]</span>
+<span id="cb365-10"><a href="#cb365-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb365-11"><a href="#cb365-11" aria-hidden="true" tabindex="-1"></a>... and this is a victorian ellipsis.</span>
+<span id="cb365-12"><a href="#cb365-12" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb365-13"><a href="#cb365-13" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb365-14"><a href="#cb365-14" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb363"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb363-1"><a href="#cb363-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb366"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb366-1"><a href="#cb366-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
<p>These are just three regular dots …</p>
<p>. . . and this is a victorian ellipsis.</p>
</blockquote>
-<h4 data-number="2.2.1.51" id="option-startnumber"><span
-class="header-section-number">2.2.1.51</span> Option
+<h4 data-number="2.2.1.52" id="option-startnumber"><span
+class="header-section-number">2.2.1.52</span> Option
<code>startNumber</code></h4>
<dl>
<dt><code>startNumber</code> (default value: <code>true</code>)</dt>
@@ -6289,7 +6382,7 @@ class="header-section-number">2.2.1.51</span> Option
<dd>
<p>Make the number in the first item of an ordered lists significant.
The item numbers will be passed to the
-<code>\markdownRendererOlItemWithNumber</code> <span
+<code>markdownRendererOlItemWithNumber</code> <span
class="tex">T<sub>e</sub>X</span> macro.</p>
</dd>
</dl>
@@ -6299,7 +6392,7 @@ class="tex">T<sub>e</sub>X</span> macro.</p>
<dt>false</dt>
<dd>
<p>Ignore the numbers in the ordered list items. Each item will only
-produce a <code>\markdownRendererOlItem</code> <span
+produce a <code>markdownRendererOlItem</code> <span
class="tex">T<sub>e</sub>X</span> macro.</p>
</dd>
</dl>
@@ -6309,32 +6402,32 @@ class="tex">T<sub>e</sub>X</span> macro.</p>
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb364"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb364-1"><a href="#cb364-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb364-2"><a href="#cb364-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span>
-<span id="cb364-3"><a href="#cb364-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb364-4"><a href="#cb364-4" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb364-5"><a href="#cb364-5" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb364-6"><a href="#cb364-6" aria-hidden="true" tabindex="-1"></a>The following list respects the numbers specified in the markup:</span>
-<span id="cb364-7"><a href="#cb364-7" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb364-8"><a href="#cb364-8" aria-hidden="true" tabindex="-1"></a>3. third item</span>
-<span id="cb364-9"><a href="#cb364-9" aria-hidden="true" tabindex="-1"></a>4. fourth item</span>
-<span id="cb364-10"><a href="#cb364-10" aria-hidden="true" tabindex="-1"></a>5. fifth item</span>
-<span id="cb364-11"><a href="#cb364-11" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb364-12"><a href="#cb364-12" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb364-13"><a href="#cb364-13" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}[startNumber=false]</span>
-<span id="cb364-14"><a href="#cb364-14" aria-hidden="true" tabindex="-1"></a>The following list does not respect the numbers specified in the</span>
-<span id="cb364-15"><a href="#cb364-15" aria-hidden="true" tabindex="-1"></a>markup:</span>
-<span id="cb364-16"><a href="#cb364-16" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb364-17"><a href="#cb364-17" aria-hidden="true" tabindex="-1"></a>3. third item</span>
-<span id="cb364-18"><a href="#cb364-18" aria-hidden="true" tabindex="-1"></a>4. fourth item</span>
-<span id="cb364-19"><a href="#cb364-19" aria-hidden="true" tabindex="-1"></a>5. fifth item</span>
-<span id="cb364-20"><a href="#cb364-20" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb364-21"><a href="#cb364-21" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb364-22"><a href="#cb364-22" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb367"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb367-1"><a href="#cb367-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb367-2"><a href="#cb367-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span>
+<span id="cb367-3"><a href="#cb367-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb367-4"><a href="#cb367-4" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb367-5"><a href="#cb367-5" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb367-6"><a href="#cb367-6" aria-hidden="true" tabindex="-1"></a>The following list respects the numbers specified in the markup:</span>
+<span id="cb367-7"><a href="#cb367-7" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb367-8"><a href="#cb367-8" aria-hidden="true" tabindex="-1"></a>3. third item</span>
+<span id="cb367-9"><a href="#cb367-9" aria-hidden="true" tabindex="-1"></a>4. fourth item</span>
+<span id="cb367-10"><a href="#cb367-10" aria-hidden="true" tabindex="-1"></a>5. fifth item</span>
+<span id="cb367-11"><a href="#cb367-11" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb367-12"><a href="#cb367-12" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb367-13"><a href="#cb367-13" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}[startNumber=false]</span>
+<span id="cb367-14"><a href="#cb367-14" aria-hidden="true" tabindex="-1"></a>The following list does not respect the numbers specified in the</span>
+<span id="cb367-15"><a href="#cb367-15" aria-hidden="true" tabindex="-1"></a>markup:</span>
+<span id="cb367-16"><a href="#cb367-16" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb367-17"><a href="#cb367-17" aria-hidden="true" tabindex="-1"></a>3. third item</span>
+<span id="cb367-18"><a href="#cb367-18" aria-hidden="true" tabindex="-1"></a>4. fourth item</span>
+<span id="cb367-19"><a href="#cb367-19" aria-hidden="true" tabindex="-1"></a>5. fifth item</span>
+<span id="cb367-20"><a href="#cb367-20" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb367-21"><a href="#cb367-21" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb367-22"><a href="#cb367-22" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb365"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb365-1"><a href="#cb365-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb368"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb368-1"><a href="#cb368-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -6356,30 +6449,30 @@ markup:</p>
class="tex">T<sub>e</sub>X</span>t Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb366"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb366-1"><a href="#cb366-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
-<span id="cb366-2"><a href="#cb366-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
-<span id="cb366-3"><a href="#cb366-3" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb366-4"><a href="#cb366-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb366-5"><a href="#cb366-5" aria-hidden="true" tabindex="-1"></a>The following list respects the numbers specified in the markup:</span>
-<span id="cb366-6"><a href="#cb366-6" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb366-7"><a href="#cb366-7" aria-hidden="true" tabindex="-1"></a>3. third item</span>
-<span id="cb366-8"><a href="#cb366-8" aria-hidden="true" tabindex="-1"></a>4. fourth item</span>
-<span id="cb366-9"><a href="#cb366-9" aria-hidden="true" tabindex="-1"></a>5. fifth item</span>
-<span id="cb366-10"><a href="#cb366-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb366-11"><a href="#cb366-11" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb366-12"><a href="#cb366-12" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[startNumber = no]</span>
-<span id="cb366-13"><a href="#cb366-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb366-14"><a href="#cb366-14" aria-hidden="true" tabindex="-1"></a>The following list respects the numbers specified in the markup:</span>
-<span id="cb366-15"><a href="#cb366-15" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb366-16"><a href="#cb366-16" aria-hidden="true" tabindex="-1"></a>3. third item</span>
-<span id="cb366-17"><a href="#cb366-17" aria-hidden="true" tabindex="-1"></a>4. fourth item</span>
-<span id="cb366-18"><a href="#cb366-18" aria-hidden="true" tabindex="-1"></a>5. fifth item</span>
-<span id="cb366-19"><a href="#cb366-19" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb366-20"><a href="#cb366-20" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
+<div class="sourceCode" id="cb369"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb369-1"><a href="#cb369-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
+<span id="cb369-2"><a href="#cb369-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
+<span id="cb369-3"><a href="#cb369-3" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb369-4"><a href="#cb369-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb369-5"><a href="#cb369-5" aria-hidden="true" tabindex="-1"></a>The following list respects the numbers specified in the markup:</span>
+<span id="cb369-6"><a href="#cb369-6" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb369-7"><a href="#cb369-7" aria-hidden="true" tabindex="-1"></a>3. third item</span>
+<span id="cb369-8"><a href="#cb369-8" aria-hidden="true" tabindex="-1"></a>4. fourth item</span>
+<span id="cb369-9"><a href="#cb369-9" aria-hidden="true" tabindex="-1"></a>5. fifth item</span>
+<span id="cb369-10"><a href="#cb369-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb369-11"><a href="#cb369-11" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb369-12"><a href="#cb369-12" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[startNumber = no]</span>
+<span id="cb369-13"><a href="#cb369-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb369-14"><a href="#cb369-14" aria-hidden="true" tabindex="-1"></a>The following list respects the numbers specified in the markup:</span>
+<span id="cb369-15"><a href="#cb369-15" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb369-16"><a href="#cb369-16" aria-hidden="true" tabindex="-1"></a>3. third item</span>
+<span id="cb369-17"><a href="#cb369-17" aria-hidden="true" tabindex="-1"></a>4. fourth item</span>
+<span id="cb369-18"><a href="#cb369-18" aria-hidden="true" tabindex="-1"></a>5. fifth item</span>
+<span id="cb369-19"><a href="#cb369-19" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb369-20"><a href="#cb369-20" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb367"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb367-1"><a href="#cb367-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb370"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb370-1"><a href="#cb370-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -6397,8 +6490,8 @@ markup:</p>
<li>fifth item</li>
</ol>
</blockquote>
-<h4 data-number="2.2.1.52" id="option-strikethrough"><span
-class="header-section-number">2.2.1.52</span> Option
+<h4 data-number="2.2.1.53" id="option-strikethrough"><span
+class="header-section-number">2.2.1.53</span> Option
<code>strikeThrough</code></h4>
<dl>
<dt><code>strikeThrough</code> (default value: <code>false</code>)</dt>
@@ -6409,8 +6502,8 @@ class="header-section-number">2.2.1.52</span> Option
<p>Enable the Pandoc <a
href="https://pandoc.org/MANUAL.html#extension-strikeout">strike-through
syntax extension</a>:</p>
-<div class="sourceCode" id="cb368"><pre
-class="sourceCode md"><code class="sourceCode markdown"><span id="cb368-1"><a href="#cb368-1" aria-hidden="true" tabindex="-1"></a>This ~~is deleted text.~~</span></code></pre></div>
+<div class="sourceCode" id="cb371"><pre
+class="sourceCode md"><code class="sourceCode markdown"><span id="cb371-1"><a href="#cb371-1" aria-hidden="true" tabindex="-1"></a>This ~~is deleted text.~~</span></code></pre></div>
</dd>
</dl>
</dd>
@@ -6427,18 +6520,18 @@ class="sourceCode md"><code class="sourceCode markdown"><span id="cb368-1"><a hr
class="tex">T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb369"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb369-1"><a href="#cb369-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
-<span id="cb369-2"><a href="#cb369-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionStrikeThrough</span>{true}</span>
-<span id="cb369-3"><a href="#cb369-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> soulutf8.sty</span>
-<span id="cb369-4"><a href="#cb369-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererStrikeThrough</span>#1{<span class="fu">\st</span>{#1}}</span>
-<span id="cb369-5"><a href="#cb369-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
-<span id="cb369-6"><a href="#cb369-6" aria-hidden="true" tabindex="-1"></a>This is ~~a lunar roving vehicle~~ strike-through text.</span>
-<span id="cb369-7"><a href="#cb369-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
-<span id="cb369-8"><a href="#cb369-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb372"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb372-1"><a href="#cb372-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
+<span id="cb372-2"><a href="#cb372-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionStrikeThrough</span>{true}</span>
+<span id="cb372-3"><a href="#cb372-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> soulutf8.sty</span>
+<span id="cb372-4"><a href="#cb372-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererStrikeThrough</span>#1{<span class="fu">\st</span>{#1}}</span>
+<span id="cb372-5"><a href="#cb372-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
+<span id="cb372-6"><a href="#cb372-6" aria-hidden="true" tabindex="-1"></a>This is ~~a lunar roving vehicle~~ strike-through text.</span>
+<span id="cb372-7"><a href="#cb372-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
+<span id="cb372-8"><a href="#cb372-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb370"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb370-1"><a href="#cb370-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb373"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb373-1"><a href="#cb373-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -6448,23 +6541,23 @@ contain the following text:</p>
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb371"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb371-1"><a href="#cb371-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb371-2"><a href="#cb371-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[strikeThrough]{<span class="ex">markdown</span>}</span>
-<span id="cb371-3"><a href="#cb371-3" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">soulutf8</span>}</span>
-<span id="cb371-4"><a href="#cb371-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb371-5"><a href="#cb371-5" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb371-6"><a href="#cb371-6" aria-hidden="true" tabindex="-1"></a> strikeThrough = {<span class="fu">\st</span>{#1}},</span>
-<span id="cb371-7"><a href="#cb371-7" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb371-8"><a href="#cb371-8" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb371-9"><a href="#cb371-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb371-10"><a href="#cb371-10" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb371-11"><a href="#cb371-11" aria-hidden="true" tabindex="-1"></a>This is ~~a lunar roving vehicle~~ strike-through text.</span>
-<span id="cb371-12"><a href="#cb371-12" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb371-13"><a href="#cb371-13" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb374"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb374-1"><a href="#cb374-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb374-2"><a href="#cb374-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[strikeThrough]{<span class="ex">markdown</span>}</span>
+<span id="cb374-3"><a href="#cb374-3" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">soulutf8</span>}</span>
+<span id="cb374-4"><a href="#cb374-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb374-5"><a href="#cb374-5" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb374-6"><a href="#cb374-6" aria-hidden="true" tabindex="-1"></a> strikeThrough = {<span class="fu">\st</span>{#1}},</span>
+<span id="cb374-7"><a href="#cb374-7" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb374-8"><a href="#cb374-8" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb374-9"><a href="#cb374-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb374-10"><a href="#cb374-10" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb374-11"><a href="#cb374-11" aria-hidden="true" tabindex="-1"></a>This is ~~a lunar roving vehicle~~ strike-through text.</span>
+<span id="cb374-12"><a href="#cb374-12" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb374-13"><a href="#cb374-13" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb372"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb372-1"><a href="#cb372-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb375"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb375-1"><a href="#cb375-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -6474,25 +6567,25 @@ contain the following text:</p>
class="tex">T<sub>e</sub>X</span>t Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb373"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb373-1"><a href="#cb373-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
-<span id="cb373-2"><a href="#cb373-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[strikeThrough = yes]</span>
-<span id="cb373-3"><a href="#cb373-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererStrikeThrough</span>#1{<span class="fu">\overstrikes</span>{#1}}</span>
-<span id="cb373-4"><a href="#cb373-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
-<span id="cb373-5"><a href="#cb373-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb373-6"><a href="#cb373-6" aria-hidden="true" tabindex="-1"></a>This is ~~a lunar roving vehicle~~ strike-through text.</span>
-<span id="cb373-7"><a href="#cb373-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb373-8"><a href="#cb373-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
+<div class="sourceCode" id="cb376"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb376-1"><a href="#cb376-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
+<span id="cb376-2"><a href="#cb376-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[strikeThrough = yes]</span>
+<span id="cb376-3"><a href="#cb376-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererStrikeThrough</span>#1{<span class="fu">\overstrikes</span>{#1}}</span>
+<span id="cb376-4"><a href="#cb376-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
+<span id="cb376-5"><a href="#cb376-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb376-6"><a href="#cb376-6" aria-hidden="true" tabindex="-1"></a>This is ~~a lunar roving vehicle~~ strike-through text.</span>
+<span id="cb376-7"><a href="#cb376-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb376-8"><a href="#cb376-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb374"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb374-1"><a href="#cb374-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb377"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb377-1"><a href="#cb377-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
<p>This is <del>a lunar roving vehicle</del> strike-through text.</p>
</blockquote>
-<h4 data-number="2.2.1.53" id="option-stripindent"><span
-class="header-section-number">2.2.1.53</span> Option
+<h4 data-number="2.2.1.54" id="option-stripindent"><span
+class="header-section-number">2.2.1.54</span> Option
<code>stripIndent</code></h4>
<dl>
<dt><code>stripIndent</code> (default value: <code>false</code>)</dt>
@@ -6502,15 +6595,15 @@ class="header-section-number">2.2.1.53</span> Option
<dd>
<p>Strip the minimal indentation of non-blank lines from all lines in a
markdown document. Requires that the
-<strong><code>preserveTabs</code></strong> Lua option is disabled:</p>
-<div class="sourceCode" id="cb375"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb375-1"><a href="#cb375-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb375-2"><a href="#cb375-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[stripIndent]{<span class="ex">markdown</span>}</span>
-<span id="cb375-3"><a href="#cb375-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb375-4"><a href="#cb375-4" aria-hidden="true" tabindex="-1"></a> <span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb375-5"><a href="#cb375-5" aria-hidden="true" tabindex="-1"></a> Hello *world*!</span>
-<span id="cb375-6"><a href="#cb375-6" aria-hidden="true" tabindex="-1"></a> <span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb375-7"><a href="#cb375-7" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<code><strong>preserveTabs</strong></code> Lua option is disabled:</p>
+<div class="sourceCode" id="cb378"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb378-1"><a href="#cb378-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb378-2"><a href="#cb378-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[stripIndent]{<span class="ex">markdown</span>}</span>
+<span id="cb378-3"><a href="#cb378-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb378-4"><a href="#cb378-4" aria-hidden="true" tabindex="-1"></a> <span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb378-5"><a href="#cb378-5" aria-hidden="true" tabindex="-1"></a> Hello *world*!</span>
+<span id="cb378-6"><a href="#cb378-6" aria-hidden="true" tabindex="-1"></a> <span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb378-7"><a href="#cb378-7" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
</dd>
</dl>
</dd>
@@ -6528,54 +6621,54 @@ document.</p>
class="tex">T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb376"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb376-1"><a href="#cb376-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
-<span id="cb376-2"><a href="#cb376-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionStripIndent</span>{true}</span>
-<span id="cb376-3"><a href="#cb376-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
-<span id="cb376-4"><a href="#cb376-4" aria-hidden="true" tabindex="-1"></a> Hello *world*!</span>
-<span id="cb376-5"><a href="#cb376-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
-<span id="cb376-6"><a href="#cb376-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb379"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb379-1"><a href="#cb379-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
+<span id="cb379-2"><a href="#cb379-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionStripIndent</span>{true}</span>
+<span id="cb379-3"><a href="#cb379-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
+<span id="cb379-4"><a href="#cb379-4" aria-hidden="true" tabindex="-1"></a> Hello *world*!</span>
+<span id="cb379-5"><a href="#cb379-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
+<span id="cb379-6"><a href="#cb379-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb377"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb377-1"><a href="#cb377-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb380"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb380-1"><a href="#cb380-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the text “Hello <em>world</em>!”</p>
<h5 class="unnumbered" id="latex-example-42"><span
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb378"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb378-1"><a href="#cb378-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb378-2"><a href="#cb378-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[stripIndent]{<span class="ex">markdown</span>}</span>
-<span id="cb378-3"><a href="#cb378-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb378-4"><a href="#cb378-4" aria-hidden="true" tabindex="-1"></a> <span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb378-5"><a href="#cb378-5" aria-hidden="true" tabindex="-1"></a> Hello *world*!</span>
-<span id="cb378-6"><a href="#cb378-6" aria-hidden="true" tabindex="-1"></a> <span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb378-7"><a href="#cb378-7" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb381"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb381-1"><a href="#cb381-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb381-2"><a href="#cb381-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[stripIndent]{<span class="ex">markdown</span>}</span>
+<span id="cb381-3"><a href="#cb381-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb381-4"><a href="#cb381-4" aria-hidden="true" tabindex="-1"></a> <span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb381-5"><a href="#cb381-5" aria-hidden="true" tabindex="-1"></a> Hello *world*!</span>
+<span id="cb381-6"><a href="#cb381-6" aria-hidden="true" tabindex="-1"></a> <span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb381-7"><a href="#cb381-7" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb379"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb379-1"><a href="#cb379-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb382"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb382-1"><a href="#cb382-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the text “Hello <em>world</em>!”</p>
<h5 class="unnumbered" id="context-example-28">Con<span
class="tex">T<sub>e</sub>X</span>t Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb380"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb380-1"><a href="#cb380-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
-<span id="cb380-2"><a href="#cb380-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[stripIndent = yes]</span>
-<span id="cb380-3"><a href="#cb380-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
-<span id="cb380-4"><a href="#cb380-4" aria-hidden="true" tabindex="-1"></a> <span class="fu">\startmarkdown</span></span>
-<span id="cb380-5"><a href="#cb380-5" aria-hidden="true" tabindex="-1"></a> Hello *world*!</span>
-<span id="cb380-6"><a href="#cb380-6" aria-hidden="true" tabindex="-1"></a> <span class="fu">\stopmarkdown</span></span>
-<span id="cb380-7"><a href="#cb380-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
+<div class="sourceCode" id="cb383"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb383-1"><a href="#cb383-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
+<span id="cb383-2"><a href="#cb383-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[stripIndent = yes]</span>
+<span id="cb383-3"><a href="#cb383-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
+<span id="cb383-4"><a href="#cb383-4" aria-hidden="true" tabindex="-1"></a> <span class="fu">\startmarkdown</span></span>
+<span id="cb383-5"><a href="#cb383-5" aria-hidden="true" tabindex="-1"></a> Hello *world*!</span>
+<span id="cb383-6"><a href="#cb383-6" aria-hidden="true" tabindex="-1"></a> <span class="fu">\stopmarkdown</span></span>
+<span id="cb383-7"><a href="#cb383-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb381"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb381-1"><a href="#cb381-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb384"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb384-1"><a href="#cb384-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the text “Hello <em>world</em>!”</p>
-<h4 data-number="2.2.1.54" id="option-subscripts"><span
-class="header-section-number">2.2.1.54</span> Option
+<h4 data-number="2.2.1.55" id="option-subscripts"><span
+class="header-section-number">2.2.1.55</span> Option
<code>subscripts</code></h4>
<dl>
<dt><code>subscripts</code> (default value: <code>false</code>)</dt>
@@ -6586,8 +6679,8 @@ class="header-section-number">2.2.1.54</span> Option
<p>Enable the Pandoc <a
href="https://pandoc.org/MANUAL.html#extension-superscript-subscript">subscript
syntax extension</a>:</p>
-<div class="sourceCode" id="cb382"><pre
-class="sourceCode md"><code class="sourceCode markdown"><span id="cb382-1"><a href="#cb382-1" aria-hidden="true" tabindex="-1"></a>H~2~O is a liquid.</span></code></pre></div>
+<div class="sourceCode" id="cb385"><pre
+class="sourceCode md"><code class="sourceCode markdown"><span id="cb385-1"><a href="#cb385-1" aria-hidden="true" tabindex="-1"></a>H~2~O is a liquid.</span></code></pre></div>
</dd>
</dl>
</dd>
@@ -6604,17 +6697,17 @@ class="sourceCode md"><code class="sourceCode markdown"><span id="cb382-1"><a hr
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb383"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb383-1"><a href="#cb383-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb383-2"><a href="#cb383-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[subscripts]{<span class="ex">markdown</span>}</span>
-<span id="cb383-3"><a href="#cb383-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb383-4"><a href="#cb383-4" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb383-5"><a href="#cb383-5" aria-hidden="true" tabindex="-1"></a>H~2~O is a liquid.</span>
-<span id="cb383-6"><a href="#cb383-6" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb383-7"><a href="#cb383-7" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb386"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb386-1"><a href="#cb386-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb386-2"><a href="#cb386-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[subscripts]{<span class="ex">markdown</span>}</span>
+<span id="cb386-3"><a href="#cb386-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb386-4"><a href="#cb386-4" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb386-5"><a href="#cb386-5" aria-hidden="true" tabindex="-1"></a>H~2~O is a liquid.</span>
+<span id="cb386-6"><a href="#cb386-6" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb386-7"><a href="#cb386-7" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb384"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb384-1"><a href="#cb384-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb387"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb387-1"><a href="#cb387-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -6624,24 +6717,24 @@ contain the following text:</p>
class="tex">T<sub>e</sub>X</span>t Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb385"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb385-1"><a href="#cb385-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
-<span id="cb385-2"><a href="#cb385-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[subscripts = yes]</span>
-<span id="cb385-3"><a href="#cb385-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
-<span id="cb385-4"><a href="#cb385-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb385-5"><a href="#cb385-5" aria-hidden="true" tabindex="-1"></a>H~2~O is a liquid.</span>
-<span id="cb385-6"><a href="#cb385-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb385-7"><a href="#cb385-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
+<div class="sourceCode" id="cb388"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb388-1"><a href="#cb388-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
+<span id="cb388-2"><a href="#cb388-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[subscripts = yes]</span>
+<span id="cb388-3"><a href="#cb388-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
+<span id="cb388-4"><a href="#cb388-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb388-5"><a href="#cb388-5" aria-hidden="true" tabindex="-1"></a>H~2~O is a liquid.</span>
+<span id="cb388-6"><a href="#cb388-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb388-7"><a href="#cb388-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb386"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb386-1"><a href="#cb386-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb389"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb389-1"><a href="#cb389-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
<p>H<sub>2</sub>O is a liquid.</p>
</blockquote>
-<h4 data-number="2.2.1.55" id="option-superscripts"><span
-class="header-section-number">2.2.1.55</span> Option
+<h4 data-number="2.2.1.56" id="option-superscripts"><span
+class="header-section-number">2.2.1.56</span> Option
<code>superscripts</code></h4>
<dl>
<dt><code>superscripts</code> (default value: <code>false</code>)</dt>
@@ -6652,8 +6745,8 @@ class="header-section-number">2.2.1.55</span> Option
<p>Enable the Pandoc <a
href="https://pandoc.org/MANUAL.html#extension-superscript-subscript">superscript
syntax extension</a>:</p>
-<div class="sourceCode" id="cb387"><pre
-class="sourceCode md"><code class="sourceCode markdown"><span id="cb387-1"><a href="#cb387-1" aria-hidden="true" tabindex="-1"></a>2^10^ is 1024.</span></code></pre></div>
+<div class="sourceCode" id="cb390"><pre
+class="sourceCode md"><code class="sourceCode markdown"><span id="cb390-1"><a href="#cb390-1" aria-hidden="true" tabindex="-1"></a>2^10^ is 1024.</span></code></pre></div>
</dd>
</dl>
</dd>
@@ -6670,17 +6763,17 @@ class="sourceCode md"><code class="sourceCode markdown"><span id="cb387-1"><a hr
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb388"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb388-1"><a href="#cb388-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb388-2"><a href="#cb388-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[superscripts]{<span class="ex">markdown</span>}</span>
-<span id="cb388-3"><a href="#cb388-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb388-4"><a href="#cb388-4" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb388-5"><a href="#cb388-5" aria-hidden="true" tabindex="-1"></a>2^10^ is 1024.</span>
-<span id="cb388-6"><a href="#cb388-6" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb388-7"><a href="#cb388-7" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb391"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb391-1"><a href="#cb391-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb391-2"><a href="#cb391-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[superscripts]{<span class="ex">markdown</span>}</span>
+<span id="cb391-3"><a href="#cb391-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb391-4"><a href="#cb391-4" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb391-5"><a href="#cb391-5" aria-hidden="true" tabindex="-1"></a>2^10^ is 1024.</span>
+<span id="cb391-6"><a href="#cb391-6" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb391-7"><a href="#cb391-7" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb389"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb389-1"><a href="#cb389-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb392"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb392-1"><a href="#cb392-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -6690,24 +6783,24 @@ contain the following text:</p>
class="tex">T<sub>e</sub>X</span>t Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb390"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb390-1"><a href="#cb390-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
-<span id="cb390-2"><a href="#cb390-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[superscripts = yes]</span>
-<span id="cb390-3"><a href="#cb390-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
-<span id="cb390-4"><a href="#cb390-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb390-5"><a href="#cb390-5" aria-hidden="true" tabindex="-1"></a>2^10^ is 1024.</span>
-<span id="cb390-6"><a href="#cb390-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb390-7"><a href="#cb390-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
+<div class="sourceCode" id="cb393"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb393-1"><a href="#cb393-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
+<span id="cb393-2"><a href="#cb393-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[superscripts = yes]</span>
+<span id="cb393-3"><a href="#cb393-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
+<span id="cb393-4"><a href="#cb393-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb393-5"><a href="#cb393-5" aria-hidden="true" tabindex="-1"></a>2^10^ is 1024.</span>
+<span id="cb393-6"><a href="#cb393-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb393-7"><a href="#cb393-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb391"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb391-1"><a href="#cb391-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb394"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb394-1"><a href="#cb394-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
<p>2<sup>10</sup> is 1024.</p>
</blockquote>
-<h4 data-number="2.2.1.56" id="option-tableattributes"><span
-class="header-section-number">2.2.1.56</span> Option
+<h4 data-number="2.2.1.57" id="option-tableattributes"><span
+class="header-section-number">2.2.1.57</span> Option
<code>tableAttributes</code></h4>
<dl>
<dt><code>tableAttributes</code> (default value:
@@ -6718,14 +6811,14 @@ class="header-section-number">2.2.1.56</span> Option
<dd>
<p>Enable the assignment of HTML attributes to <a
href="#table-captions">table captions</a>.</p>
-<div class="sourceCode" id="cb392"><pre
-class="sourceCode md"><code class="sourceCode markdown"><span id="cb392-1"><a href="#cb392-1" aria-hidden="true" tabindex="-1"></a>| Right | Left | Default | Center |</span>
-<span id="cb392-2"><a href="#cb392-2" aria-hidden="true" tabindex="-1"></a>|------:|:-----|---------|:------:|</span>
-<span id="cb392-3"><a href="#cb392-3" aria-hidden="true" tabindex="-1"></a>| 12 | 12 | 12 | 12 |</span>
-<span id="cb392-4"><a href="#cb392-4" aria-hidden="true" tabindex="-1"></a>| 123 | 123 | 123 | 123 |</span>
-<span id="cb392-5"><a href="#cb392-5" aria-hidden="true" tabindex="-1"></a>| 1 | 1 | 1 | 1 |</span>
-<span id="cb392-6"><a href="#cb392-6" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb392-7"><a href="#cb392-7" aria-hidden="true" tabindex="-1"></a> : Demonstration of pipe table syntax. {#example-table}</span></code></pre></div>
+<div class="sourceCode" id="cb395"><pre
+class="sourceCode md"><code class="sourceCode markdown"><span id="cb395-1"><a href="#cb395-1" aria-hidden="true" tabindex="-1"></a>| Right | Left | Default | Center |</span>
+<span id="cb395-2"><a href="#cb395-2" aria-hidden="true" tabindex="-1"></a>|------:|:-----|---------|:------:|</span>
+<span id="cb395-3"><a href="#cb395-3" aria-hidden="true" tabindex="-1"></a>| 12 | 12 | 12 | 12 |</span>
+<span id="cb395-4"><a href="#cb395-4" aria-hidden="true" tabindex="-1"></a>| 123 | 123 | 123 | 123 |</span>
+<span id="cb395-5"><a href="#cb395-5" aria-hidden="true" tabindex="-1"></a>| 1 | 1 | 1 | 1 |</span>
+<span id="cb395-6"><a href="#cb395-6" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb395-7"><a href="#cb395-7" aria-hidden="true" tabindex="-1"></a> : Demonstration of pipe table syntax. {#example-table}</span></code></pre></div>
</dd>
</dl>
</dd>
@@ -6742,57 +6835,57 @@ class="sourceCode md"><code class="sourceCode markdown"><span id="cb392-1"><a hr
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb393"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb393-1"><a href="#cb393-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb393-2"><a href="#cb393-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[</span>
-<span id="cb393-3"><a href="#cb393-3" aria-hidden="true" tabindex="-1"></a> pipeTables,</span>
-<span id="cb393-4"><a href="#cb393-4" aria-hidden="true" tabindex="-1"></a> tableCaptions,</span>
-<span id="cb393-5"><a href="#cb393-5" aria-hidden="true" tabindex="-1"></a> tableAttributes,</span>
-<span id="cb393-6"><a href="#cb393-6" aria-hidden="true" tabindex="-1"></a> relativeReferences,</span>
-<span id="cb393-7"><a href="#cb393-7" aria-hidden="true" tabindex="-1"></a>]{<span class="ex">markdown</span>}</span>
-<span id="cb393-8"><a href="#cb393-8" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">expl3</span>}</span>
-<span id="cb393-9"><a href="#cb393-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\ExplSyntaxOn</span></span>
-<span id="cb393-10"><a href="#cb393-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb393-11"><a href="#cb393-11" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb393-12"><a href="#cb393-12" aria-hidden="true" tabindex="-1"></a> tableAttributeContextBegin = {</span>
-<span id="cb393-13"><a href="#cb393-13" aria-hidden="true" tabindex="-1"></a> <span class="fu">\group</span>_begin:</span>
-<span id="cb393-14"><a href="#cb393-14" aria-hidden="true" tabindex="-1"></a> <span class="fu">\markdownSetup</span>{</span>
-<span id="cb393-15"><a href="#cb393-15" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb393-16"><a href="#cb393-16" aria-hidden="true" tabindex="-1"></a> attributeIdentifier = {</span>
-<span id="cb393-17"><a href="#cb393-17" aria-hidden="true" tabindex="-1"></a> <span class="fu">\markdownSetup</span>{</span>
-<span id="cb393-18"><a href="#cb393-18" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb393-19"><a href="#cb393-19" aria-hidden="true" tabindex="-1"></a> tableAttributeContextEnd = {</span>
-<span id="cb393-20"><a href="#cb393-20" aria-hidden="true" tabindex="-1"></a> <span class="kw">\label</span>{<span class="ex">##1</span>}</span>
-<span id="cb393-21"><a href="#cb393-21" aria-hidden="true" tabindex="-1"></a> <span class="fu">\group</span>_end:</span>
-<span id="cb393-22"><a href="#cb393-22" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb393-23"><a href="#cb393-23" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb393-24"><a href="#cb393-24" aria-hidden="true" tabindex="-1"></a> }</span>
-<span id="cb393-25"><a href="#cb393-25" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb393-26"><a href="#cb393-26" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb393-27"><a href="#cb393-27" aria-hidden="true" tabindex="-1"></a> }</span>
-<span id="cb393-28"><a href="#cb393-28" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb393-29"><a href="#cb393-29" aria-hidden="true" tabindex="-1"></a> tableAttributeContextEnd = {</span>
-<span id="cb393-30"><a href="#cb393-30" aria-hidden="true" tabindex="-1"></a> <span class="fu">\group</span>_end:</span>
-<span id="cb393-31"><a href="#cb393-31" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb393-32"><a href="#cb393-32" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb393-33"><a href="#cb393-33" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb393-34"><a href="#cb393-34" aria-hidden="true" tabindex="-1"></a><span class="fu">\ExplSyntaxOff</span></span>
-<span id="cb393-35"><a href="#cb393-35" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb393-36"><a href="#cb393-36" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb393-37"><a href="#cb393-37" aria-hidden="true" tabindex="-1"></a>See Table &lt;#example-table&gt;.</span>
-<span id="cb393-38"><a href="#cb393-38" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb393-39"><a href="#cb393-39" aria-hidden="true" tabindex="-1"></a>| Right | Left | Default | Center |</span>
-<span id="cb393-40"><a href="#cb393-40" aria-hidden="true" tabindex="-1"></a>|------:|:-----|---------|:------:|</span>
-<span id="cb393-41"><a href="#cb393-41" aria-hidden="true" tabindex="-1"></a>| 12 | 12 | 12 | 12 |</span>
-<span id="cb393-42"><a href="#cb393-42" aria-hidden="true" tabindex="-1"></a>| 123 | 123 | 123 | 123 |</span>
-<span id="cb393-43"><a href="#cb393-43" aria-hidden="true" tabindex="-1"></a>| 1 | 1 | 1 | 1 |</span>
-<span id="cb393-44"><a href="#cb393-44" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb393-45"><a href="#cb393-45" aria-hidden="true" tabindex="-1"></a> : Demonstration of pipe table syntax. {#example-table}</span>
-<span id="cb393-46"><a href="#cb393-46" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb393-47"><a href="#cb393-47" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb396"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb396-1"><a href="#cb396-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb396-2"><a href="#cb396-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[</span>
+<span id="cb396-3"><a href="#cb396-3" aria-hidden="true" tabindex="-1"></a> pipeTables,</span>
+<span id="cb396-4"><a href="#cb396-4" aria-hidden="true" tabindex="-1"></a> tableCaptions,</span>
+<span id="cb396-5"><a href="#cb396-5" aria-hidden="true" tabindex="-1"></a> tableAttributes,</span>
+<span id="cb396-6"><a href="#cb396-6" aria-hidden="true" tabindex="-1"></a> relativeReferences,</span>
+<span id="cb396-7"><a href="#cb396-7" aria-hidden="true" tabindex="-1"></a>]{<span class="ex">markdown</span>}</span>
+<span id="cb396-8"><a href="#cb396-8" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">expl3</span>}</span>
+<span id="cb396-9"><a href="#cb396-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\ExplSyntaxOn</span></span>
+<span id="cb396-10"><a href="#cb396-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb396-11"><a href="#cb396-11" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb396-12"><a href="#cb396-12" aria-hidden="true" tabindex="-1"></a> tableAttributeContextBegin = {</span>
+<span id="cb396-13"><a href="#cb396-13" aria-hidden="true" tabindex="-1"></a> <span class="fu">\group</span>_begin:</span>
+<span id="cb396-14"><a href="#cb396-14" aria-hidden="true" tabindex="-1"></a> <span class="fu">\markdownSetup</span>{</span>
+<span id="cb396-15"><a href="#cb396-15" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb396-16"><a href="#cb396-16" aria-hidden="true" tabindex="-1"></a> attributeIdentifier = {</span>
+<span id="cb396-17"><a href="#cb396-17" aria-hidden="true" tabindex="-1"></a> <span class="fu">\markdownSetup</span>{</span>
+<span id="cb396-18"><a href="#cb396-18" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb396-19"><a href="#cb396-19" aria-hidden="true" tabindex="-1"></a> tableAttributeContextEnd = {</span>
+<span id="cb396-20"><a href="#cb396-20" aria-hidden="true" tabindex="-1"></a> <span class="kw">\label</span>{<span class="ex">##1</span>}</span>
+<span id="cb396-21"><a href="#cb396-21" aria-hidden="true" tabindex="-1"></a> <span class="fu">\group</span>_end:</span>
+<span id="cb396-22"><a href="#cb396-22" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb396-23"><a href="#cb396-23" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb396-24"><a href="#cb396-24" aria-hidden="true" tabindex="-1"></a> }</span>
+<span id="cb396-25"><a href="#cb396-25" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb396-26"><a href="#cb396-26" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb396-27"><a href="#cb396-27" aria-hidden="true" tabindex="-1"></a> }</span>
+<span id="cb396-28"><a href="#cb396-28" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb396-29"><a href="#cb396-29" aria-hidden="true" tabindex="-1"></a> tableAttributeContextEnd = {</span>
+<span id="cb396-30"><a href="#cb396-30" aria-hidden="true" tabindex="-1"></a> <span class="fu">\group</span>_end:</span>
+<span id="cb396-31"><a href="#cb396-31" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb396-32"><a href="#cb396-32" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb396-33"><a href="#cb396-33" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb396-34"><a href="#cb396-34" aria-hidden="true" tabindex="-1"></a><span class="fu">\ExplSyntaxOff</span></span>
+<span id="cb396-35"><a href="#cb396-35" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb396-36"><a href="#cb396-36" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb396-37"><a href="#cb396-37" aria-hidden="true" tabindex="-1"></a>See Table &lt;#example-table&gt;.</span>
+<span id="cb396-38"><a href="#cb396-38" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb396-39"><a href="#cb396-39" aria-hidden="true" tabindex="-1"></a>| Right | Left | Default | Center |</span>
+<span id="cb396-40"><a href="#cb396-40" aria-hidden="true" tabindex="-1"></a>|------:|:-----|---------|:------:|</span>
+<span id="cb396-41"><a href="#cb396-41" aria-hidden="true" tabindex="-1"></a>| 12 | 12 | 12 | 12 |</span>
+<span id="cb396-42"><a href="#cb396-42" aria-hidden="true" tabindex="-1"></a>| 123 | 123 | 123 | 123 |</span>
+<span id="cb396-43"><a href="#cb396-43" aria-hidden="true" tabindex="-1"></a>| 1 | 1 | 1 | 1 |</span>
+<span id="cb396-44"><a href="#cb396-44" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb396-45"><a href="#cb396-45" aria-hidden="true" tabindex="-1"></a> : Demonstration of pipe table syntax. {#example-table}</span>
+<span id="cb396-46"><a href="#cb396-46" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb396-47"><a href="#cb396-47" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb394"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb394-1"><a href="#cb394-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb397"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb397-1"><a href="#cb397-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -6829,8 +6922,8 @@ contain the following text:</p>
</tbody>
</table>
</blockquote>
-<h4 data-number="2.2.1.57" id="table-captions"><span
-class="header-section-number">2.2.1.57</span> Option
+<h4 data-number="2.2.1.58" id="table-captions"><span
+class="header-section-number">2.2.1.58</span> Option
<code>tableCaptions</code></h4>
<dl>
<dt><code>tableCaptions</code> (default value: <code>false</code>)</dt>
@@ -6842,14 +6935,14 @@ class="header-section-number">2.2.1.57</span> Option
href="https://pandoc.org/MANUAL.html#extension-table_captions">table
caption syntax extension</a> for <a href="#pipe-tables">pipe
tables</a>.</p>
-<div class="sourceCode" id="cb395"><pre
-class="sourceCode md"><code class="sourceCode markdown"><span id="cb395-1"><a href="#cb395-1" aria-hidden="true" tabindex="-1"></a>| Right | Left | Default | Center |</span>
-<span id="cb395-2"><a href="#cb395-2" aria-hidden="true" tabindex="-1"></a>|------:|:-----|---------|:------:|</span>
-<span id="cb395-3"><a href="#cb395-3" aria-hidden="true" tabindex="-1"></a>| 12 | 12 | 12 | 12 |</span>
-<span id="cb395-4"><a href="#cb395-4" aria-hidden="true" tabindex="-1"></a>| 123 | 123 | 123 | 123 |</span>
-<span id="cb395-5"><a href="#cb395-5" aria-hidden="true" tabindex="-1"></a>| 1 | 1 | 1 | 1 |</span>
-<span id="cb395-6"><a href="#cb395-6" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb395-7"><a href="#cb395-7" aria-hidden="true" tabindex="-1"></a> : Demonstration of pipe table syntax.</span></code></pre></div>
+<div class="sourceCode" id="cb398"><pre
+class="sourceCode md"><code class="sourceCode markdown"><span id="cb398-1"><a href="#cb398-1" aria-hidden="true" tabindex="-1"></a>| Right | Left | Default | Center |</span>
+<span id="cb398-2"><a href="#cb398-2" aria-hidden="true" tabindex="-1"></a>|------:|:-----|---------|:------:|</span>
+<span id="cb398-3"><a href="#cb398-3" aria-hidden="true" tabindex="-1"></a>| 12 | 12 | 12 | 12 |</span>
+<span id="cb398-4"><a href="#cb398-4" aria-hidden="true" tabindex="-1"></a>| 123 | 123 | 123 | 123 |</span>
+<span id="cb398-5"><a href="#cb398-5" aria-hidden="true" tabindex="-1"></a>| 1 | 1 | 1 | 1 |</span>
+<span id="cb398-6"><a href="#cb398-6" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb398-7"><a href="#cb398-7" aria-hidden="true" tabindex="-1"></a> : Demonstration of pipe table syntax.</span></code></pre></div>
</dd>
</dl>
</dd>
@@ -6866,23 +6959,23 @@ class="sourceCode md"><code class="sourceCode markdown"><span id="cb395-1"><a hr
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb396"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb396-1"><a href="#cb396-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb396-2"><a href="#cb396-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[pipeTables, tableCaptions]{<span class="ex">markdown</span>}</span>
-<span id="cb396-3"><a href="#cb396-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb396-4"><a href="#cb396-4" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb396-5"><a href="#cb396-5" aria-hidden="true" tabindex="-1"></a>| Right | Left | Default | Center |</span>
-<span id="cb396-6"><a href="#cb396-6" aria-hidden="true" tabindex="-1"></a>|------:|:-----|---------|:------:|</span>
-<span id="cb396-7"><a href="#cb396-7" aria-hidden="true" tabindex="-1"></a>| 12 | 12 | 12 | 12 |</span>
-<span id="cb396-8"><a href="#cb396-8" aria-hidden="true" tabindex="-1"></a>| 123 | 123 | 123 | 123 |</span>
-<span id="cb396-9"><a href="#cb396-9" aria-hidden="true" tabindex="-1"></a>| 1 | 1 | 1 | 1 |</span>
-<span id="cb396-10"><a href="#cb396-10" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb396-11"><a href="#cb396-11" aria-hidden="true" tabindex="-1"></a>: Demonstration of pipe table syntax.</span>
-<span id="cb396-12"><a href="#cb396-12" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb396-13"><a href="#cb396-13" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb399"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb399-1"><a href="#cb399-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb399-2"><a href="#cb399-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[pipeTables, tableCaptions]{<span class="ex">markdown</span>}</span>
+<span id="cb399-3"><a href="#cb399-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb399-4"><a href="#cb399-4" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb399-5"><a href="#cb399-5" aria-hidden="true" tabindex="-1"></a>| Right | Left | Default | Center |</span>
+<span id="cb399-6"><a href="#cb399-6" aria-hidden="true" tabindex="-1"></a>|------:|:-----|---------|:------:|</span>
+<span id="cb399-7"><a href="#cb399-7" aria-hidden="true" tabindex="-1"></a>| 12 | 12 | 12 | 12 |</span>
+<span id="cb399-8"><a href="#cb399-8" aria-hidden="true" tabindex="-1"></a>| 123 | 123 | 123 | 123 |</span>
+<span id="cb399-9"><a href="#cb399-9" aria-hidden="true" tabindex="-1"></a>| 1 | 1 | 1 | 1 |</span>
+<span id="cb399-10"><a href="#cb399-10" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb399-11"><a href="#cb399-11" aria-hidden="true" tabindex="-1"></a>: Demonstration of pipe table syntax.</span>
+<span id="cb399-12"><a href="#cb399-12" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb399-13"><a href="#cb399-13" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb397"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb397-1"><a href="#cb397-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb400"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb400-1"><a href="#cb400-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -6922,27 +7015,27 @@ contain the following text:</p>
class="tex">T<sub>e</sub>X</span>t Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb398"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb398-1"><a href="#cb398-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
-<span id="cb398-2"><a href="#cb398-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span></span>
-<span id="cb398-3"><a href="#cb398-3" aria-hidden="true" tabindex="-1"></a> [</span>
-<span id="cb398-4"><a href="#cb398-4" aria-hidden="true" tabindex="-1"></a> pipeTables = yes,</span>
-<span id="cb398-5"><a href="#cb398-5" aria-hidden="true" tabindex="-1"></a> tableCaptions = yes,</span>
-<span id="cb398-6"><a href="#cb398-6" aria-hidden="true" tabindex="-1"></a> ]</span>
-<span id="cb398-7"><a href="#cb398-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
-<span id="cb398-8"><a href="#cb398-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb398-9"><a href="#cb398-9" aria-hidden="true" tabindex="-1"></a>| Right | Left | Default | Center |</span>
-<span id="cb398-10"><a href="#cb398-10" aria-hidden="true" tabindex="-1"></a>|------:|:-----|---------|:------:|</span>
-<span id="cb398-11"><a href="#cb398-11" aria-hidden="true" tabindex="-1"></a>| 12 | 12 | 12 | 12 |</span>
-<span id="cb398-12"><a href="#cb398-12" aria-hidden="true" tabindex="-1"></a>| 123 | 123 | 123 | 123 |</span>
-<span id="cb398-13"><a href="#cb398-13" aria-hidden="true" tabindex="-1"></a>| 1 | 1 | 1 | 1 |</span>
-<span id="cb398-14"><a href="#cb398-14" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb398-15"><a href="#cb398-15" aria-hidden="true" tabindex="-1"></a>: Demonstration of pipe table syntax.</span>
-<span id="cb398-16"><a href="#cb398-16" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb398-17"><a href="#cb398-17" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
+<div class="sourceCode" id="cb401"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb401-1"><a href="#cb401-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
+<span id="cb401-2"><a href="#cb401-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span></span>
+<span id="cb401-3"><a href="#cb401-3" aria-hidden="true" tabindex="-1"></a> [</span>
+<span id="cb401-4"><a href="#cb401-4" aria-hidden="true" tabindex="-1"></a> pipeTables = yes,</span>
+<span id="cb401-5"><a href="#cb401-5" aria-hidden="true" tabindex="-1"></a> tableCaptions = yes,</span>
+<span id="cb401-6"><a href="#cb401-6" aria-hidden="true" tabindex="-1"></a> ]</span>
+<span id="cb401-7"><a href="#cb401-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
+<span id="cb401-8"><a href="#cb401-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb401-9"><a href="#cb401-9" aria-hidden="true" tabindex="-1"></a>| Right | Left | Default | Center |</span>
+<span id="cb401-10"><a href="#cb401-10" aria-hidden="true" tabindex="-1"></a>|------:|:-----|---------|:------:|</span>
+<span id="cb401-11"><a href="#cb401-11" aria-hidden="true" tabindex="-1"></a>| 12 | 12 | 12 | 12 |</span>
+<span id="cb401-12"><a href="#cb401-12" aria-hidden="true" tabindex="-1"></a>| 123 | 123 | 123 | 123 |</span>
+<span id="cb401-13"><a href="#cb401-13" aria-hidden="true" tabindex="-1"></a>| 1 | 1 | 1 | 1 |</span>
+<span id="cb401-14"><a href="#cb401-14" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb401-15"><a href="#cb401-15" aria-hidden="true" tabindex="-1"></a>: Demonstration of pipe table syntax.</span>
+<span id="cb401-16"><a href="#cb401-16" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb401-17"><a href="#cb401-17" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb399"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb399-1"><a href="#cb399-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb402"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb402-1"><a href="#cb402-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -6978,8 +7071,8 @@ contain the following text:</p>
</tbody>
</table>
</blockquote>
-<h4 data-number="2.2.1.58" id="option-tasklists"><span
-class="header-section-number">2.2.1.58</span> Option
+<h4 data-number="2.2.1.59" id="option-tasklists"><span
+class="header-section-number">2.2.1.59</span> Option
<code>taskLists</code></h4>
<dl>
<dt><code>taskLists</code> (default value: <code>false</code>)</dt>
@@ -6990,10 +7083,10 @@ class="header-section-number">2.2.1.58</span> Option
<p>Enable the Pandoc <a
href="https://pandoc.org/MANUAL.html#extension-task_lists">task list
syntax extension</a>:</p>
-<div class="sourceCode" id="cb400"><pre
-class="sourceCode md"><code class="sourceCode markdown"><span id="cb400-1"><a href="#cb400-1" aria-hidden="true" tabindex="-1"></a><span class="ss">- </span><span class="va">[ ]</span> an unticked task list item</span>
-<span id="cb400-2"><a href="#cb400-2" aria-hidden="true" tabindex="-1"></a><span class="ss">- </span><span class="co">[</span><span class="ot">/</span><span class="co">]</span> a half-checked task list item</span>
-<span id="cb400-3"><a href="#cb400-3" aria-hidden="true" tabindex="-1"></a><span class="ss">- </span><span class="co">[</span><span class="ot">X</span><span class="co">]</span> a ticked task list item</span></code></pre></div>
+<div class="sourceCode" id="cb403"><pre
+class="sourceCode md"><code class="sourceCode markdown"><span id="cb403-1"><a href="#cb403-1" aria-hidden="true" tabindex="-1"></a><span class="ss">- </span><span class="va">[ ]</span> an unticked task list item</span>
+<span id="cb403-2"><a href="#cb403-2" aria-hidden="true" tabindex="-1"></a><span class="ss">- </span><span class="co">[</span><span class="ot">/</span><span class="co">]</span> a half-checked task list item</span>
+<span id="cb403-3"><a href="#cb403-3" aria-hidden="true" tabindex="-1"></a><span class="ss">- </span><span class="co">[</span><span class="ot">X</span><span class="co">]</span> a ticked task list item</span></code></pre></div>
</dd>
</dl>
</dd>
@@ -7010,26 +7103,26 @@ class="sourceCode md"><code class="sourceCode markdown"><span id="cb400-1"><a hr
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb401"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb401-1"><a href="#cb401-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb401-2"><a href="#cb401-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[taskLists]{<span class="ex">markdown</span>}</span>
-<span id="cb401-3"><a href="#cb401-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb401-4"><a href="#cb401-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb401-5"><a href="#cb401-5" aria-hidden="true" tabindex="-1"></a> untickedBox = No,</span>
-<span id="cb401-6"><a href="#cb401-6" aria-hidden="true" tabindex="-1"></a> halfTickedBox = Maybe,</span>
-<span id="cb401-7"><a href="#cb401-7" aria-hidden="true" tabindex="-1"></a> tickedBox = Yes,</span>
-<span id="cb401-8"><a href="#cb401-8" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb401-9"><a href="#cb401-9" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb401-10"><a href="#cb401-10" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb401-11"><a href="#cb401-11" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb401-12"><a href="#cb401-12" aria-hidden="true" tabindex="-1"></a>- [ ] you can&#39;t.</span>
-<span id="cb401-13"><a href="#cb401-13" aria-hidden="true" tabindex="-1"></a>- [/] I can?</span>
-<span id="cb401-14"><a href="#cb401-14" aria-hidden="true" tabindex="-1"></a>- [X] I can!</span>
-<span id="cb401-15"><a href="#cb401-15" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb401-16"><a href="#cb401-16" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb404"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb404-1"><a href="#cb404-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb404-2"><a href="#cb404-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[taskLists]{<span class="ex">markdown</span>}</span>
+<span id="cb404-3"><a href="#cb404-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb404-4"><a href="#cb404-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb404-5"><a href="#cb404-5" aria-hidden="true" tabindex="-1"></a> untickedBox = No,</span>
+<span id="cb404-6"><a href="#cb404-6" aria-hidden="true" tabindex="-1"></a> halfTickedBox = Maybe,</span>
+<span id="cb404-7"><a href="#cb404-7" aria-hidden="true" tabindex="-1"></a> tickedBox = Yes,</span>
+<span id="cb404-8"><a href="#cb404-8" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb404-9"><a href="#cb404-9" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb404-10"><a href="#cb404-10" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb404-11"><a href="#cb404-11" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb404-12"><a href="#cb404-12" aria-hidden="true" tabindex="-1"></a>- [ ] you can&#39;t.</span>
+<span id="cb404-13"><a href="#cb404-13" aria-hidden="true" tabindex="-1"></a>- [/] I can?</span>
+<span id="cb404-14"><a href="#cb404-14" aria-hidden="true" tabindex="-1"></a>- [X] I can!</span>
+<span id="cb404-15"><a href="#cb404-15" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb404-16"><a href="#cb404-16" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb402"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb402-1"><a href="#cb402-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb405"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb405-1"><a href="#cb405-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -7043,22 +7136,22 @@ contain the following text:</p>
class="tex">T<sub>e</sub>X</span>t Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb403"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb403-1"><a href="#cb403-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
-<span id="cb403-2"><a href="#cb403-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[taskLists = yes]</span>
-<span id="cb403-3"><a href="#cb403-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererUntickedBox</span>{No}</span>
-<span id="cb403-4"><a href="#cb403-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererHalftickedBox</span>{Maybe}</span>
-<span id="cb403-5"><a href="#cb403-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererTickedBox</span>{Yes}</span>
-<span id="cb403-6"><a href="#cb403-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
-<span id="cb403-7"><a href="#cb403-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb403-8"><a href="#cb403-8" aria-hidden="true" tabindex="-1"></a>- [ ] you can&#39;t.</span>
-<span id="cb403-9"><a href="#cb403-9" aria-hidden="true" tabindex="-1"></a>- [/] I can?</span>
-<span id="cb403-10"><a href="#cb403-10" aria-hidden="true" tabindex="-1"></a>- [X] I can!</span>
-<span id="cb403-11"><a href="#cb403-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb403-12"><a href="#cb403-12" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
+<div class="sourceCode" id="cb406"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb406-1"><a href="#cb406-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
+<span id="cb406-2"><a href="#cb406-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[taskLists = yes]</span>
+<span id="cb406-3"><a href="#cb406-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererUntickedBox</span>{No}</span>
+<span id="cb406-4"><a href="#cb406-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererHalftickedBox</span>{Maybe}</span>
+<span id="cb406-5"><a href="#cb406-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererTickedBox</span>{Yes}</span>
+<span id="cb406-6"><a href="#cb406-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
+<span id="cb406-7"><a href="#cb406-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb406-8"><a href="#cb406-8" aria-hidden="true" tabindex="-1"></a>- [ ] you can&#39;t.</span>
+<span id="cb406-9"><a href="#cb406-9" aria-hidden="true" tabindex="-1"></a>- [/] I can?</span>
+<span id="cb406-10"><a href="#cb406-10" aria-hidden="true" tabindex="-1"></a>- [X] I can!</span>
+<span id="cb406-11"><a href="#cb406-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb406-12"><a href="#cb406-12" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb404"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb404-1"><a href="#cb404-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb407"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb407-1"><a href="#cb407-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -7068,8 +7161,8 @@ contain the following text:</p>
<li>Yes I can!</li>
</ul>
</blockquote>
-<h4 data-number="2.2.1.59" id="option-texcomments"><span
-class="header-section-number">2.2.1.59</span> Option
+<h4 data-number="2.2.1.60" id="option-texcomments"><span
+class="header-section-number">2.2.1.60</span> Option
<code>texComments</code></h4>
<dl>
<dt><code>texComments</code> (default value: <code>false</code>)</dt>
@@ -7078,16 +7171,16 @@ class="header-section-number">2.2.1.59</span> Option
<dt>true</dt>
<dd>
<p>Strip <span class="tex">T<sub>e</sub>X</span>-style comments.</p>
-<div class="sourceCode" id="cb405"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb405-1"><a href="#cb405-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb405-2"><a href="#cb405-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[texComments]{<span class="ex">markdown</span>}</span>
-<span id="cb405-3"><a href="#cb405-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb405-4"><a href="#cb405-4" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb405-5"><a href="#cb405-5" aria-hidden="true" tabindex="-1"></a>Hel<span class="co">% this is a comment</span></span>
-<span id="cb405-6"><a href="#cb405-6" aria-hidden="true" tabindex="-1"></a> lo *world*!</span>
-<span id="cb405-7"><a href="#cb405-7" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb405-8"><a href="#cb405-8" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
-<p>Always enabled when <strong><code>hybrid</code></strong> is
+<div class="sourceCode" id="cb408"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb408-1"><a href="#cb408-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb408-2"><a href="#cb408-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[texComments]{<span class="ex">markdown</span>}</span>
+<span id="cb408-3"><a href="#cb408-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb408-4"><a href="#cb408-4" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb408-5"><a href="#cb408-5" aria-hidden="true" tabindex="-1"></a>Hel<span class="co">% this is a comment</span></span>
+<span id="cb408-6"><a href="#cb408-6" aria-hidden="true" tabindex="-1"></a> lo *world*!</span>
+<span id="cb408-7"><a href="#cb408-7" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb408-8"><a href="#cb408-8" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<p>Always enabled when <code><strong>hybrid</strong></code> is
enabled.</p>
</dd>
</dl>
@@ -7106,57 +7199,57 @@ comments.</p>
class="tex">T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb406"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb406-1"><a href="#cb406-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
-<span id="cb406-2"><a href="#cb406-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionTexComments</span>{true}</span>
-<span id="cb406-3"><a href="#cb406-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
-<span id="cb406-4"><a href="#cb406-4" aria-hidden="true" tabindex="-1"></a>Hel<span class="co">% this is a comment</span></span>
-<span id="cb406-5"><a href="#cb406-5" aria-hidden="true" tabindex="-1"></a> lo *world*!</span>
-<span id="cb406-6"><a href="#cb406-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
-<span id="cb406-7"><a href="#cb406-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb409"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb409-1"><a href="#cb409-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
+<span id="cb409-2"><a href="#cb409-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionTexComments</span>{true}</span>
+<span id="cb409-3"><a href="#cb409-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
+<span id="cb409-4"><a href="#cb409-4" aria-hidden="true" tabindex="-1"></a>Hel<span class="co">% this is a comment</span></span>
+<span id="cb409-5"><a href="#cb409-5" aria-hidden="true" tabindex="-1"></a> lo *world*!</span>
+<span id="cb409-6"><a href="#cb409-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
+<span id="cb409-7"><a href="#cb409-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb407"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb407-1"><a href="#cb407-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb410"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb410-1"><a href="#cb410-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the text “Hello <em>world</em>!”</p>
<h5 class="unnumbered" id="latex-example-48"><span
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb408"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb408-1"><a href="#cb408-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb408-2"><a href="#cb408-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[texComments]{<span class="ex">markdown</span>}</span>
-<span id="cb408-3"><a href="#cb408-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb408-4"><a href="#cb408-4" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb408-5"><a href="#cb408-5" aria-hidden="true" tabindex="-1"></a>Hel<span class="co">% this is a comment</span></span>
-<span id="cb408-6"><a href="#cb408-6" aria-hidden="true" tabindex="-1"></a> lo *world*!</span>
-<span id="cb408-7"><a href="#cb408-7" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb408-8"><a href="#cb408-8" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb411"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb411-1"><a href="#cb411-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb411-2"><a href="#cb411-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[texComments]{<span class="ex">markdown</span>}</span>
+<span id="cb411-3"><a href="#cb411-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb411-4"><a href="#cb411-4" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb411-5"><a href="#cb411-5" aria-hidden="true" tabindex="-1"></a>Hel<span class="co">% this is a comment</span></span>
+<span id="cb411-6"><a href="#cb411-6" aria-hidden="true" tabindex="-1"></a> lo *world*!</span>
+<span id="cb411-7"><a href="#cb411-7" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb411-8"><a href="#cb411-8" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb409"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb409-1"><a href="#cb409-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb412"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb412-1"><a href="#cb412-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the text “Hello <em>world</em>!”</p>
<h5 class="unnumbered" id="context-example-33">Con<span
class="tex">T<sub>e</sub>X</span>t Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb410"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb410-1"><a href="#cb410-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
-<span id="cb410-2"><a href="#cb410-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[texComments = yes]</span>
-<span id="cb410-3"><a href="#cb410-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
-<span id="cb410-4"><a href="#cb410-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb410-5"><a href="#cb410-5" aria-hidden="true" tabindex="-1"></a>Hel<span class="co">% this is a comment</span></span>
-<span id="cb410-6"><a href="#cb410-6" aria-hidden="true" tabindex="-1"></a> lo *world*!</span>
-<span id="cb410-7"><a href="#cb410-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb410-8"><a href="#cb410-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
+<div class="sourceCode" id="cb413"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb413-1"><a href="#cb413-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
+<span id="cb413-2"><a href="#cb413-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[texComments = yes]</span>
+<span id="cb413-3"><a href="#cb413-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
+<span id="cb413-4"><a href="#cb413-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb413-5"><a href="#cb413-5" aria-hidden="true" tabindex="-1"></a>Hel<span class="co">% this is a comment</span></span>
+<span id="cb413-6"><a href="#cb413-6" aria-hidden="true" tabindex="-1"></a> lo *world*!</span>
+<span id="cb413-7"><a href="#cb413-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb413-8"><a href="#cb413-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb411"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb411-1"><a href="#cb411-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb414"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb414-1"><a href="#cb414-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the text “Hello <em>world</em>!”</p>
-<h4 data-number="2.2.1.60" id="option-texmathdollars"><span
-class="header-section-number">2.2.1.60</span> Option
+<h4 data-number="2.2.1.61" id="option-texmathdollars"><span
+class="header-section-number">2.2.1.61</span> Option
<code>texMathDollars</code></h4>
<dl>
<dt><code>texMathDollars</code> (default value: <code>false</code>)</dt>
@@ -7167,10 +7260,10 @@ class="header-section-number">2.2.1.60</span> Option
<p>Enable the Pandoc <a
href="https://pandoc.org/MANUAL.html#extension-tex_math_dollars">dollar
math syntax extension</a>:</p>
-<div class="sourceCode" id="cb412"><pre
-class="sourceCode md"><code class="sourceCode markdown"><span id="cb412-1"><a href="#cb412-1" aria-hidden="true" tabindex="-1"></a><span class="an">inline math:</span><span class="co"> $E=mc^2$</span></span>
-<span id="cb412-2"><a href="#cb412-2" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb412-3"><a href="#cb412-3" aria-hidden="true" tabindex="-1"></a>display math: $$E=mc^2$$</span></code></pre></div>
+<div class="sourceCode" id="cb415"><pre
+class="sourceCode md"><code class="sourceCode markdown"><span id="cb415-1"><a href="#cb415-1" aria-hidden="true" tabindex="-1"></a><span class="an">inline math:</span><span class="co"> $E=mc^2$</span></span>
+<span id="cb415-2"><a href="#cb415-2" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb415-3"><a href="#cb415-3" aria-hidden="true" tabindex="-1"></a>display math: $$E=mc^2$$</span></code></pre></div>
</dd>
</dl>
</dd>
@@ -7187,25 +7280,25 @@ class="sourceCode md"><code class="sourceCode markdown"><span id="cb412-1"><a hr
Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb413"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb413-1"><a href="#cb413-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
-<span id="cb413-2"><a href="#cb413-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> lmfonts</span>
-<span id="cb413-3"><a href="#cb413-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\begingroup</span></span>
-<span id="cb413-4"><a href="#cb413-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\catcode</span>`<span class="fu">\%</span>=12</span>
-<span id="cb413-5"><a href="#cb413-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\catcode</span>`<span class="fu">\#</span>=12</span>
-<span id="cb413-6"><a href="#cb413-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\directlua</span>{</span>
-<span id="cb413-7"><a href="#cb413-7" aria-hidden="true" tabindex="-1"></a> local markdown = require(&quot;markdown&quot;)</span>
-<span id="cb413-8"><a href="#cb413-8" aria-hidden="true" tabindex="-1"></a> local newline = [[^^J^^J]]</span>
-<span id="cb413-9"><a href="#cb413-9" aria-hidden="true" tabindex="-1"></a> local convert = markdown.new({texMathDollars = true})</span>
-<span id="cb413-10"><a href="#cb413-10" aria-hidden="true" tabindex="-1"></a> local input =</span>
-<span id="cb413-11"><a href="#cb413-11" aria-hidden="true" tabindex="-1"></a> [[<span class="ss">$E=mc^2$</span>]] .. newline .. newline ..</span>
-<span id="cb413-12"><a href="#cb413-12" aria-hidden="true" tabindex="-1"></a> [[<span class="ss">$$</span><span class="sc">\hat</span><span class="ss">{f} </span><span class="sc">\left</span><span class="ss"> ( </span><span class="sc">\xi</span><span class="ss"> </span><span class="sc">\right</span><span class="ss"> )= </span><span class="sc">\int</span><span class="ss">_{-</span><span class="sc">\infty</span><span class="ss">}^{</span><span class="sc">\infty</span><span class="ss">} f</span><span class="sc">\left</span><span class="ss"> ( x </span><span class="sc">\right</span><span class="ss"> ) e^{-i2</span><span class="sc">\pi</span><span class="ss"> </span><span class="sc">\xi</span><span class="ss"> x} dx$$</span>]]</span>
-<span id="cb413-13"><a href="#cb413-13" aria-hidden="true" tabindex="-1"></a> tex.sprint(convert(input)) }</span>
-<span id="cb413-14"><a href="#cb413-14" aria-hidden="true" tabindex="-1"></a><span class="fu">\endgroup</span></span>
-<span id="cb413-15"><a href="#cb413-15" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb416"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb416-1"><a href="#cb416-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
+<span id="cb416-2"><a href="#cb416-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> lmfonts</span>
+<span id="cb416-3"><a href="#cb416-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\begingroup</span></span>
+<span id="cb416-4"><a href="#cb416-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\catcode</span>`<span class="fu">\%</span>=12</span>
+<span id="cb416-5"><a href="#cb416-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\catcode</span>`<span class="fu">\#</span>=12</span>
+<span id="cb416-6"><a href="#cb416-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\directlua</span>{</span>
+<span id="cb416-7"><a href="#cb416-7" aria-hidden="true" tabindex="-1"></a> local markdown = require(&quot;markdown&quot;)</span>
+<span id="cb416-8"><a href="#cb416-8" aria-hidden="true" tabindex="-1"></a> local newline = [[^^J^^J]]</span>
+<span id="cb416-9"><a href="#cb416-9" aria-hidden="true" tabindex="-1"></a> local convert = markdown.new({texMathDollars = true})</span>
+<span id="cb416-10"><a href="#cb416-10" aria-hidden="true" tabindex="-1"></a> local input =</span>
+<span id="cb416-11"><a href="#cb416-11" aria-hidden="true" tabindex="-1"></a> [[<span class="ss">$E=mc^2$</span>]] .. newline .. newline ..</span>
+<span id="cb416-12"><a href="#cb416-12" aria-hidden="true" tabindex="-1"></a> [[<span class="ss">$$</span><span class="sc">\hat</span><span class="ss">{f} </span><span class="sc">\left</span><span class="ss"> ( </span><span class="sc">\xi</span><span class="ss"> </span><span class="sc">\right</span><span class="ss"> )= </span><span class="sc">\int</span><span class="ss">_{-</span><span class="sc">\infty</span><span class="ss">}^{</span><span class="sc">\infty</span><span class="ss">} f</span><span class="sc">\left</span><span class="ss"> ( x </span><span class="sc">\right</span><span class="ss"> ) e^{-i2</span><span class="sc">\pi</span><span class="ss"> </span><span class="sc">\xi</span><span class="ss"> x} dx$$</span>]]</span>
+<span id="cb416-13"><a href="#cb416-13" aria-hidden="true" tabindex="-1"></a> tex.sprint(convert(input)) }</span>
+<span id="cb416-14"><a href="#cb416-14" aria-hidden="true" tabindex="-1"></a><span class="fu">\endgroup</span></span>
+<span id="cb416-15"><a href="#cb416-15" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Then, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb414"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb414-1"><a href="#cb414-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb417"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb417-1"><a href="#cb417-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -7217,28 +7310,28 @@ class="math display"><em>f̂</em>(<em>ξ</em>) = ∫<sub>−∞</sub><sup>
<h5 class="unnumbered" id="lua-cli-example-12">Lua CLI Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb415"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb415-1"><a href="#cb415-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
-<span id="cb415-2"><a href="#cb415-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> lmfonts</span>
-<span id="cb415-3"><a href="#cb415-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\begingroup</span></span>
-<span id="cb415-4"><a href="#cb415-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\catcode</span>`<span class="fu">\%</span>=12</span>
-<span id="cb415-5"><a href="#cb415-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\catcode</span>`<span class="fu">\#</span>=12</span>
-<span id="cb415-6"><a href="#cb415-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> optionfalse</span>
-<span id="cb415-7"><a href="#cb415-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\par</span></span>
-<span id="cb415-8"><a href="#cb415-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> optiontrue</span>
-<span id="cb415-9"><a href="#cb415-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\endgroup</span></span>
-<span id="cb415-10"><a href="#cb415-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb418"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb418-1"><a href="#cb418-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
+<span id="cb418-2"><a href="#cb418-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> lmfonts</span>
+<span id="cb418-3"><a href="#cb418-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\begingroup</span></span>
+<span id="cb418-4"><a href="#cb418-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\catcode</span>`<span class="fu">\%</span>=12</span>
+<span id="cb418-5"><a href="#cb418-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\catcode</span>`<span class="fu">\#</span>=12</span>
+<span id="cb418-6"><a href="#cb418-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> optionfalse</span>
+<span id="cb418-7"><a href="#cb418-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\par</span></span>
+<span id="cb418-8"><a href="#cb418-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> optiontrue</span>
+<span id="cb418-9"><a href="#cb418-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\endgroup</span></span>
+<span id="cb418-10"><a href="#cb418-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Using a text editor, create a text document named
<code>content.md</code> with the following content:</p>
-<div class="sourceCode" id="cb416"><pre
-class="sourceCode md"><code class="sourceCode markdown"><span id="cb416-1"><a href="#cb416-1" aria-hidden="true" tabindex="-1"></a>$E=mc^2$</span>
-<span id="cb416-2"><a href="#cb416-2" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb416-3"><a href="#cb416-3" aria-hidden="true" tabindex="-1"></a>$$\hat{f} \left ( \xi \right )= \int_{-\infty}^{\infty} f\left ( x \right ) e^{-i2\pi \xi x} dx$$</span></code></pre></div>
+<div class="sourceCode" id="cb419"><pre
+class="sourceCode md"><code class="sourceCode markdown"><span id="cb419-1"><a href="#cb419-1" aria-hidden="true" tabindex="-1"></a>$E=mc^2$</span>
+<span id="cb419-2"><a href="#cb419-2" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb419-3"><a href="#cb419-3" aria-hidden="true" tabindex="-1"></a>$$\hat{f} \left ( \xi \right )= \int_{-\infty}^{\infty} f\left ( x \right ) e^{-i2\pi \xi x} dx$$</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb417"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb417-1"><a href="#cb417-1" aria-hidden="true" tabindex="-1"></a><span class="ex">texlua</span> ⟨CLI pathname⟩ <span class="at">--</span> content.md optionfalse.tex</span>
-<span id="cb417-2"><a href="#cb417-2" aria-hidden="true" tabindex="-1"></a><span class="ex">texlua</span> ⟨CLI pathname⟩ texMathDollars=true <span class="at">--</span> content.md optiontrue.tex</span>
-<span id="cb417-3"><a href="#cb417-3" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb420"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb420-1"><a href="#cb420-1" aria-hidden="true" tabindex="-1"></a><span class="ex">texlua</span> ⟨CLI pathname⟩ <span class="at">--</span> content.md optionfalse.tex</span>
+<span id="cb420-2"><a href="#cb420-2" aria-hidden="true" tabindex="-1"></a><span class="ex">texlua</span> ⟨CLI pathname⟩ texMathDollars=true <span class="at">--</span> content.md optiontrue.tex</span>
+<span id="cb420-3"><a href="#cb420-3" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
<p>where ⟨<em>CLI pathname</em>⟩ corresponds to the location of the Lua
CLI script file, such as
<code>~/texmf/scripts/markdown/markdown-cli.lua</code> on UN*X systems
@@ -7263,20 +7356,20 @@ class="math display"><em>f̂</em>(<em>ξ</em>) = ∫<sub>−∞</sub><sup>
class="tex">T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb418"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb418-1"><a href="#cb418-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
-<span id="cb418-2"><a href="#cb418-2" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb418-3"><a href="#cb418-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionTexMathDollars</span>{true}</span>
-<span id="cb418-4"><a href="#cb418-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
-<span id="cb418-5"><a href="#cb418-5" aria-hidden="true" tabindex="-1"></a><span class="ss">$E=mc^2$</span></span>
-<span id="cb418-6"><a href="#cb418-6" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb418-7"><a href="#cb418-7" aria-hidden="true" tabindex="-1"></a><span class="ss">$$</span><span class="sc">\hat</span><span class="ss">{f} </span><span class="sc">\left</span><span class="ss"> ( </span><span class="sc">\xi</span><span class="ss"> </span><span class="sc">\right</span><span class="ss"> )= </span><span class="sc">\int</span><span class="ss">_{-</span><span class="sc">\infty</span><span class="ss">}^{</span><span class="sc">\infty</span><span class="ss">} f</span><span class="sc">\left</span><span class="ss"> ( x </span><span class="sc">\right</span><span class="ss"> ) e^{-i2</span><span class="sc">\pi</span><span class="ss"> </span><span class="sc">\xi</span><span class="ss"> x} dx$$</span></span>
-<span id="cb418-8"><a href="#cb418-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
-<span id="cb418-9"><a href="#cb418-9" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb418-10"><a href="#cb418-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb421"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb421-1"><a href="#cb421-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
+<span id="cb421-2"><a href="#cb421-2" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb421-3"><a href="#cb421-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionTexMathDollars</span>{true}</span>
+<span id="cb421-4"><a href="#cb421-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
+<span id="cb421-5"><a href="#cb421-5" aria-hidden="true" tabindex="-1"></a><span class="ss">$E=mc^2$</span></span>
+<span id="cb421-6"><a href="#cb421-6" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb421-7"><a href="#cb421-7" aria-hidden="true" tabindex="-1"></a><span class="ss">$$</span><span class="sc">\hat</span><span class="ss">{f} </span><span class="sc">\left</span><span class="ss"> ( </span><span class="sc">\xi</span><span class="ss"> </span><span class="sc">\right</span><span class="ss"> )= </span><span class="sc">\int</span><span class="ss">_{-</span><span class="sc">\infty</span><span class="ss">}^{</span><span class="sc">\infty</span><span class="ss">} f</span><span class="sc">\left</span><span class="ss"> ( x </span><span class="sc">\right</span><span class="ss"> ) e^{-i2</span><span class="sc">\pi</span><span class="ss"> </span><span class="sc">\xi</span><span class="ss"> x} dx$$</span></span>
+<span id="cb421-8"><a href="#cb421-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
+<span id="cb421-9"><a href="#cb421-9" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb421-10"><a href="#cb421-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb419"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb419-1"><a href="#cb419-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb422"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb422-1"><a href="#cb422-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -7289,21 +7382,21 @@ class="math display"><em>f̂</em>(<em>ξ</em>) = ∫<sub>−∞</sub><sup>
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb420"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb420-1"><a href="#cb420-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb420-2"><a href="#cb420-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[texMathDollars]{<span class="ex">markdown</span>}</span>
-<span id="cb420-3"><a href="#cb420-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb420-4"><a href="#cb420-4" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb420-5"><a href="#cb420-5" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb420-6"><a href="#cb420-6" aria-hidden="true" tabindex="-1"></a><span class="ss">$E=mc^2$</span></span>
-<span id="cb420-7"><a href="#cb420-7" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb420-8"><a href="#cb420-8" aria-hidden="true" tabindex="-1"></a><span class="ss">$$</span><span class="sc">\hat</span><span class="ss">{f} </span><span class="sc">\left</span><span class="ss"> ( </span><span class="sc">\xi</span><span class="ss"> </span><span class="sc">\right</span><span class="ss"> )= </span><span class="sc">\int</span><span class="ss">_{-</span><span class="sc">\infty</span><span class="ss">}^{</span><span class="sc">\infty</span><span class="ss">} f</span><span class="sc">\left</span><span class="ss"> ( x </span><span class="sc">\right</span><span class="ss"> ) e^{-i2</span><span class="sc">\pi</span><span class="ss"> </span><span class="sc">\xi</span><span class="ss"> x} dx$$</span></span>
-<span id="cb420-9"><a href="#cb420-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb420-10"><a href="#cb420-10" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb420-11"><a href="#cb420-11" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb423"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb423-1"><a href="#cb423-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb423-2"><a href="#cb423-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[texMathDollars]{<span class="ex">markdown</span>}</span>
+<span id="cb423-3"><a href="#cb423-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb423-4"><a href="#cb423-4" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb423-5"><a href="#cb423-5" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb423-6"><a href="#cb423-6" aria-hidden="true" tabindex="-1"></a><span class="ss">$E=mc^2$</span></span>
+<span id="cb423-7"><a href="#cb423-7" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb423-8"><a href="#cb423-8" aria-hidden="true" tabindex="-1"></a><span class="ss">$$</span><span class="sc">\hat</span><span class="ss">{f} </span><span class="sc">\left</span><span class="ss"> ( </span><span class="sc">\xi</span><span class="ss"> </span><span class="sc">\right</span><span class="ss"> )= </span><span class="sc">\int</span><span class="ss">_{-</span><span class="sc">\infty</span><span class="ss">}^{</span><span class="sc">\infty</span><span class="ss">} f</span><span class="sc">\left</span><span class="ss"> ( x </span><span class="sc">\right</span><span class="ss"> ) e^{-i2</span><span class="sc">\pi</span><span class="ss"> </span><span class="sc">\xi</span><span class="ss"> x} dx$$</span></span>
+<span id="cb423-9"><a href="#cb423-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb423-10"><a href="#cb423-10" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb423-11"><a href="#cb423-11" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb421"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb421-1"><a href="#cb421-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb424"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb424-1"><a href="#cb424-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -7316,21 +7409,21 @@ class="math display"><em>f̂</em>(<em>ξ</em>) = ∫<sub>−∞</sub><sup>
class="tex">T<sub>e</sub>X</span>t Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb422"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb422-1"><a href="#cb422-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
-<span id="cb422-2"><a href="#cb422-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[texMathDollars = yes]</span>
-<span id="cb422-3"><a href="#cb422-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
-<span id="cb422-4"><a href="#cb422-4" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb422-5"><a href="#cb422-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb422-6"><a href="#cb422-6" aria-hidden="true" tabindex="-1"></a><span class="ss">$E=mc^2$</span></span>
-<span id="cb422-7"><a href="#cb422-7" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb422-8"><a href="#cb422-8" aria-hidden="true" tabindex="-1"></a><span class="ss">$$</span><span class="sc">\hat</span><span class="ss">{f} </span><span class="sc">\left</span><span class="ss"> ( </span><span class="sc">\xi</span><span class="ss"> </span><span class="sc">\right</span><span class="ss"> )= </span><span class="sc">\int</span><span class="ss">_{-</span><span class="sc">\infty</span><span class="ss">}^{</span><span class="sc">\infty</span><span class="ss">} f</span><span class="sc">\left</span><span class="ss"> ( x </span><span class="sc">\right</span><span class="ss"> ) e^{-i2</span><span class="sc">\pi</span><span class="ss"> </span><span class="sc">\xi</span><span class="ss"> x} dx$$</span></span>
-<span id="cb422-9"><a href="#cb422-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb422-10"><a href="#cb422-10" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb422-11"><a href="#cb422-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
+<div class="sourceCode" id="cb425"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb425-1"><a href="#cb425-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
+<span id="cb425-2"><a href="#cb425-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[texMathDollars = yes]</span>
+<span id="cb425-3"><a href="#cb425-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
+<span id="cb425-4"><a href="#cb425-4" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb425-5"><a href="#cb425-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb425-6"><a href="#cb425-6" aria-hidden="true" tabindex="-1"></a><span class="ss">$E=mc^2$</span></span>
+<span id="cb425-7"><a href="#cb425-7" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb425-8"><a href="#cb425-8" aria-hidden="true" tabindex="-1"></a><span class="ss">$$</span><span class="sc">\hat</span><span class="ss">{f} </span><span class="sc">\left</span><span class="ss"> ( </span><span class="sc">\xi</span><span class="ss"> </span><span class="sc">\right</span><span class="ss"> )= </span><span class="sc">\int</span><span class="ss">_{-</span><span class="sc">\infty</span><span class="ss">}^{</span><span class="sc">\infty</span><span class="ss">} f</span><span class="sc">\left</span><span class="ss"> ( x </span><span class="sc">\right</span><span class="ss"> ) e^{-i2</span><span class="sc">\pi</span><span class="ss"> </span><span class="sc">\xi</span><span class="ss"> x} dx$$</span></span>
+<span id="cb425-9"><a href="#cb425-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb425-10"><a href="#cb425-10" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb425-11"><a href="#cb425-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb423"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb423-1"><a href="#cb423-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb426"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb426-1"><a href="#cb426-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -7339,8 +7432,8 @@ class="math inline"><em>E</em> = <em>m</em><em>c</em><sup>2</sup></span></p>
<p><span
class="math display"><em>f̂</em>(<em>ξ</em>) = ∫<sub>−∞</sub><sup>∞</sup><em>f</em>(<em>x</em>)<em>e</em><sup>−<em>i</em>2<em>π</em><em>ξ</em><em>x</em></sup><em>d</em><em>x</em></span></p>
</blockquote>
-<h4 data-number="2.2.1.61" id="option-texmathdoublebackslash"><span
-class="header-section-number">2.2.1.61</span> Option
+<h4 data-number="2.2.1.62" id="option-texmathdoublebackslash"><span
+class="header-section-number">2.2.1.62</span> Option
<code>texMathDoubleBackslash</code></h4>
<dl>
<dt><code>texMathDoubleBackslash</code> (default value:
@@ -7352,10 +7445,10 @@ class="header-section-number">2.2.1.61</span> Option
<p>Enable the Pandoc <a
href="https://pandoc.org/MANUAL.html#extension-tex_math_double_backslash">double
backslash math syntax extension</a>:</p>
-<div class="sourceCode" id="cb424"><pre
-class="sourceCode md"><code class="sourceCode markdown"><span id="cb424-1"><a href="#cb424-1" aria-hidden="true" tabindex="-1"></a><span class="an">inline math:</span><span class="co"> \\(E=mc^2\\)</span></span>
-<span id="cb424-2"><a href="#cb424-2" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb424-3"><a href="#cb424-3" aria-hidden="true" tabindex="-1"></a>display math: <span class="sc">\\</span><span class="co">[</span><span class="ot">E=mc^2\\]</span></span></code></pre></div>
+<div class="sourceCode" id="cb427"><pre
+class="sourceCode md"><code class="sourceCode markdown"><span id="cb427-1"><a href="#cb427-1" aria-hidden="true" tabindex="-1"></a><span class="an">inline math:</span><span class="co"> \\(E=mc^2\\)</span></span>
+<span id="cb427-2"><a href="#cb427-2" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb427-3"><a href="#cb427-3" aria-hidden="true" tabindex="-1"></a>display math: <span class="sc">\\</span><span class="co">[</span><span class="ot">E=mc^2\\]</span></span></code></pre></div>
</dd>
</dl>
</dd>
@@ -7372,25 +7465,25 @@ class="sourceCode md"><code class="sourceCode markdown"><span id="cb424-1"><a hr
Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb425"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb425-1"><a href="#cb425-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
-<span id="cb425-2"><a href="#cb425-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> lmfonts</span>
-<span id="cb425-3"><a href="#cb425-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\begingroup</span></span>
-<span id="cb425-4"><a href="#cb425-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\catcode</span>`<span class="fu">\%</span>=12</span>
-<span id="cb425-5"><a href="#cb425-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\catcode</span>`<span class="fu">\#</span>=12</span>
-<span id="cb425-6"><a href="#cb425-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\directlua</span>{</span>
-<span id="cb425-7"><a href="#cb425-7" aria-hidden="true" tabindex="-1"></a> local markdown = require(&quot;markdown&quot;)</span>
-<span id="cb425-8"><a href="#cb425-8" aria-hidden="true" tabindex="-1"></a> local newline = [[^^J^^J]]</span>
-<span id="cb425-9"><a href="#cb425-9" aria-hidden="true" tabindex="-1"></a> local convert = markdown.new({texMathDoubleBackslash = true})</span>
-<span id="cb425-10"><a href="#cb425-10" aria-hidden="true" tabindex="-1"></a> local input =</span>
-<span id="cb425-11"><a href="#cb425-11" aria-hidden="true" tabindex="-1"></a> [[<span class="fu">\\</span>(E=mc^2<span class="fu">\\</span>)]] .. newline .. newline ..</span>
-<span id="cb425-12"><a href="#cb425-12" aria-hidden="true" tabindex="-1"></a> [[<span class="fu">\\</span>[<span class="fu">\hat</span>{f} <span class="fu">\left</span> ( <span class="fu">\xi</span> <span class="fu">\right</span> )= <span class="fu">\int</span>_{-<span class="fu">\infty</span>}^{<span class="fu">\infty</span>} f<span class="fu">\left</span> ( x <span class="fu">\right</span> ) e^{-i2<span class="fu">\pi</span> <span class="fu">\xi</span> x} dx<span class="fu">\\</span>]]]</span>
-<span id="cb425-13"><a href="#cb425-13" aria-hidden="true" tabindex="-1"></a> tex.sprint(convert(input)) }</span>
-<span id="cb425-14"><a href="#cb425-14" aria-hidden="true" tabindex="-1"></a><span class="fu">\endgroup</span></span>
-<span id="cb425-15"><a href="#cb425-15" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb428"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb428-1"><a href="#cb428-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
+<span id="cb428-2"><a href="#cb428-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> lmfonts</span>
+<span id="cb428-3"><a href="#cb428-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\begingroup</span></span>
+<span id="cb428-4"><a href="#cb428-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\catcode</span>`<span class="fu">\%</span>=12</span>
+<span id="cb428-5"><a href="#cb428-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\catcode</span>`<span class="fu">\#</span>=12</span>
+<span id="cb428-6"><a href="#cb428-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\directlua</span>{</span>
+<span id="cb428-7"><a href="#cb428-7" aria-hidden="true" tabindex="-1"></a> local markdown = require(&quot;markdown&quot;)</span>
+<span id="cb428-8"><a href="#cb428-8" aria-hidden="true" tabindex="-1"></a> local newline = [[^^J^^J]]</span>
+<span id="cb428-9"><a href="#cb428-9" aria-hidden="true" tabindex="-1"></a> local convert = markdown.new({texMathDoubleBackslash = true})</span>
+<span id="cb428-10"><a href="#cb428-10" aria-hidden="true" tabindex="-1"></a> local input =</span>
+<span id="cb428-11"><a href="#cb428-11" aria-hidden="true" tabindex="-1"></a> [[<span class="fu">\\</span>(E=mc^2<span class="fu">\\</span>)]] .. newline .. newline ..</span>
+<span id="cb428-12"><a href="#cb428-12" aria-hidden="true" tabindex="-1"></a> [[<span class="fu">\\</span>[<span class="fu">\hat</span>{f} <span class="fu">\left</span> ( <span class="fu">\xi</span> <span class="fu">\right</span> )= <span class="fu">\int</span>_{-<span class="fu">\infty</span>}^{<span class="fu">\infty</span>} f<span class="fu">\left</span> ( x <span class="fu">\right</span> ) e^{-i2<span class="fu">\pi</span> <span class="fu">\xi</span> x} dx<span class="fu">\\</span>]]]</span>
+<span id="cb428-13"><a href="#cb428-13" aria-hidden="true" tabindex="-1"></a> tex.sprint(convert(input)) }</span>
+<span id="cb428-14"><a href="#cb428-14" aria-hidden="true" tabindex="-1"></a><span class="fu">\endgroup</span></span>
+<span id="cb428-15"><a href="#cb428-15" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Then, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb426"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb426-1"><a href="#cb426-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb429"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb429-1"><a href="#cb429-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -7402,28 +7495,28 @@ class="math display"><em>f̂</em>(<em>ξ</em>) = ∫<sub>−∞</sub><sup>
<h5 class="unnumbered" id="lua-cli-example-13">Lua CLI Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb427"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb427-1"><a href="#cb427-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
-<span id="cb427-2"><a href="#cb427-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> lmfonts</span>
-<span id="cb427-3"><a href="#cb427-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\begingroup</span></span>
-<span id="cb427-4"><a href="#cb427-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\catcode</span>`<span class="fu">\%</span>=12</span>
-<span id="cb427-5"><a href="#cb427-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\catcode</span>`<span class="fu">\#</span>=12</span>
-<span id="cb427-6"><a href="#cb427-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> optionfalse</span>
-<span id="cb427-7"><a href="#cb427-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\par</span></span>
-<span id="cb427-8"><a href="#cb427-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> optiontrue</span>
-<span id="cb427-9"><a href="#cb427-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\endgroup</span></span>
-<span id="cb427-10"><a href="#cb427-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb430"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb430-1"><a href="#cb430-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
+<span id="cb430-2"><a href="#cb430-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> lmfonts</span>
+<span id="cb430-3"><a href="#cb430-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\begingroup</span></span>
+<span id="cb430-4"><a href="#cb430-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\catcode</span>`<span class="fu">\%</span>=12</span>
+<span id="cb430-5"><a href="#cb430-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\catcode</span>`<span class="fu">\#</span>=12</span>
+<span id="cb430-6"><a href="#cb430-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> optionfalse</span>
+<span id="cb430-7"><a href="#cb430-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\par</span></span>
+<span id="cb430-8"><a href="#cb430-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> optiontrue</span>
+<span id="cb430-9"><a href="#cb430-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\endgroup</span></span>
+<span id="cb430-10"><a href="#cb430-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Using a text editor, create a text document named
<code>content.md</code> with the following content:</p>
-<div class="sourceCode" id="cb428"><pre
-class="sourceCode md"><code class="sourceCode markdown"><span id="cb428-1"><a href="#cb428-1" aria-hidden="true" tabindex="-1"></a><span class="sc">\\</span>(E=mc^2<span class="sc">\\</span>)</span>
-<span id="cb428-2"><a href="#cb428-2" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb428-3"><a href="#cb428-3" aria-hidden="true" tabindex="-1"></a><span class="sc">\\</span><span class="co">[</span><span class="ot">\hat{f} \left ( \xi \right )= \int_{-\infty}^{\infty} f\left ( x \right ) e^{-i2\pi \xi x} dx\\]</span></span></code></pre></div>
+<div class="sourceCode" id="cb431"><pre
+class="sourceCode md"><code class="sourceCode markdown"><span id="cb431-1"><a href="#cb431-1" aria-hidden="true" tabindex="-1"></a><span class="sc">\\</span>(E=mc^2<span class="sc">\\</span>)</span>
+<span id="cb431-2"><a href="#cb431-2" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb431-3"><a href="#cb431-3" aria-hidden="true" tabindex="-1"></a><span class="sc">\\</span><span class="co">[</span><span class="ot">\hat{f} \left ( \xi \right )= \int_{-\infty}^{\infty} f\left ( x \right ) e^{-i2\pi \xi x} dx\\]</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb429"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb429-1"><a href="#cb429-1" aria-hidden="true" tabindex="-1"></a><span class="ex">texlua</span> ⟨CLI pathname⟩ <span class="at">--</span> content.md optionfalse.tex</span>
-<span id="cb429-2"><a href="#cb429-2" aria-hidden="true" tabindex="-1"></a><span class="ex">texlua</span> ⟨CLI pathname⟩ texMathDoubleBackslash=true <span class="at">--</span> content.md optiontrue.tex</span>
-<span id="cb429-3"><a href="#cb429-3" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb432"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb432-1"><a href="#cb432-1" aria-hidden="true" tabindex="-1"></a><span class="ex">texlua</span> ⟨CLI pathname⟩ <span class="at">--</span> content.md optionfalse.tex</span>
+<span id="cb432-2"><a href="#cb432-2" aria-hidden="true" tabindex="-1"></a><span class="ex">texlua</span> ⟨CLI pathname⟩ texMathDoubleBackslash=true <span class="at">--</span> content.md optiontrue.tex</span>
+<span id="cb432-3"><a href="#cb432-3" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
<p>where ⟨<em>CLI pathname</em>⟩ corresponds to the location of the Lua
CLI script file, such as
<code>~/texmf/scripts/markdown/markdown-cli.lua</code> on UN*X systems
@@ -7448,20 +7541,20 @@ class="math display"><em>f̂</em>(<em>ξ</em>) = ∫<sub>−∞</sub><sup>
class="tex">T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb430"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb430-1"><a href="#cb430-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
-<span id="cb430-2"><a href="#cb430-2" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb430-3"><a href="#cb430-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionTexMathDoubleBackslash</span>{true}</span>
-<span id="cb430-4"><a href="#cb430-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
-<span id="cb430-5"><a href="#cb430-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\\</span>(E=mc^2<span class="fu">\\</span>)</span>
-<span id="cb430-6"><a href="#cb430-6" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb430-7"><a href="#cb430-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\\</span>[<span class="fu">\hat</span>{f} <span class="fu">\left</span> ( <span class="fu">\xi</span> <span class="fu">\right</span> )= <span class="fu">\int</span>_{-<span class="fu">\infty</span>}^{<span class="fu">\infty</span>} f<span class="fu">\left</span> ( x <span class="fu">\right</span> ) e^{-i2<span class="fu">\pi</span> <span class="fu">\xi</span> x} dx<span class="fu">\\</span>]</span>
-<span id="cb430-8"><a href="#cb430-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
-<span id="cb430-9"><a href="#cb430-9" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb430-10"><a href="#cb430-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb433"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb433-1"><a href="#cb433-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
+<span id="cb433-2"><a href="#cb433-2" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb433-3"><a href="#cb433-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionTexMathDoubleBackslash</span>{true}</span>
+<span id="cb433-4"><a href="#cb433-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
+<span id="cb433-5"><a href="#cb433-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\\</span>(E=mc^2<span class="fu">\\</span>)</span>
+<span id="cb433-6"><a href="#cb433-6" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb433-7"><a href="#cb433-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\\</span>[<span class="fu">\hat</span>{f} <span class="fu">\left</span> ( <span class="fu">\xi</span> <span class="fu">\right</span> )= <span class="fu">\int</span>_{-<span class="fu">\infty</span>}^{<span class="fu">\infty</span>} f<span class="fu">\left</span> ( x <span class="fu">\right</span> ) e^{-i2<span class="fu">\pi</span> <span class="fu">\xi</span> x} dx<span class="fu">\\</span>]</span>
+<span id="cb433-8"><a href="#cb433-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
+<span id="cb433-9"><a href="#cb433-9" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb433-10"><a href="#cb433-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb431"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb431-1"><a href="#cb431-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb434"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb434-1"><a href="#cb434-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -7474,21 +7567,21 @@ class="math display"><em>f̂</em>(<em>ξ</em>) = ∫<sub>−∞</sub><sup>
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb432"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb432-1"><a href="#cb432-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb432-2"><a href="#cb432-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[texMathDoubleBackslash]{<span class="ex">markdown</span>}</span>
-<span id="cb432-3"><a href="#cb432-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb432-4"><a href="#cb432-4" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb432-5"><a href="#cb432-5" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb432-6"><a href="#cb432-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\\</span>(E=mc^2<span class="fu">\\</span>)</span>
-<span id="cb432-7"><a href="#cb432-7" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb432-8"><a href="#cb432-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\\</span>[<span class="fu">\hat</span>{f} <span class="fu">\left</span> ( <span class="fu">\xi</span> <span class="fu">\right</span> )= <span class="fu">\int</span>_{-<span class="fu">\infty</span>}^{<span class="fu">\infty</span>} f<span class="fu">\left</span> ( x <span class="fu">\right</span> ) e^{-i2<span class="fu">\pi</span> <span class="fu">\xi</span> x} dx<span class="fu">\\</span>]</span>
-<span id="cb432-9"><a href="#cb432-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb432-10"><a href="#cb432-10" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb432-11"><a href="#cb432-11" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb435"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb435-1"><a href="#cb435-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb435-2"><a href="#cb435-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[texMathDoubleBackslash]{<span class="ex">markdown</span>}</span>
+<span id="cb435-3"><a href="#cb435-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb435-4"><a href="#cb435-4" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb435-5"><a href="#cb435-5" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb435-6"><a href="#cb435-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\\</span>(E=mc^2<span class="fu">\\</span>)</span>
+<span id="cb435-7"><a href="#cb435-7" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb435-8"><a href="#cb435-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\\</span>[<span class="fu">\hat</span>{f} <span class="fu">\left</span> ( <span class="fu">\xi</span> <span class="fu">\right</span> )= <span class="fu">\int</span>_{-<span class="fu">\infty</span>}^{<span class="fu">\infty</span>} f<span class="fu">\left</span> ( x <span class="fu">\right</span> ) e^{-i2<span class="fu">\pi</span> <span class="fu">\xi</span> x} dx<span class="fu">\\</span>]</span>
+<span id="cb435-9"><a href="#cb435-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb435-10"><a href="#cb435-10" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb435-11"><a href="#cb435-11" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb433"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb433-1"><a href="#cb433-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb436"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb436-1"><a href="#cb436-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -7501,21 +7594,21 @@ class="math display"><em>f̂</em>(<em>ξ</em>) = ∫<sub>−∞</sub><sup>
class="tex">T<sub>e</sub>X</span>t Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb434"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb434-1"><a href="#cb434-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
-<span id="cb434-2"><a href="#cb434-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[texMathDoubleBackslash = yes]</span>
-<span id="cb434-3"><a href="#cb434-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
-<span id="cb434-4"><a href="#cb434-4" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb434-5"><a href="#cb434-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb434-6"><a href="#cb434-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\\</span>(E=mc^2<span class="fu">\\</span>)</span>
-<span id="cb434-7"><a href="#cb434-7" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb434-8"><a href="#cb434-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\\</span>[<span class="fu">\hat</span>{f} <span class="fu">\left</span> ( <span class="fu">\xi</span> <span class="fu">\right</span> )= <span class="fu">\int</span>_{-<span class="fu">\infty</span>}^{<span class="fu">\infty</span>} f<span class="fu">\left</span> ( x <span class="fu">\right</span> ) e^{-i2<span class="fu">\pi</span> <span class="fu">\xi</span> x} dx<span class="fu">\\</span>]</span>
-<span id="cb434-9"><a href="#cb434-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb434-10"><a href="#cb434-10" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb434-11"><a href="#cb434-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
+<div class="sourceCode" id="cb437"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb437-1"><a href="#cb437-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
+<span id="cb437-2"><a href="#cb437-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[texMathDoubleBackslash = yes]</span>
+<span id="cb437-3"><a href="#cb437-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
+<span id="cb437-4"><a href="#cb437-4" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb437-5"><a href="#cb437-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb437-6"><a href="#cb437-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\\</span>(E=mc^2<span class="fu">\\</span>)</span>
+<span id="cb437-7"><a href="#cb437-7" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb437-8"><a href="#cb437-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\\</span>[<span class="fu">\hat</span>{f} <span class="fu">\left</span> ( <span class="fu">\xi</span> <span class="fu">\right</span> )= <span class="fu">\int</span>_{-<span class="fu">\infty</span>}^{<span class="fu">\infty</span>} f<span class="fu">\left</span> ( x <span class="fu">\right</span> ) e^{-i2<span class="fu">\pi</span> <span class="fu">\xi</span> x} dx<span class="fu">\\</span>]</span>
+<span id="cb437-9"><a href="#cb437-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb437-10"><a href="#cb437-10" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb437-11"><a href="#cb437-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb435"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb435-1"><a href="#cb435-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb438"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb438-1"><a href="#cb438-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -7524,8 +7617,8 @@ class="math inline"><em>E</em> = <em>m</em><em>c</em><sup>2</sup></span></p>
<p><span
class="math display"><em>f̂</em>(<em>ξ</em>) = ∫<sub>−∞</sub><sup>∞</sup><em>f</em>(<em>x</em>)<em>e</em><sup>−<em>i</em>2<em>π</em><em>ξ</em><em>x</em></sup><em>d</em><em>x</em></span></p>
</blockquote>
-<h4 data-number="2.2.1.62" id="option-texmathsinglebackslash"><span
-class="header-section-number">2.2.1.62</span> Option
+<h4 data-number="2.2.1.63" id="option-texmathsinglebackslash"><span
+class="header-section-number">2.2.1.63</span> Option
<code>texMathSingleBackslash</code></h4>
<dl>
<dt><code>texMathSingleBackslash</code> (default value:
@@ -7537,10 +7630,10 @@ class="header-section-number">2.2.1.62</span> Option
<p>Enable the Pandoc <a
href="https://pandoc.org/MANUAL.html#extension-tex_math_single_backslash">single
backslash math syntax extension</a>:</p>
-<div class="sourceCode" id="cb436"><pre
-class="sourceCode md"><code class="sourceCode markdown"><span id="cb436-1"><a href="#cb436-1" aria-hidden="true" tabindex="-1"></a><span class="an">inline math:</span><span class="co"> \(E=mc^2\)</span></span>
-<span id="cb436-2"><a href="#cb436-2" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb436-3"><a href="#cb436-3" aria-hidden="true" tabindex="-1"></a>display math: <span class="sc">\[</span>E=mc^2<span class="sc">\]</span></span></code></pre></div>
+<div class="sourceCode" id="cb439"><pre
+class="sourceCode md"><code class="sourceCode markdown"><span id="cb439-1"><a href="#cb439-1" aria-hidden="true" tabindex="-1"></a><span class="an">inline math:</span><span class="co"> \(E=mc^2\)</span></span>
+<span id="cb439-2"><a href="#cb439-2" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb439-3"><a href="#cb439-3" aria-hidden="true" tabindex="-1"></a>display math: <span class="sc">\[</span>E=mc^2<span class="sc">\]</span></span></code></pre></div>
</dd>
</dl>
</dd>
@@ -7557,25 +7650,25 @@ class="sourceCode md"><code class="sourceCode markdown"><span id="cb436-1"><a hr
Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb437"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb437-1"><a href="#cb437-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
-<span id="cb437-2"><a href="#cb437-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> lmfonts</span>
-<span id="cb437-3"><a href="#cb437-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\begingroup</span></span>
-<span id="cb437-4"><a href="#cb437-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\catcode</span>`<span class="fu">\%</span>=12</span>
-<span id="cb437-5"><a href="#cb437-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\catcode</span>`<span class="fu">\#</span>=12</span>
-<span id="cb437-6"><a href="#cb437-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\directlua</span>{</span>
-<span id="cb437-7"><a href="#cb437-7" aria-hidden="true" tabindex="-1"></a> local markdown = require(&quot;markdown&quot;)</span>
-<span id="cb437-8"><a href="#cb437-8" aria-hidden="true" tabindex="-1"></a> local newline = [[^^J^^J]]</span>
-<span id="cb437-9"><a href="#cb437-9" aria-hidden="true" tabindex="-1"></a> local convert = markdown.new({texMathSingleBackslash = true})</span>
-<span id="cb437-10"><a href="#cb437-10" aria-hidden="true" tabindex="-1"></a> local input =</span>
-<span id="cb437-11"><a href="#cb437-11" aria-hidden="true" tabindex="-1"></a> [[<span class="ss">\(E=mc^2\)</span>]] .. newline .. newline ..</span>
-<span id="cb437-12"><a href="#cb437-12" aria-hidden="true" tabindex="-1"></a> [[<span class="ss">\[</span><span class="sc">\hat</span><span class="ss">{f} </span><span class="sc">\left</span><span class="ss"> ( </span><span class="sc">\xi</span><span class="ss"> </span><span class="sc">\right</span><span class="ss"> )= </span><span class="sc">\int</span><span class="ss">_{-</span><span class="sc">\infty</span><span class="ss">}^{</span><span class="sc">\infty</span><span class="ss">} f</span><span class="sc">\left</span><span class="ss"> ( x </span><span class="sc">\right</span><span class="ss"> ) e^{-i2</span><span class="sc">\pi</span><span class="ss"> </span><span class="sc">\xi</span><span class="ss"> x} dx\]</span>]]</span>
-<span id="cb437-13"><a href="#cb437-13" aria-hidden="true" tabindex="-1"></a> tex.sprint(convert(input)) }</span>
-<span id="cb437-14"><a href="#cb437-14" aria-hidden="true" tabindex="-1"></a><span class="fu">\endgroup</span></span>
-<span id="cb437-15"><a href="#cb437-15" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb440"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb440-1"><a href="#cb440-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
+<span id="cb440-2"><a href="#cb440-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> lmfonts</span>
+<span id="cb440-3"><a href="#cb440-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\begingroup</span></span>
+<span id="cb440-4"><a href="#cb440-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\catcode</span>`<span class="fu">\%</span>=12</span>
+<span id="cb440-5"><a href="#cb440-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\catcode</span>`<span class="fu">\#</span>=12</span>
+<span id="cb440-6"><a href="#cb440-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\directlua</span>{</span>
+<span id="cb440-7"><a href="#cb440-7" aria-hidden="true" tabindex="-1"></a> local markdown = require(&quot;markdown&quot;)</span>
+<span id="cb440-8"><a href="#cb440-8" aria-hidden="true" tabindex="-1"></a> local newline = [[^^J^^J]]</span>
+<span id="cb440-9"><a href="#cb440-9" aria-hidden="true" tabindex="-1"></a> local convert = markdown.new({texMathSingleBackslash = true})</span>
+<span id="cb440-10"><a href="#cb440-10" aria-hidden="true" tabindex="-1"></a> local input =</span>
+<span id="cb440-11"><a href="#cb440-11" aria-hidden="true" tabindex="-1"></a> [[<span class="ss">\(E=mc^2\)</span>]] .. newline .. newline ..</span>
+<span id="cb440-12"><a href="#cb440-12" aria-hidden="true" tabindex="-1"></a> [[<span class="ss">\[</span><span class="sc">\hat</span><span class="ss">{f} </span><span class="sc">\left</span><span class="ss"> ( </span><span class="sc">\xi</span><span class="ss"> </span><span class="sc">\right</span><span class="ss"> )= </span><span class="sc">\int</span><span class="ss">_{-</span><span class="sc">\infty</span><span class="ss">}^{</span><span class="sc">\infty</span><span class="ss">} f</span><span class="sc">\left</span><span class="ss"> ( x </span><span class="sc">\right</span><span class="ss"> ) e^{-i2</span><span class="sc">\pi</span><span class="ss"> </span><span class="sc">\xi</span><span class="ss"> x} dx\]</span>]]</span>
+<span id="cb440-13"><a href="#cb440-13" aria-hidden="true" tabindex="-1"></a> tex.sprint(convert(input)) }</span>
+<span id="cb440-14"><a href="#cb440-14" aria-hidden="true" tabindex="-1"></a><span class="fu">\endgroup</span></span>
+<span id="cb440-15"><a href="#cb440-15" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Then, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb438"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb438-1"><a href="#cb438-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb441"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb441-1"><a href="#cb441-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -7587,28 +7680,28 @@ class="math display"><em>f̂</em>(<em>ξ</em>) = ∫<sub>−∞</sub><sup>
<h5 class="unnumbered" id="lua-cli-example-14">Lua CLI Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb439"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb439-1"><a href="#cb439-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
-<span id="cb439-2"><a href="#cb439-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> lmfonts</span>
-<span id="cb439-3"><a href="#cb439-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\begingroup</span></span>
-<span id="cb439-4"><a href="#cb439-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\catcode</span>`<span class="fu">\%</span>=12</span>
-<span id="cb439-5"><a href="#cb439-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\catcode</span>`<span class="fu">\#</span>=12</span>
-<span id="cb439-6"><a href="#cb439-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> optionfalse</span>
-<span id="cb439-7"><a href="#cb439-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\par</span></span>
-<span id="cb439-8"><a href="#cb439-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> optiontrue</span>
-<span id="cb439-9"><a href="#cb439-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\endgroup</span></span>
-<span id="cb439-10"><a href="#cb439-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb442"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb442-1"><a href="#cb442-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
+<span id="cb442-2"><a href="#cb442-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> lmfonts</span>
+<span id="cb442-3"><a href="#cb442-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\begingroup</span></span>
+<span id="cb442-4"><a href="#cb442-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\catcode</span>`<span class="fu">\%</span>=12</span>
+<span id="cb442-5"><a href="#cb442-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\catcode</span>`<span class="fu">\#</span>=12</span>
+<span id="cb442-6"><a href="#cb442-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> optionfalse</span>
+<span id="cb442-7"><a href="#cb442-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\par</span></span>
+<span id="cb442-8"><a href="#cb442-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> optiontrue</span>
+<span id="cb442-9"><a href="#cb442-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\endgroup</span></span>
+<span id="cb442-10"><a href="#cb442-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Using a text editor, create a text document named
<code>content.md</code> with the following content:</p>
-<div class="sourceCode" id="cb440"><pre
-class="sourceCode md"><code class="sourceCode markdown"><span id="cb440-1"><a href="#cb440-1" aria-hidden="true" tabindex="-1"></a><span class="sc">\(</span>E=mc^2<span class="sc">\)</span></span>
-<span id="cb440-2"><a href="#cb440-2" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb440-3"><a href="#cb440-3" aria-hidden="true" tabindex="-1"></a><span class="sc">\[</span>\hat{f} \left ( \xi \right )= \int_{-\infty}^{\infty} f\left ( x \right ) e^{-i2\pi \xi x} dx<span class="sc">\]</span></span></code></pre></div>
+<div class="sourceCode" id="cb443"><pre
+class="sourceCode md"><code class="sourceCode markdown"><span id="cb443-1"><a href="#cb443-1" aria-hidden="true" tabindex="-1"></a><span class="sc">\(</span>E=mc^2<span class="sc">\)</span></span>
+<span id="cb443-2"><a href="#cb443-2" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb443-3"><a href="#cb443-3" aria-hidden="true" tabindex="-1"></a><span class="sc">\[</span>\hat{f} \left ( \xi \right )= \int_{-\infty}^{\infty} f\left ( x \right ) e^{-i2\pi \xi x} dx<span class="sc">\]</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb441"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb441-1"><a href="#cb441-1" aria-hidden="true" tabindex="-1"></a><span class="ex">texlua</span> ⟨CLI pathname⟩ <span class="at">--</span> content.md optionfalse.tex</span>
-<span id="cb441-2"><a href="#cb441-2" aria-hidden="true" tabindex="-1"></a><span class="ex">texlua</span> ⟨CLI pathname⟩ texMathSingleBackslash=true <span class="at">--</span> content.md optiontrue.tex</span>
-<span id="cb441-3"><a href="#cb441-3" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb444"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb444-1"><a href="#cb444-1" aria-hidden="true" tabindex="-1"></a><span class="ex">texlua</span> ⟨CLI pathname⟩ <span class="at">--</span> content.md optionfalse.tex</span>
+<span id="cb444-2"><a href="#cb444-2" aria-hidden="true" tabindex="-1"></a><span class="ex">texlua</span> ⟨CLI pathname⟩ texMathSingleBackslash=true <span class="at">--</span> content.md optiontrue.tex</span>
+<span id="cb444-3"><a href="#cb444-3" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
<p>where ⟨<em>CLI pathname</em>⟩ corresponds to the location of the Lua
CLI script file, such as
<code>~/texmf/scripts/markdown/markdown-cli.lua</code> on UN*X systems
@@ -7633,20 +7726,20 @@ class="math display"><em>f̂</em>(<em>ξ</em>) = ∫<sub>−∞</sub><sup>
class="tex">T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb442"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb442-1"><a href="#cb442-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
-<span id="cb442-2"><a href="#cb442-2" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb442-3"><a href="#cb442-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionTexMathSingleBackslash</span>{true}</span>
-<span id="cb442-4"><a href="#cb442-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
-<span id="cb442-5"><a href="#cb442-5" aria-hidden="true" tabindex="-1"></a><span class="ss">\(E=mc^2\)</span></span>
-<span id="cb442-6"><a href="#cb442-6" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb442-7"><a href="#cb442-7" aria-hidden="true" tabindex="-1"></a><span class="ss">\[</span><span class="sc">\hat</span><span class="ss">{f} </span><span class="sc">\left</span><span class="ss"> ( </span><span class="sc">\xi</span><span class="ss"> </span><span class="sc">\right</span><span class="ss"> )= </span><span class="sc">\int</span><span class="ss">_{-</span><span class="sc">\infty</span><span class="ss">}^{</span><span class="sc">\infty</span><span class="ss">} f</span><span class="sc">\left</span><span class="ss"> ( x </span><span class="sc">\right</span><span class="ss"> ) e^{-i2</span><span class="sc">\pi</span><span class="ss"> </span><span class="sc">\xi</span><span class="ss"> x} dx\]</span></span>
-<span id="cb442-8"><a href="#cb442-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
-<span id="cb442-9"><a href="#cb442-9" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb442-10"><a href="#cb442-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb445"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb445-1"><a href="#cb445-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
+<span id="cb445-2"><a href="#cb445-2" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb445-3"><a href="#cb445-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionTexMathSingleBackslash</span>{true}</span>
+<span id="cb445-4"><a href="#cb445-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
+<span id="cb445-5"><a href="#cb445-5" aria-hidden="true" tabindex="-1"></a><span class="ss">\(E=mc^2\)</span></span>
+<span id="cb445-6"><a href="#cb445-6" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb445-7"><a href="#cb445-7" aria-hidden="true" tabindex="-1"></a><span class="ss">\[</span><span class="sc">\hat</span><span class="ss">{f} </span><span class="sc">\left</span><span class="ss"> ( </span><span class="sc">\xi</span><span class="ss"> </span><span class="sc">\right</span><span class="ss"> )= </span><span class="sc">\int</span><span class="ss">_{-</span><span class="sc">\infty</span><span class="ss">}^{</span><span class="sc">\infty</span><span class="ss">} f</span><span class="sc">\left</span><span class="ss"> ( x </span><span class="sc">\right</span><span class="ss"> ) e^{-i2</span><span class="sc">\pi</span><span class="ss"> </span><span class="sc">\xi</span><span class="ss"> x} dx\]</span></span>
+<span id="cb445-8"><a href="#cb445-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
+<span id="cb445-9"><a href="#cb445-9" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb445-10"><a href="#cb445-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb443"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb443-1"><a href="#cb443-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb446"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb446-1"><a href="#cb446-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -7659,21 +7752,21 @@ class="math display"><em>f̂</em>(<em>ξ</em>) = ∫<sub>−∞</sub><sup>
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb444"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb444-1"><a href="#cb444-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb444-2"><a href="#cb444-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[texMathSingleBackslash]{<span class="ex">markdown</span>}</span>
-<span id="cb444-3"><a href="#cb444-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb444-4"><a href="#cb444-4" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb444-5"><a href="#cb444-5" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb444-6"><a href="#cb444-6" aria-hidden="true" tabindex="-1"></a><span class="ss">\(E=mc^2\)</span></span>
-<span id="cb444-7"><a href="#cb444-7" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb444-8"><a href="#cb444-8" aria-hidden="true" tabindex="-1"></a><span class="ss">\[</span><span class="sc">\hat</span><span class="ss">{f} </span><span class="sc">\left</span><span class="ss"> ( </span><span class="sc">\xi</span><span class="ss"> </span><span class="sc">\right</span><span class="ss"> )= </span><span class="sc">\int</span><span class="ss">_{-</span><span class="sc">\infty</span><span class="ss">}^{</span><span class="sc">\infty</span><span class="ss">} f</span><span class="sc">\left</span><span class="ss"> ( x </span><span class="sc">\right</span><span class="ss"> ) e^{-i2</span><span class="sc">\pi</span><span class="ss"> </span><span class="sc">\xi</span><span class="ss"> x} dx\]</span></span>
-<span id="cb444-9"><a href="#cb444-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb444-10"><a href="#cb444-10" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb444-11"><a href="#cb444-11" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb447"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb447-1"><a href="#cb447-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb447-2"><a href="#cb447-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[texMathSingleBackslash]{<span class="ex">markdown</span>}</span>
+<span id="cb447-3"><a href="#cb447-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb447-4"><a href="#cb447-4" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb447-5"><a href="#cb447-5" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb447-6"><a href="#cb447-6" aria-hidden="true" tabindex="-1"></a><span class="ss">\(E=mc^2\)</span></span>
+<span id="cb447-7"><a href="#cb447-7" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb447-8"><a href="#cb447-8" aria-hidden="true" tabindex="-1"></a><span class="ss">\[</span><span class="sc">\hat</span><span class="ss">{f} </span><span class="sc">\left</span><span class="ss"> ( </span><span class="sc">\xi</span><span class="ss"> </span><span class="sc">\right</span><span class="ss"> )= </span><span class="sc">\int</span><span class="ss">_{-</span><span class="sc">\infty</span><span class="ss">}^{</span><span class="sc">\infty</span><span class="ss">} f</span><span class="sc">\left</span><span class="ss"> ( x </span><span class="sc">\right</span><span class="ss"> ) e^{-i2</span><span class="sc">\pi</span><span class="ss"> </span><span class="sc">\xi</span><span class="ss"> x} dx\]</span></span>
+<span id="cb447-9"><a href="#cb447-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb447-10"><a href="#cb447-10" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb447-11"><a href="#cb447-11" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb445"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb445-1"><a href="#cb445-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb448"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb448-1"><a href="#cb448-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -7686,21 +7779,21 @@ class="math display"><em>f̂</em>(<em>ξ</em>) = ∫<sub>−∞</sub><sup>
class="tex">T<sub>e</sub>X</span>t Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb446"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb446-1"><a href="#cb446-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
-<span id="cb446-2"><a href="#cb446-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[texMathSingleBackslash = yes]</span>
-<span id="cb446-3"><a href="#cb446-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
-<span id="cb446-4"><a href="#cb446-4" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb446-5"><a href="#cb446-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb446-6"><a href="#cb446-6" aria-hidden="true" tabindex="-1"></a><span class="ss">\(E=mc^2\)</span></span>
-<span id="cb446-7"><a href="#cb446-7" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb446-8"><a href="#cb446-8" aria-hidden="true" tabindex="-1"></a><span class="ss">\[</span><span class="sc">\hat</span><span class="ss">{f} </span><span class="sc">\left</span><span class="ss"> ( </span><span class="sc">\xi</span><span class="ss"> </span><span class="sc">\right</span><span class="ss"> )= </span><span class="sc">\int</span><span class="ss">_{-</span><span class="sc">\infty</span><span class="ss">}^{</span><span class="sc">\infty</span><span class="ss">} f</span><span class="sc">\left</span><span class="ss"> ( x </span><span class="sc">\right</span><span class="ss"> ) e^{-i2</span><span class="sc">\pi</span><span class="ss"> </span><span class="sc">\xi</span><span class="ss"> x} dx\]</span></span>
-<span id="cb446-9"><a href="#cb446-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb446-10"><a href="#cb446-10" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb446-11"><a href="#cb446-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
+<div class="sourceCode" id="cb449"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb449-1"><a href="#cb449-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
+<span id="cb449-2"><a href="#cb449-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[texMathSingleBackslash = yes]</span>
+<span id="cb449-3"><a href="#cb449-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
+<span id="cb449-4"><a href="#cb449-4" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb449-5"><a href="#cb449-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb449-6"><a href="#cb449-6" aria-hidden="true" tabindex="-1"></a><span class="ss">\(E=mc^2\)</span></span>
+<span id="cb449-7"><a href="#cb449-7" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb449-8"><a href="#cb449-8" aria-hidden="true" tabindex="-1"></a><span class="ss">\[</span><span class="sc">\hat</span><span class="ss">{f} </span><span class="sc">\left</span><span class="ss"> ( </span><span class="sc">\xi</span><span class="ss"> </span><span class="sc">\right</span><span class="ss"> )= </span><span class="sc">\int</span><span class="ss">_{-</span><span class="sc">\infty</span><span class="ss">}^{</span><span class="sc">\infty</span><span class="ss">} f</span><span class="sc">\left</span><span class="ss"> ( x </span><span class="sc">\right</span><span class="ss"> ) e^{-i2</span><span class="sc">\pi</span><span class="ss"> </span><span class="sc">\xi</span><span class="ss"> x} dx\]</span></span>
+<span id="cb449-9"><a href="#cb449-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb449-10"><a href="#cb449-10" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb449-11"><a href="#cb449-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb447"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb447-1"><a href="#cb447-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb450"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb450-1"><a href="#cb450-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -7709,8 +7802,8 @@ class="math inline"><em>E</em> = <em>m</em><em>c</em><sup>2</sup></span></p>
<p><span
class="math display"><em>f̂</em>(<em>ξ</em>) = ∫<sub>−∞</sub><sup>∞</sup><em>f</em>(<em>x</em>)<em>e</em><sup>−<em>i</em>2<em>π</em><em>ξ</em><em>x</em></sup><em>d</em><em>x</em></span></p>
</blockquote>
-<h4 data-number="2.2.1.63" id="option-tightlists"><span
-class="header-section-number">2.2.1.63</span> Option
+<h4 data-number="2.2.1.64" id="option-tightlists"><span
+class="header-section-number">2.2.1.64</span> Option
<code>tightLists</code></h4>
<dl>
<dt><code>tightLists</code> (default value: <code>true</code>)</dt>
@@ -7722,16 +7815,16 @@ class="header-section-number">2.2.1.63</span> Option
paragraphs will be considered <em>tight</em>. Tight lists will produce
tight renderers that may produce different output than lists that are
not tight:</p>
-<div class="sourceCode" id="cb448"><pre
-class="sourceCode md"><code class="sourceCode markdown"><span id="cb448-1"><a href="#cb448-1" aria-hidden="true" tabindex="-1"></a><span class="ss">- </span>This is</span>
-<span id="cb448-2"><a href="#cb448-2" aria-hidden="true" tabindex="-1"></a><span class="ss">- </span>a tight</span>
-<span id="cb448-3"><a href="#cb448-3" aria-hidden="true" tabindex="-1"></a><span class="ss">- </span>unordered list.</span>
-<span id="cb448-4"><a href="#cb448-4" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb448-5"><a href="#cb448-5" aria-hidden="true" tabindex="-1"></a><span class="ss">- </span>This is</span>
-<span id="cb448-6"><a href="#cb448-6" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb448-7"><a href="#cb448-7" aria-hidden="true" tabindex="-1"></a> not a tight</span>
-<span id="cb448-8"><a href="#cb448-8" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb448-9"><a href="#cb448-9" aria-hidden="true" tabindex="-1"></a><span class="ss">- </span>unordered list.</span></code></pre></div>
+<div class="sourceCode" id="cb451"><pre
+class="sourceCode md"><code class="sourceCode markdown"><span id="cb451-1"><a href="#cb451-1" aria-hidden="true" tabindex="-1"></a><span class="ss">- </span>This is</span>
+<span id="cb451-2"><a href="#cb451-2" aria-hidden="true" tabindex="-1"></a><span class="ss">- </span>a tight</span>
+<span id="cb451-3"><a href="#cb451-3" aria-hidden="true" tabindex="-1"></a><span class="ss">- </span>unordered list.</span>
+<span id="cb451-4"><a href="#cb451-4" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb451-5"><a href="#cb451-5" aria-hidden="true" tabindex="-1"></a><span class="ss">- </span>This is</span>
+<span id="cb451-6"><a href="#cb451-6" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb451-7"><a href="#cb451-7" aria-hidden="true" tabindex="-1"></a> not a tight</span>
+<span id="cb451-8"><a href="#cb451-8" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb451-9"><a href="#cb451-9" aria-hidden="true" tabindex="-1"></a><span class="ss">- </span>unordered list.</span></code></pre></div>
</dd>
</dl>
</dd>
@@ -7750,39 +7843,39 @@ multiple paragraphs.</p>
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb449"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb449-1"><a href="#cb449-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb449-2"><a href="#cb449-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span>
-<span id="cb449-3"><a href="#cb449-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb449-4"><a href="#cb449-4" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb449-5"><a href="#cb449-5" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb449-6"><a href="#cb449-6" aria-hidden="true" tabindex="-1"></a>The following list is tight:</span>
-<span id="cb449-7"><a href="#cb449-7" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb449-8"><a href="#cb449-8" aria-hidden="true" tabindex="-1"></a>- first item</span>
-<span id="cb449-9"><a href="#cb449-9" aria-hidden="true" tabindex="-1"></a>- second item</span>
-<span id="cb449-10"><a href="#cb449-10" aria-hidden="true" tabindex="-1"></a>- third item</span>
-<span id="cb449-11"><a href="#cb449-11" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb449-12"><a href="#cb449-12" aria-hidden="true" tabindex="-1"></a>The following list is loose:</span>
-<span id="cb449-13"><a href="#cb449-13" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb449-14"><a href="#cb449-14" aria-hidden="true" tabindex="-1"></a>- first item</span>
-<span id="cb449-15"><a href="#cb449-15" aria-hidden="true" tabindex="-1"></a>- second item that spans</span>
-<span id="cb449-16"><a href="#cb449-16" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb449-17"><a href="#cb449-17" aria-hidden="true" tabindex="-1"></a> multiple paragraphs</span>
-<span id="cb449-18"><a href="#cb449-18" aria-hidden="true" tabindex="-1"></a>- third item</span>
-<span id="cb449-19"><a href="#cb449-19" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb449-20"><a href="#cb449-20" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb449-21"><a href="#cb449-21" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}[tightLists=false]</span>
-<span id="cb449-22"><a href="#cb449-22" aria-hidden="true" tabindex="-1"></a>The following list is now also loose:</span>
-<span id="cb449-23"><a href="#cb449-23" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb449-24"><a href="#cb449-24" aria-hidden="true" tabindex="-1"></a>- first item</span>
-<span id="cb449-25"><a href="#cb449-25" aria-hidden="true" tabindex="-1"></a>- second item</span>
-<span id="cb449-26"><a href="#cb449-26" aria-hidden="true" tabindex="-1"></a>- third item</span>
-<span id="cb449-27"><a href="#cb449-27" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb449-28"><a href="#cb449-28" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb449-29"><a href="#cb449-29" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb452"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb452-1"><a href="#cb452-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb452-2"><a href="#cb452-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span>
+<span id="cb452-3"><a href="#cb452-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb452-4"><a href="#cb452-4" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb452-5"><a href="#cb452-5" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb452-6"><a href="#cb452-6" aria-hidden="true" tabindex="-1"></a>The following list is tight:</span>
+<span id="cb452-7"><a href="#cb452-7" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb452-8"><a href="#cb452-8" aria-hidden="true" tabindex="-1"></a>- first item</span>
+<span id="cb452-9"><a href="#cb452-9" aria-hidden="true" tabindex="-1"></a>- second item</span>
+<span id="cb452-10"><a href="#cb452-10" aria-hidden="true" tabindex="-1"></a>- third item</span>
+<span id="cb452-11"><a href="#cb452-11" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb452-12"><a href="#cb452-12" aria-hidden="true" tabindex="-1"></a>The following list is loose:</span>
+<span id="cb452-13"><a href="#cb452-13" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb452-14"><a href="#cb452-14" aria-hidden="true" tabindex="-1"></a>- first item</span>
+<span id="cb452-15"><a href="#cb452-15" aria-hidden="true" tabindex="-1"></a>- second item that spans</span>
+<span id="cb452-16"><a href="#cb452-16" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb452-17"><a href="#cb452-17" aria-hidden="true" tabindex="-1"></a> multiple paragraphs</span>
+<span id="cb452-18"><a href="#cb452-18" aria-hidden="true" tabindex="-1"></a>- third item</span>
+<span id="cb452-19"><a href="#cb452-19" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb452-20"><a href="#cb452-20" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb452-21"><a href="#cb452-21" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}[tightLists=false]</span>
+<span id="cb452-22"><a href="#cb452-22" aria-hidden="true" tabindex="-1"></a>The following list is now also loose:</span>
+<span id="cb452-23"><a href="#cb452-23" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb452-24"><a href="#cb452-24" aria-hidden="true" tabindex="-1"></a>- first item</span>
+<span id="cb452-25"><a href="#cb452-25" aria-hidden="true" tabindex="-1"></a>- second item</span>
+<span id="cb452-26"><a href="#cb452-26" aria-hidden="true" tabindex="-1"></a>- third item</span>
+<span id="cb452-27"><a href="#cb452-27" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb452-28"><a href="#cb452-28" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb452-29"><a href="#cb452-29" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb450"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb450-1"><a href="#cb450-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb453"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb453-1"><a href="#cb453-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -7806,8 +7899,8 @@ contain the following text:</p>
<li><p>third item</p></li>
</ul>
</blockquote>
-<h4 data-number="2.2.1.64" id="option-underscores"><span
-class="header-section-number">2.2.1.64</span> Option
+<h4 data-number="2.2.1.65" id="option-underscores"><span
+class="header-section-number">2.2.1.65</span> Option
<code>underscores</code></h4>
<dl>
<dt><code>underscores</code> (default value: <code>true</code>)</dt>
@@ -7817,11 +7910,11 @@ class="header-section-number">2.2.1.64</span> Option
<dd>
<p>Both underscores and asterisks can be used to denote emphasis and
strong emphasis:</p>
-<div class="sourceCode" id="cb451"><pre
-class="sourceCode md"><code class="sourceCode markdown"><span id="cb451-1"><a href="#cb451-1" aria-hidden="true" tabindex="-1"></a>*single asterisks*</span>
-<span id="cb451-2"><a href="#cb451-2" aria-hidden="true" tabindex="-1"></a>_single underscores_</span>
-<span id="cb451-3"><a href="#cb451-3" aria-hidden="true" tabindex="-1"></a>**double asterisks**</span>
-<span id="cb451-4"><a href="#cb451-4" aria-hidden="true" tabindex="-1"></a>__double underscores__</span></code></pre></div>
+<div class="sourceCode" id="cb454"><pre
+class="sourceCode md"><code class="sourceCode markdown"><span id="cb454-1"><a href="#cb454-1" aria-hidden="true" tabindex="-1"></a>*single asterisks*</span>
+<span id="cb454-2"><a href="#cb454-2" aria-hidden="true" tabindex="-1"></a>_single underscores_</span>
+<span id="cb454-3"><a href="#cb454-3" aria-hidden="true" tabindex="-1"></a>**double asterisks**</span>
+<span id="cb454-4"><a href="#cb454-4" aria-hidden="true" tabindex="-1"></a>__double underscores__</span></code></pre></div>
</dd>
</dl>
</dd>
@@ -7831,7 +7924,7 @@ class="sourceCode md"><code class="sourceCode markdown"><span id="cb451-1"><a hr
<dd>
<p>Only asterisks can be used to denote emphasis and strong emphasis.
This makes it easy to write math with the
-<strong><code>hybrid</code></strong> option without the need to
+<code><strong>hybrid</strong></code> option without the need to
constantly escape subscripts.</p>
</dd>
</dl>
@@ -7841,23 +7934,23 @@ constantly escape subscripts.</p>
class="tex">T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb452"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb452-1"><a href="#cb452-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
-<span id="cb452-2"><a href="#cb452-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionHybrid</span>{true}</span>
-<span id="cb452-3"><a href="#cb452-3" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb452-4"><a href="#cb452-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
-<span id="cb452-5"><a href="#cb452-5" aria-hidden="true" tabindex="-1"></a>This is _emphasized text_ and this is a math subscript: <span class="ss">$m</span><span class="sc">\_</span><span class="ss">n$</span>.</span>
-<span id="cb452-6"><a href="#cb452-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
-<span id="cb452-7"><a href="#cb452-7" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb452-8"><a href="#cb452-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionUnderscores</span>{false}</span>
-<span id="cb452-9"><a href="#cb452-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
-<span id="cb452-10"><a href="#cb452-10" aria-hidden="true" tabindex="-1"></a>This is *emphasized text* and this is a math subscript: <span class="ss">$m_n$</span>.</span>
-<span id="cb452-11"><a href="#cb452-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
-<span id="cb452-12"><a href="#cb452-12" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb452-13"><a href="#cb452-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb455"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb455-1"><a href="#cb455-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
+<span id="cb455-2"><a href="#cb455-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionHybrid</span>{true}</span>
+<span id="cb455-3"><a href="#cb455-3" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb455-4"><a href="#cb455-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
+<span id="cb455-5"><a href="#cb455-5" aria-hidden="true" tabindex="-1"></a>This is _emphasized text_ and this is a math subscript: <span class="ss">$m</span><span class="sc">\_</span><span class="ss">n$</span>.</span>
+<span id="cb455-6"><a href="#cb455-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
+<span id="cb455-7"><a href="#cb455-7" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb455-8"><a href="#cb455-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionUnderscores</span>{false}</span>
+<span id="cb455-9"><a href="#cb455-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
+<span id="cb455-10"><a href="#cb455-10" aria-hidden="true" tabindex="-1"></a>This is *emphasized text* and this is a math subscript: <span class="ss">$m_n$</span>.</span>
+<span id="cb455-11"><a href="#cb455-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
+<span id="cb455-12"><a href="#cb455-12" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb455-13"><a href="#cb455-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb453"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb453-1"><a href="#cb453-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb456"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb456-1"><a href="#cb456-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -7870,23 +7963,23 @@ contain the following text:</p>
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb454"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb454-1"><a href="#cb454-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb454-2"><a href="#cb454-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[hybrid]{<span class="ex">markdown</span>}</span>
-<span id="cb454-3"><a href="#cb454-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb454-4"><a href="#cb454-4" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb454-5"><a href="#cb454-5" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb454-6"><a href="#cb454-6" aria-hidden="true" tabindex="-1"></a>This is _emphasized text_ and this is a math subscript: <span class="ss">$m</span><span class="sc">\_</span><span class="ss">n$</span>.</span>
-<span id="cb454-7"><a href="#cb454-7" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb454-8"><a href="#cb454-8" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb454-9"><a href="#cb454-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}[underscores=false]</span>
-<span id="cb454-10"><a href="#cb454-10" aria-hidden="true" tabindex="-1"></a>This is *emphasized text* and this is a math subscript: <span class="ss">$m_n$</span>.</span>
-<span id="cb454-11"><a href="#cb454-11" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb454-12"><a href="#cb454-12" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb454-13"><a href="#cb454-13" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb457"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb457-1"><a href="#cb457-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb457-2"><a href="#cb457-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[hybrid]{<span class="ex">markdown</span>}</span>
+<span id="cb457-3"><a href="#cb457-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb457-4"><a href="#cb457-4" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb457-5"><a href="#cb457-5" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb457-6"><a href="#cb457-6" aria-hidden="true" tabindex="-1"></a>This is _emphasized text_ and this is a math subscript: <span class="ss">$m</span><span class="sc">\_</span><span class="ss">n$</span>.</span>
+<span id="cb457-7"><a href="#cb457-7" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb457-8"><a href="#cb457-8" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb457-9"><a href="#cb457-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}[underscores=false]</span>
+<span id="cb457-10"><a href="#cb457-10" aria-hidden="true" tabindex="-1"></a>This is *emphasized text* and this is a math subscript: <span class="ss">$m_n$</span>.</span>
+<span id="cb457-11"><a href="#cb457-11" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb457-12"><a href="#cb457-12" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb457-13"><a href="#cb457-13" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb455"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb455-1"><a href="#cb455-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb458"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb458-1"><a href="#cb458-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -7899,24 +7992,24 @@ contain the following text:</p>
class="tex">T<sub>e</sub>X</span>t Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb456"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb456-1"><a href="#cb456-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
-<span id="cb456-2"><a href="#cb456-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[hybrid = yes]</span>
-<span id="cb456-3"><a href="#cb456-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
-<span id="cb456-4"><a href="#cb456-4" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb456-5"><a href="#cb456-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb456-6"><a href="#cb456-6" aria-hidden="true" tabindex="-1"></a>This is _emphasized text_ and this is a math subscript: <span class="ss">$m</span><span class="sc">\_</span><span class="ss">n$</span>.</span>
-<span id="cb456-7"><a href="#cb456-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb456-8"><a href="#cb456-8" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb456-9"><a href="#cb456-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[underscores = yes]</span>
-<span id="cb456-10"><a href="#cb456-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb456-11"><a href="#cb456-11" aria-hidden="true" tabindex="-1"></a>This is *emphasized text* and this is a math subscript: <span class="ss">$m_n$</span>.</span>
-<span id="cb456-12"><a href="#cb456-12" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb456-13"><a href="#cb456-13" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb456-14"><a href="#cb456-14" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
+<div class="sourceCode" id="cb459"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb459-1"><a href="#cb459-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
+<span id="cb459-2"><a href="#cb459-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[hybrid = yes]</span>
+<span id="cb459-3"><a href="#cb459-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
+<span id="cb459-4"><a href="#cb459-4" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb459-5"><a href="#cb459-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb459-6"><a href="#cb459-6" aria-hidden="true" tabindex="-1"></a>This is _emphasized text_ and this is a math subscript: <span class="ss">$m</span><span class="sc">\_</span><span class="ss">n$</span>.</span>
+<span id="cb459-7"><a href="#cb459-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb459-8"><a href="#cb459-8" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb459-9"><a href="#cb459-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[underscores = yes]</span>
+<span id="cb459-10"><a href="#cb459-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb459-11"><a href="#cb459-11" aria-hidden="true" tabindex="-1"></a>This is *emphasized text* and this is a math subscript: <span class="ss">$m_n$</span>.</span>
+<span id="cb459-12"><a href="#cb459-12" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb459-13"><a href="#cb459-13" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb459-14"><a href="#cb459-14" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb457"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb457-1"><a href="#cb457-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb460"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb460-1"><a href="#cb460-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -7940,45 +8033,45 @@ class="header-section-number">2.2.2.1</span> Setting Lua options from
plain <span class="tex">T<sub>e</sub>X</span></h4>
<p>As a rule of thumb, you can set all Lua options directly from plain
<span class="tex">T<sub>e</sub>X</span>. For example, to set the
-<strong><code>taskLists</code></strong> Lua option to <code>true</code>,
+<code><strong>taskLists</strong></code> Lua option to <code>true</code>,
you would include the following code in your plain <span
class="tex">T<sub>e</sub>X</span> document:</p>
-<div class="sourceCode" id="cb458"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb458-1"><a href="#cb458-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionTaskLists</span>{true}</span></code></pre></div>
+<div class="sourceCode" id="cb461"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb461-1"><a href="#cb461-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionTaskLists</span>{true}</span></code></pre></div>
<p>Alternatively, you can also set plain <span
class="tex">T<sub>e</sub>X</span> options using the
<code>\markdownSetup</code> <span class="tex">T<sub>e</sub>X</span>
-macro. For example, to set the <strong><code>taskLists</code></strong>
+macro. For example, to set the <code><strong>taskLists</strong></code>
Lua option to <code>true</code>, you would include the following code in
your plain <span class="tex">T<sub>e</sub>X</span> document:</p>
-<div class="sourceCode" id="cb459"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb459-1"><a href="#cb459-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{taskLists = true}</span></code></pre></div>
+<div class="sourceCode" id="cb462"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb462-1"><a href="#cb462-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{taskLists = true}</span></code></pre></div>
<h4 data-number="2.2.2.2" id="finalizing-and-freezing-the-cache"><span
class="header-section-number">2.2.2.2</span> Finalizing and Freezing the
Cache</h4>
-<p>The <code>\markdownOptionFrozenCache</code> option uses the mapping
+<p>The <code>markdownOptionFrozenCache</code> option uses the mapping
previously created by the Lua interface
-<strong><code>finalizeCache</code></strong> option, and uses it to
+<code><strong>finalizeCache</strong></code> option, and uses it to
typeset the plain <span class="tex">T<sub>e</sub>X</span> document
without invoking Lua. As a result, the plain <span
class="tex">T<sub>e</sub>X</span> document becomes more portable, but
further changes in the order and the content of markdown documents will
not be reflected. It defaults to <code>false</code>.</p>
-<p>The standard usage of the <strong><code>finalizeCache</code></strong>
-and <strong><code>frozenCache</code></strong> options is as follows:</p>
+<p>The standard usage of the <code><strong>finalizeCache</strong></code>
+and <code><strong>frozenCache</strong></code> options is as follows:</p>
<ol type="1">
-<li>Remove the <strong><code>cacheDir</code></strong> cache directory
+<li>Remove the <code><strong>cacheDir</strong></code> cache directory
with stale auxiliary cache files.</li>
-<li>Enable the <strong><code>finalizeCache</code></strong> option.</li>
+<li>Enable the <code><strong>finalizeCache</strong></code> option.</li>
<li>Typeset the plain <span class="tex">T<sub>e</sub>X</span> document
to populate and finalize the cache.</li>
-<li>Enable the <strong><code>frozenCache</code></strong> option.</li>
+<li>Enable the <code><strong>frozenCache</strong></code> option.</li>
<li>Publish the source code of the plain <span
class="tex">T<sub>e</sub>X</span> document and the
-<strong><code>cacheDir</code></strong> directory.</li>
+<code><strong>cacheDir</strong></code> directory.</li>
</ol>
<p>For more information, see the examples for the
-<strong><code>finalizeCache</code></strong> option.</p>
+<code><strong>finalizeCache</strong></code> option.</p>
<h4 data-number="2.2.2.3" id="file-and-directory-names"><span
class="header-section-number">2.2.2.3</span> File and Directory
Names</h4>
@@ -7999,22 +8092,22 @@ options.</p>
<p>Using a text editor, create a folder named
<code>output-directory</code> and a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb460"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb460-1"><a href="#cb460-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> lmfonts</span>
-<span id="cb460-2"><a href="#cb460-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
-<span id="cb460-3"><a href="#cb460-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionInputTempFileName</span>{temporary-input.md}</span>
-<span id="cb460-4"><a href="#cb460-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionOutputDir</span>{output-directory}</span>
-<span id="cb460-5"><a href="#cb460-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionCacheDir</span>{output-directory/cache-directory}</span>
-<span id="cb460-6"><a href="#cb460-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionEagerCache</span>{true}</span>
-<span id="cb460-7"><a href="#cb460-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionFinalizeCache</span>{true}</span>
-<span id="cb460-8"><a href="#cb460-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionFrozenCacheFileName</span>{output-directory/cache-directory/frozen-cache.tex}</span>
-<span id="cb460-9"><a href="#cb460-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
-<span id="cb460-10"><a href="#cb460-10" aria-hidden="true" tabindex="-1"></a>Hello *world*!</span>
-<span id="cb460-11"><a href="#cb460-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
-<span id="cb460-12"><a href="#cb460-12" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb463"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb463-1"><a href="#cb463-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> lmfonts</span>
+<span id="cb463-2"><a href="#cb463-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
+<span id="cb463-3"><a href="#cb463-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionInputTempFileName</span>{temporary-input.md}</span>
+<span id="cb463-4"><a href="#cb463-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionOutputDir</span>{output-directory}</span>
+<span id="cb463-5"><a href="#cb463-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionCacheDir</span>{output-directory/cache-directory}</span>
+<span id="cb463-6"><a href="#cb463-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionEagerCache</span>{true}</span>
+<span id="cb463-7"><a href="#cb463-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionFinalizeCache</span>{true}</span>
+<span id="cb463-8"><a href="#cb463-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionFrozenCacheFileName</span>{output-directory/cache-directory/frozen-cache.tex}</span>
+<span id="cb463-9"><a href="#cb463-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
+<span id="cb463-10"><a href="#cb463-10" aria-hidden="true" tabindex="-1"></a>Hello *world*!</span>
+<span id="cb463-11"><a href="#cb463-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
+<span id="cb463-12"><a href="#cb463-12" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb461"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb461-1"><a href="#cb461-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> <span class="at">--output-directory</span> output-directory document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb464"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb464-1"><a href="#cb464-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> <span class="at">--output-directory</span> output-directory document.tex</span></code></pre></div>
<p>A text document named <code>temporary-input.md</code> should be
produced in the folder named <code>output-directory</code> and contain
the following text:</p>
@@ -8027,8 +8120,8 @@ document. LuaTeX does not need other temporary files to perform the
conversion from markdown to <span class="tex">T<sub>e</sub>X</span>. To
produce the remaining temporary files, invoke pdfTeX from the
terminal:</p>
-<div class="sourceCode" id="cb462"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb462-1"><a href="#cb462-1" aria-hidden="true" tabindex="-1"></a><span class="ex">pdftex</span> <span class="at">--output-directory</span> output-directory <span class="at">--shell-escape</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb465"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb465-1"><a href="#cb465-1" aria-hidden="true" tabindex="-1"></a><span class="ex">pdftex</span> <span class="at">--output-directory</span> output-directory <span class="at">--shell-escape</span> document.tex</span></code></pre></div>
<p>Text document named <code>temporary-output.md</code> should be
produced in the folder named <code>output-directory</code>. The document
will contain the input markdown document converted to <span
@@ -8045,7 +8138,7 @@ class="latex">L<sup>a</sup>T<sub>e</sub>X</span> and Con<span
class="tex">T<sub>e</sub>X</span>t. Furthermore, the default definitions
may change at any time, which may pose a problem for maintainers of
Markdown themes and templates who may require a stable output.</p>
-<p>The <code>\markdownOptionPlain</code> macro specifies whether
+<p>The <code>markdownOptionPlain</code> macro specifies whether
higher-level <span class="tex">T<sub>e</sub>X</span> formats should only
use the plain <span class="tex">T<sub>e</sub>X</span> default
definitions or whether they should also use the format-specific default
@@ -8060,33 +8153,33 @@ definitions load extra resources and are subject to a more rapid
change.</p>
<p>Here is how you would enable the macro in a <span
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> document:</p>
-<div class="sourceCode" id="cb463"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb463-1"><a href="#cb463-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[plain]{<span class="ex">markdown</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb466"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb466-1"><a href="#cb466-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[plain]{<span class="ex">markdown</span>}</span></code></pre></div>
<p>Here is how you would enable the macro in a Con<span
class="tex">T<sub>e</sub>X</span>t document:</p>
-<div class="sourceCode" id="cb464"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb464-1"><a href="#cb464-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionPlain</span>{true}</span>
-<span id="cb464-2"><a href="#cb464-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span></code></pre></div>
+<div class="sourceCode" id="cb467"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb467-1"><a href="#cb467-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionPlain</span>{true}</span>
+<span id="cb467-2"><a href="#cb467-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span></code></pre></div>
<p>The macro must be set before or during the loading of the package.
Setting the macro after loading the package has no effect.</p>
-<p>The <code>\markdownOptionNoDefaults</code> macro specifies whether we
+<p>The <code>markdownOptionNoDefaults</code> macro specifies whether we
should prevent the loading of default definitions or not. This is useful
in contexts, where we want to have total control over how all elements
are rendered.</p>
<p>Here is how you would enable the macro in a <span
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> document:</p>
-<div class="sourceCode" id="cb465"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb465-1"><a href="#cb465-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[noDefaults]{<span class="ex">markdown</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb468"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb468-1"><a href="#cb468-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[noDefaults]{<span class="ex">markdown</span>}</span></code></pre></div>
<p>Here is how you would enable the macro in a Con<span
class="tex">T<sub>e</sub>X</span>t document:</p>
-<div class="sourceCode" id="cb466"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb466-1"><a href="#cb466-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionNoDefaults</span>{true}</span>
-<span id="cb466-2"><a href="#cb466-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span></code></pre></div>
+<div class="sourceCode" id="cb469"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb469-1"><a href="#cb469-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionNoDefaults</span>{true}</span>
+<span id="cb469-2"><a href="#cb469-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span></code></pre></div>
<p>The macro must be set before or during the loading of the package.
Setting the macro after loading the package has no effect.</p>
<h4 data-number="2.2.2.5" id="package-documentation"><span
class="header-section-number">2.2.2.5</span> Package Documentation</h4>
-<p>The <code>\markdownOptionStripPercentSigns</code> macro controls
+<p>The <code>markdownOptionStripPercentSigns</code> macro controls
whether a percent sign (<code>\%</code>) at the beginning of a line will
be discarded when reading Markdown input from a <span
class="tex">T<sub>e</sub>X</span> document. This enables the use of
@@ -8099,21 +8192,21 @@ Mittelbach. The recognized values of the macro are <code>true</code>
<code>false</code>.</p>
<p>Using a text editor, create a text document named
<code>document.dtx</code> with the following content:</p>
-<div class="sourceCode" id="cb467"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb467-1"><a href="#cb467-1" aria-hidden="true" tabindex="-1"></a><span class="co">% \iffalse</span></span>
-<span id="cb467-2"><a href="#cb467-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">ltxdoc</span>}</span>
-<span id="cb467-3"><a href="#cb467-3" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[stripPercentSigns]{<span class="ex">markdown</span>}</span>
-<span id="cb467-4"><a href="#cb467-4" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb467-5"><a href="#cb467-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\DocInput</span>{document.dtx}</span>
-<span id="cb467-6"><a href="#cb467-6" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span>
-<span id="cb467-7"><a href="#cb467-7" aria-hidden="true" tabindex="-1"></a><span class="co">% \fi</span></span>
-<span id="cb467-8"><a href="#cb467-8" aria-hidden="true" tabindex="-1"></a><span class="co">%</span></span>
-<span id="cb467-9"><a href="#cb467-9" aria-hidden="true" tabindex="-1"></a><span class="co">% \begin{markdown}</span></span>
-<span id="cb467-10"><a href="#cb467-10" aria-hidden="true" tabindex="-1"></a><span class="co">% Hello *world*!</span></span>
-<span id="cb467-11"><a href="#cb467-11" aria-hidden="true" tabindex="-1"></a><span class="co">% \end{markdown}</span></span></code></pre></div>
+<div class="sourceCode" id="cb470"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb470-1"><a href="#cb470-1" aria-hidden="true" tabindex="-1"></a><span class="co">% \iffalse</span></span>
+<span id="cb470-2"><a href="#cb470-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">ltxdoc</span>}</span>
+<span id="cb470-3"><a href="#cb470-3" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[stripPercentSigns]{<span class="ex">markdown</span>}</span>
+<span id="cb470-4"><a href="#cb470-4" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb470-5"><a href="#cb470-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\DocInput</span>{document.dtx}</span>
+<span id="cb470-6"><a href="#cb470-6" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span>
+<span id="cb470-7"><a href="#cb470-7" aria-hidden="true" tabindex="-1"></a><span class="co">% \fi</span></span>
+<span id="cb470-8"><a href="#cb470-8" aria-hidden="true" tabindex="-1"></a><span class="co">%</span></span>
+<span id="cb470-9"><a href="#cb470-9" aria-hidden="true" tabindex="-1"></a><span class="co">% \begin{markdown}</span></span>
+<span id="cb470-10"><a href="#cb470-10" aria-hidden="true" tabindex="-1"></a><span class="co">% Hello *world*!</span></span>
+<span id="cb470-11"><a href="#cb470-11" aria-hidden="true" tabindex="-1"></a><span class="co">% \end{markdown}</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb468"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb468-1"><a href="#cb468-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.dtx</span></code></pre></div>
+<div class="sourceCode" id="cb471"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb471-1"><a href="#cb471-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.dtx</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the text “Hello <em>world</em>!”</p>
<h3 data-number="2.2.3" id="themes"><span
@@ -8125,10 +8218,10 @@ low-level programming.</p>
<p>Built-in plain <span class="tex">T<sub>e</sub>X</span> themes
provided with the Markdown package include:</p>
<dl>
-<dt><strong><code>witiko/tilde</code></strong></dt>
+<dt><code><strong>witiko/tilde</strong></code></dt>
<dd>
<p>A theme that makes tilde (<code>~</code>) always typeset the
-non-breaking space even when the <strong><code>hybrid</code></strong>
+non-breaking space even when the <code><strong>hybrid</strong></code>
Lua option is disabled.</p>
</dd>
</dl>
@@ -8136,16 +8229,16 @@ Lua option is disabled.</p>
class="tex">T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb469"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb469-1"><a href="#cb469-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
-<span id="cb469-2"><a href="#cb469-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{import=witiko/tilde}</span>
-<span id="cb469-3"><a href="#cb469-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
-<span id="cb469-4"><a href="#cb469-4" aria-hidden="true" tabindex="-1"></a>Bartel~Leendert van~der~Waerden</span>
-<span id="cb469-5"><a href="#cb469-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
-<span id="cb469-6"><a href="#cb469-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb472"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb472-1"><a href="#cb472-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
+<span id="cb472-2"><a href="#cb472-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{import=witiko/tilde}</span>
+<span id="cb472-3"><a href="#cb472-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
+<span id="cb472-4"><a href="#cb472-4" aria-hidden="true" tabindex="-1"></a>Bartel~Leendert van~der~Waerden</span>
+<span id="cb472-5"><a href="#cb472-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
+<span id="cb472-6"><a href="#cb472-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb470"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb470-1"><a href="#cb470-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb473"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb473-1"><a href="#cb473-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text, where the middot (<code>·</code>) denotes a
non-breaking space:</p>
@@ -8153,7 +8246,7 @@ non-breaking space:</p>
<p>Bartel·Leendert van·der·Waerden</p>
</blockquote>
<dl>
-<dt><strong><code>witiko/markdown/defaults</code></strong></dt>
+<dt><code><strong>witiko/markdown/defaults</strong></code></dt>
<dd>
<p>A plain <span class="tex">T<sub>e</sub>X</span> theme with the
default definitions of token renderer prototypes for plain <span
@@ -8169,99 +8262,99 @@ document. Snippets provide syntactic sugar for defining and invoking
various options locally.</p>
<p>Here is how we can use snippets to store options and invoke them
later in <span class="latex">L<sup>a</sup>T<sub>e</sub>X</span>:</p>
-<div class="sourceCode" id="cb471"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb471-1"><a href="#cb471-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetupSnippet</span>{romanNumerals}{</span>
-<span id="cb471-2"><a href="#cb471-2" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb471-3"><a href="#cb471-3" aria-hidden="true" tabindex="-1"></a> olItemWithNumber = {<span class="co">%</span></span>
-<span id="cb471-4"><a href="#cb471-4" aria-hidden="true" tabindex="-1"></a> <span class="fu">\item</span>[<span class="fu">\romannumeral</span>#1<span class="fu">\relax</span>.]<span class="co">%</span></span>
-<span id="cb471-5"><a href="#cb471-5" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb471-6"><a href="#cb471-6" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb471-7"><a href="#cb471-7" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb471-8"><a href="#cb471-8" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb471-9"><a href="#cb471-9" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb471-10"><a href="#cb471-10" aria-hidden="true" tabindex="-1"></a>The following ordered list will be preceded by arabic numerals:</span>
-<span id="cb471-11"><a href="#cb471-11" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb471-12"><a href="#cb471-12" aria-hidden="true" tabindex="-1"></a>1. wahid</span>
-<span id="cb471-13"><a href="#cb471-13" aria-hidden="true" tabindex="-1"></a>2. aithnayn</span>
-<span id="cb471-14"><a href="#cb471-14" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb471-15"><a href="#cb471-15" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb471-16"><a href="#cb471-16" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}[snippet=romanNumerals]</span>
-<span id="cb471-17"><a href="#cb471-17" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb471-18"><a href="#cb471-18" aria-hidden="true" tabindex="-1"></a>The following ordered list will be preceded by roman numerals:</span>
-<span id="cb471-19"><a href="#cb471-19" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb471-20"><a href="#cb471-20" aria-hidden="true" tabindex="-1"></a>3. tres</span>
-<span id="cb471-21"><a href="#cb471-21" aria-hidden="true" tabindex="-1"></a>4. quattuor</span>
-<span id="cb471-22"><a href="#cb471-22" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb471-23"><a href="#cb471-23" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb474"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb474-1"><a href="#cb474-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetupSnippet</span>{romanNumerals}{</span>
+<span id="cb474-2"><a href="#cb474-2" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb474-3"><a href="#cb474-3" aria-hidden="true" tabindex="-1"></a> olItemWithNumber = {<span class="co">%</span></span>
+<span id="cb474-4"><a href="#cb474-4" aria-hidden="true" tabindex="-1"></a> <span class="fu">\item</span>[<span class="fu">\romannumeral</span>#1<span class="fu">\relax</span>.]<span class="co">%</span></span>
+<span id="cb474-5"><a href="#cb474-5" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb474-6"><a href="#cb474-6" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb474-7"><a href="#cb474-7" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb474-8"><a href="#cb474-8" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb474-9"><a href="#cb474-9" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb474-10"><a href="#cb474-10" aria-hidden="true" tabindex="-1"></a>The following ordered list will be preceded by arabic numerals:</span>
+<span id="cb474-11"><a href="#cb474-11" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb474-12"><a href="#cb474-12" aria-hidden="true" tabindex="-1"></a>1. wahid</span>
+<span id="cb474-13"><a href="#cb474-13" aria-hidden="true" tabindex="-1"></a>2. aithnayn</span>
+<span id="cb474-14"><a href="#cb474-14" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb474-15"><a href="#cb474-15" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb474-16"><a href="#cb474-16" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}[snippet=romanNumerals]</span>
+<span id="cb474-17"><a href="#cb474-17" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb474-18"><a href="#cb474-18" aria-hidden="true" tabindex="-1"></a>The following ordered list will be preceded by roman numerals:</span>
+<span id="cb474-19"><a href="#cb474-19" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb474-20"><a href="#cb474-20" aria-hidden="true" tabindex="-1"></a>3. tres</span>
+<span id="cb474-21"><a href="#cb474-21" aria-hidden="true" tabindex="-1"></a>4. quattuor</span>
+<span id="cb474-22"><a href="#cb474-22" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb474-23"><a href="#cb474-23" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span></code></pre></div>
<p>If the <code>romanNumerals</code> snippet were defined in the
<code>jdoe/lists</code> theme, we could import the
<code>jdoe/lists</code> theme and use the qualified name
<code>jdoe/lists/romanNumerals</code> to invoke the snippet:</p>
-<div class="sourceCode" id="cb472"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb472-1"><a href="#cb472-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{import=jdoe/lists}</span>
-<span id="cb472-2"><a href="#cb472-2" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}[snippet=jdoe/lists/romanNumerals]</span>
-<span id="cb472-3"><a href="#cb472-3" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb472-4"><a href="#cb472-4" aria-hidden="true" tabindex="-1"></a>The following ordered list will be preceded by roman numerals:</span>
-<span id="cb472-5"><a href="#cb472-5" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb472-6"><a href="#cb472-6" aria-hidden="true" tabindex="-1"></a>3. tres</span>
-<span id="cb472-7"><a href="#cb472-7" aria-hidden="true" tabindex="-1"></a>4. quattuor</span>
-<span id="cb472-8"><a href="#cb472-8" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb472-9"><a href="#cb472-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb475"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb475-1"><a href="#cb475-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{import=jdoe/lists}</span>
+<span id="cb475-2"><a href="#cb475-2" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}[snippet=jdoe/lists/romanNumerals]</span>
+<span id="cb475-3"><a href="#cb475-3" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb475-4"><a href="#cb475-4" aria-hidden="true" tabindex="-1"></a>The following ordered list will be preceded by roman numerals:</span>
+<span id="cb475-5"><a href="#cb475-5" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb475-6"><a href="#cb475-6" aria-hidden="true" tabindex="-1"></a>3. tres</span>
+<span id="cb475-7"><a href="#cb475-7" aria-hidden="true" tabindex="-1"></a>4. quattuor</span>
+<span id="cb475-8"><a href="#cb475-8" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb475-9"><a href="#cb475-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span></code></pre></div>
<p>Alternatively, we can use the extended variant of the
<code>import</code> <span
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> option that allows us
to import the <code>romanNumerals</code> snippet to the current
namespace for easier access:</p>
-<div class="sourceCode" id="cb473"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb473-1"><a href="#cb473-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb473-2"><a href="#cb473-2" aria-hidden="true" tabindex="-1"></a> import = {</span>
-<span id="cb473-3"><a href="#cb473-3" aria-hidden="true" tabindex="-1"></a> jdoe/lists = romanNumerals,</span>
-<span id="cb473-4"><a href="#cb473-4" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb473-5"><a href="#cb473-5" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb473-6"><a href="#cb473-6" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}[snippet=romanNumerals]</span>
-<span id="cb473-7"><a href="#cb473-7" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb473-8"><a href="#cb473-8" aria-hidden="true" tabindex="-1"></a>The following ordered list will be preceded by roman numerals:</span>
-<span id="cb473-9"><a href="#cb473-9" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb473-10"><a href="#cb473-10" aria-hidden="true" tabindex="-1"></a>3. tres</span>
-<span id="cb473-11"><a href="#cb473-11" aria-hidden="true" tabindex="-1"></a>4. quattuor</span>
-<span id="cb473-12"><a href="#cb473-12" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb473-13"><a href="#cb473-13" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb476"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb476-1"><a href="#cb476-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb476-2"><a href="#cb476-2" aria-hidden="true" tabindex="-1"></a> import = {</span>
+<span id="cb476-3"><a href="#cb476-3" aria-hidden="true" tabindex="-1"></a> jdoe/lists = romanNumerals,</span>
+<span id="cb476-4"><a href="#cb476-4" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb476-5"><a href="#cb476-5" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb476-6"><a href="#cb476-6" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}[snippet=romanNumerals]</span>
+<span id="cb476-7"><a href="#cb476-7" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb476-8"><a href="#cb476-8" aria-hidden="true" tabindex="-1"></a>The following ordered list will be preceded by roman numerals:</span>
+<span id="cb476-9"><a href="#cb476-9" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb476-10"><a href="#cb476-10" aria-hidden="true" tabindex="-1"></a>3. tres</span>
+<span id="cb476-11"><a href="#cb476-11" aria-hidden="true" tabindex="-1"></a>4. quattuor</span>
+<span id="cb476-12"><a href="#cb476-12" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb476-13"><a href="#cb476-13" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span></code></pre></div>
<p>Furthermore, we can also specify the name of the snippet in the
current namespace, which can be different from the name of the snippet
in the <code>jdoe/lists</code> theme. For example, we can make the
snippet <code>jdoe/lists/romanNumerals</code> available under the name
<code>roman</code>.</p>
-<div class="sourceCode" id="cb474"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb474-1"><a href="#cb474-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb474-2"><a href="#cb474-2" aria-hidden="true" tabindex="-1"></a> import = {</span>
-<span id="cb474-3"><a href="#cb474-3" aria-hidden="true" tabindex="-1"></a> jdoe/lists = romanNumerals as roman,</span>
-<span id="cb474-4"><a href="#cb474-4" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb474-5"><a href="#cb474-5" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb474-6"><a href="#cb474-6" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}[snippet=roman]</span>
-<span id="cb474-7"><a href="#cb474-7" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb474-8"><a href="#cb474-8" aria-hidden="true" tabindex="-1"></a>The following ordered list will be preceded by roman numerals:</span>
-<span id="cb474-9"><a href="#cb474-9" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb474-10"><a href="#cb474-10" aria-hidden="true" tabindex="-1"></a>3. tres</span>
-<span id="cb474-11"><a href="#cb474-11" aria-hidden="true" tabindex="-1"></a>4. quattuor</span>
-<span id="cb474-12"><a href="#cb474-12" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb474-13"><a href="#cb474-13" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb477"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb477-1"><a href="#cb477-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb477-2"><a href="#cb477-2" aria-hidden="true" tabindex="-1"></a> import = {</span>
+<span id="cb477-3"><a href="#cb477-3" aria-hidden="true" tabindex="-1"></a> jdoe/lists = romanNumerals as roman,</span>
+<span id="cb477-4"><a href="#cb477-4" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb477-5"><a href="#cb477-5" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb477-6"><a href="#cb477-6" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}[snippet=roman]</span>
+<span id="cb477-7"><a href="#cb477-7" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb477-8"><a href="#cb477-8" aria-hidden="true" tabindex="-1"></a>The following ordered list will be preceded by roman numerals:</span>
+<span id="cb477-9"><a href="#cb477-9" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb477-10"><a href="#cb477-10" aria-hidden="true" tabindex="-1"></a>3. tres</span>
+<span id="cb477-11"><a href="#cb477-11" aria-hidden="true" tabindex="-1"></a>4. quattuor</span>
+<span id="cb477-12"><a href="#cb477-12" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb477-13"><a href="#cb477-13" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span></code></pre></div>
<p>Several themes and/or snippets can be loaded at once using the
extended variant of the <code>import</code> <span
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> option:</p>
-<div class="sourceCode" id="cb475"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb475-1"><a href="#cb475-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb475-2"><a href="#cb475-2" aria-hidden="true" tabindex="-1"></a> import = {</span>
-<span id="cb475-3"><a href="#cb475-3" aria-hidden="true" tabindex="-1"></a> jdoe/longpackagename/lists = {</span>
-<span id="cb475-4"><a href="#cb475-4" aria-hidden="true" tabindex="-1"></a> arabic as arabic1,</span>
-<span id="cb475-5"><a href="#cb475-5" aria-hidden="true" tabindex="-1"></a> roman,</span>
-<span id="cb475-6"><a href="#cb475-6" aria-hidden="true" tabindex="-1"></a> alphabetic,</span>
-<span id="cb475-7"><a href="#cb475-7" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb475-8"><a href="#cb475-8" aria-hidden="true" tabindex="-1"></a> jdoe/anotherlongpackagename/lists = {</span>
-<span id="cb475-9"><a href="#cb475-9" aria-hidden="true" tabindex="-1"></a> arabic as arabic2,</span>
-<span id="cb475-10"><a href="#cb475-10" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb475-11"><a href="#cb475-11" aria-hidden="true" tabindex="-1"></a> jdoe/yetanotherlongpackagename,</span>
-<span id="cb475-12"><a href="#cb475-12" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb475-13"><a href="#cb475-13" aria-hidden="true" tabindex="-1"></a>}</span></code></pre></div>
+<div class="sourceCode" id="cb478"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb478-1"><a href="#cb478-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb478-2"><a href="#cb478-2" aria-hidden="true" tabindex="-1"></a> import = {</span>
+<span id="cb478-3"><a href="#cb478-3" aria-hidden="true" tabindex="-1"></a> jdoe/longpackagename/lists = {</span>
+<span id="cb478-4"><a href="#cb478-4" aria-hidden="true" tabindex="-1"></a> arabic as arabic1,</span>
+<span id="cb478-5"><a href="#cb478-5" aria-hidden="true" tabindex="-1"></a> roman,</span>
+<span id="cb478-6"><a href="#cb478-6" aria-hidden="true" tabindex="-1"></a> alphabetic,</span>
+<span id="cb478-7"><a href="#cb478-7" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb478-8"><a href="#cb478-8" aria-hidden="true" tabindex="-1"></a> jdoe/anotherlongpackagename/lists = {</span>
+<span id="cb478-9"><a href="#cb478-9" aria-hidden="true" tabindex="-1"></a> arabic as arabic2,</span>
+<span id="cb478-10"><a href="#cb478-10" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb478-11"><a href="#cb478-11" aria-hidden="true" tabindex="-1"></a> jdoe/yetanotherlongpackagename,</span>
+<span id="cb478-12"><a href="#cb478-12" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb478-13"><a href="#cb478-13" aria-hidden="true" tabindex="-1"></a>}</span></code></pre></div>
<h3 data-number="2.2.5" id="latex-1"><span
class="header-section-number">2.2.5</span> <span
class="latex">L<sup>a</sup>T<sub>e</sub>X</span></h3>
@@ -8276,13 +8369,13 @@ class="tex">T<sub>e</sub>X</span> options from <span
class="latex">L<sup>a</sup>T<sub>e</sub>X</span></h4>
<p>As a rule of thumb, we can set all Lua options directly from <span
class="latex">L<sup>a</sup>T<sub>e</sub>X</span>. For example, to set
-the <strong><code>taskLists</code></strong> Lua option to
+the <code><strong>taskLists</strong></code> Lua option to
<code>true</code>, we would include the following code in our <span
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> document:</p>
-<div class="sourceCode" id="cb476"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb476-1"><a href="#cb476-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb476-2"><a href="#cb476-2" aria-hidden="true" tabindex="-1"></a> taskLists = true,</span>
-<span id="cb476-3"><a href="#cb476-3" aria-hidden="true" tabindex="-1"></a>}</span></code></pre></div>
+<div class="sourceCode" id="cb479"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb479-1"><a href="#cb479-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb479-2"><a href="#cb479-2" aria-hidden="true" tabindex="-1"></a> taskLists = true,</span>
+<span id="cb479-3"><a href="#cb479-3" aria-hidden="true" tabindex="-1"></a>}</span></code></pre></div>
<p>We can also set all plain <span class="tex">T<sub>e</sub>X</span>
options directly from <span
class="latex">L<sup>a</sup>T<sub>e</sub>X</span>. For example, to set
@@ -8290,10 +8383,10 @@ the <code>\markdownOptionInputTempFileName</code> plain <span
class="tex">T<sub>e</sub>X</span> option to
<code>helper-script.lua</code>, we would include the following code in
our <span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> document:</p>
-<div class="sourceCode" id="cb477"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb477-1"><a href="#cb477-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb477-2"><a href="#cb477-2" aria-hidden="true" tabindex="-1"></a> inputTempFileName = temporary-input.md,</span>
-<span id="cb477-3"><a href="#cb477-3" aria-hidden="true" tabindex="-1"></a>}</span></code></pre></div>
+<div class="sourceCode" id="cb480"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb480-1"><a href="#cb480-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb480-2"><a href="#cb480-2" aria-hidden="true" tabindex="-1"></a> inputTempFileName = temporary-input.md,</span>
+<span id="cb480-3"><a href="#cb480-3" aria-hidden="true" tabindex="-1"></a>}</span></code></pre></div>
<h3 data-number="2.2.6" id="latexthemes"><span
class="header-section-number">2.2.6</span> Themes</h3>
<p>In <span class="latex">L<sup>a</sup>T<sub>e</sub>X</span>, we expand
@@ -8318,15 +8411,15 @@ where different code is needed for different <span
class="tex">T<sub>e</sub>X</span> formats. To enable code reuse,
developers can load the <code>.tex</code> theme file from the
<code>.sty</code> theme file using the
-<code>\markdownLoadPlainTeXTheme</code> macro.</p>
+<code>markdownLoadPlainTeXTheme</code> macro.</p>
<p>For example, to load themes named <code>witiko/beamer/MU</code> and
<code>witiko/dot</code>, you would use the following code in the
preamble of your document:</p>
-<div class="sourceCode" id="cb478"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb478-1"><a href="#cb478-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[</span>
-<span id="cb478-2"><a href="#cb478-2" aria-hidden="true" tabindex="-1"></a> import=witiko/beamer/MU,</span>
-<span id="cb478-3"><a href="#cb478-3" aria-hidden="true" tabindex="-1"></a> import=witiko/dot,</span>
-<span id="cb478-4"><a href="#cb478-4" aria-hidden="true" tabindex="-1"></a>]{<span class="ex">markdown</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb481"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb481-1"><a href="#cb481-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[</span>
+<span id="cb481-2"><a href="#cb481-2" aria-hidden="true" tabindex="-1"></a> import=witiko/beamer/MU,</span>
+<span id="cb481-3"><a href="#cb481-3" aria-hidden="true" tabindex="-1"></a> import=witiko/dot,</span>
+<span id="cb481-4"><a href="#cb481-4" aria-hidden="true" tabindex="-1"></a>]{<span class="ex">markdown</span>}</span></code></pre></div>
<p>Due to limitations of <span
class="latex">L<sup>a</sup>T<sub>e</sub>X</span>, themes may not be
loaded after the beginning of a <span
@@ -8334,14 +8427,14 @@ class="latex">L<sup>a</sup>T<sub>e</sub>X</span> document.</p>
<p>Built-in <span class="latex">L<sup>a</sup>T<sub>e</sub>X</span>
themes provided with the Markdown package include:</p>
<dl>
-<dt><strong><code>witiko/dot</code></strong></dt>
+<dt><code><strong>witiko/dot</strong></code></dt>
<dd>
<p>A theme that typesets fenced code blocks with the <code>dot …</code>
infostring as images of directed graphs rendered by the Graphviz tools.
The right tail of the infostring is used as the image title. The theme
requires a Unix-like operating system with GNU Diffutils and Graphviz
installed. The theme also requires shell access unless the
-<strong><code>frozenCache</code></strong> plain <span
+<code><strong>frozenCache</strong></code> plain <span
class="tex">T<sub>e</sub>X</span> option is enabled.</p>
</dd>
</dl>
@@ -8349,44 +8442,44 @@ class="tex">T<sub>e</sub>X</span> option is enabled.</p>
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb479"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb479-1"><a href="#cb479-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb479-2"><a href="#cb479-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[import=witiko/dot]{<span class="ex">markdown</span>}</span>
-<span id="cb479-3"><a href="#cb479-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\setkeys</span>{Gin}{</span>
-<span id="cb479-4"><a href="#cb479-4" aria-hidden="true" tabindex="-1"></a> width=<span class="fu">\columnwidth</span>,</span>
-<span id="cb479-5"><a href="#cb479-5" aria-hidden="true" tabindex="-1"></a> height=0.65<span class="fu">\paperheight</span>,</span>
-<span id="cb479-6"><a href="#cb479-6" aria-hidden="true" tabindex="-1"></a> keepaspectratio}</span>
-<span id="cb479-7"><a href="#cb479-7" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb479-8"><a href="#cb479-8" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb479-9"><a href="#cb479-9" aria-hidden="true" tabindex="-1"></a>``` dot Various formats of mathemathical formulae</span>
-<span id="cb479-10"><a href="#cb479-10" aria-hidden="true" tabindex="-1"></a>digraph tree {</span>
-<span id="cb479-11"><a href="#cb479-11" aria-hidden="true" tabindex="-1"></a> margin = 0;</span>
-<span id="cb479-12"><a href="#cb479-12" aria-hidden="true" tabindex="-1"></a> rankdir = &quot;LR&quot;;</span>
-<span id="cb479-13"><a href="#cb479-13" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb479-14"><a href="#cb479-14" aria-hidden="true" tabindex="-1"></a> latex -&gt; pmml;</span>
-<span id="cb479-15"><a href="#cb479-15" aria-hidden="true" tabindex="-1"></a> latex -&gt; cmml;</span>
-<span id="cb479-16"><a href="#cb479-16" aria-hidden="true" tabindex="-1"></a> pmml -&gt; slt;</span>
-<span id="cb479-17"><a href="#cb479-17" aria-hidden="true" tabindex="-1"></a> cmml -&gt; opt;</span>
-<span id="cb479-18"><a href="#cb479-18" aria-hidden="true" tabindex="-1"></a> cmml -&gt; prefix;</span>
-<span id="cb479-19"><a href="#cb479-19" aria-hidden="true" tabindex="-1"></a> cmml -&gt; infix;</span>
-<span id="cb479-20"><a href="#cb479-20" aria-hidden="true" tabindex="-1"></a> pmml -&gt; mterms [style=dashed];</span>
-<span id="cb479-21"><a href="#cb479-21" aria-hidden="true" tabindex="-1"></a> cmml -&gt; mterms;</span>
-<span id="cb479-22"><a href="#cb479-22" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb479-23"><a href="#cb479-23" aria-hidden="true" tabindex="-1"></a> latex [label = &quot;LaTeX&quot;];</span>
-<span id="cb479-24"><a href="#cb479-24" aria-hidden="true" tabindex="-1"></a> pmml [label = &quot;Presentation MathML&quot;];</span>
-<span id="cb479-25"><a href="#cb479-25" aria-hidden="true" tabindex="-1"></a> cmml [label = &quot;Content MathML&quot;];</span>
-<span id="cb479-26"><a href="#cb479-26" aria-hidden="true" tabindex="-1"></a> slt [label = &quot;Symbol Layout Tree&quot;];</span>
-<span id="cb479-27"><a href="#cb479-27" aria-hidden="true" tabindex="-1"></a> opt [label = &quot;Operator Tree&quot;];</span>
-<span id="cb479-28"><a href="#cb479-28" aria-hidden="true" tabindex="-1"></a> prefix [label = &quot;Prefix&quot;];</span>
-<span id="cb479-29"><a href="#cb479-29" aria-hidden="true" tabindex="-1"></a> infix [label = &quot;Infix&quot;];</span>
-<span id="cb479-30"><a href="#cb479-30" aria-hidden="true" tabindex="-1"></a> mterms [label = &quot;M-Terms&quot;];</span>
-<span id="cb479-31"><a href="#cb479-31" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb479-32"><a href="#cb479-32" aria-hidden="true" tabindex="-1"></a>```</span>
-<span id="cb479-33"><a href="#cb479-33" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb479-34"><a href="#cb479-34" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb482"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb482-1"><a href="#cb482-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb482-2"><a href="#cb482-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[import=witiko/dot]{<span class="ex">markdown</span>}</span>
+<span id="cb482-3"><a href="#cb482-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\setkeys</span>{Gin}{</span>
+<span id="cb482-4"><a href="#cb482-4" aria-hidden="true" tabindex="-1"></a> width=<span class="fu">\columnwidth</span>,</span>
+<span id="cb482-5"><a href="#cb482-5" aria-hidden="true" tabindex="-1"></a> height=0.65<span class="fu">\paperheight</span>,</span>
+<span id="cb482-6"><a href="#cb482-6" aria-hidden="true" tabindex="-1"></a> keepaspectratio}</span>
+<span id="cb482-7"><a href="#cb482-7" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb482-8"><a href="#cb482-8" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb482-9"><a href="#cb482-9" aria-hidden="true" tabindex="-1"></a>``` dot Various formats of mathemathical formulae</span>
+<span id="cb482-10"><a href="#cb482-10" aria-hidden="true" tabindex="-1"></a>digraph tree {</span>
+<span id="cb482-11"><a href="#cb482-11" aria-hidden="true" tabindex="-1"></a> margin = 0;</span>
+<span id="cb482-12"><a href="#cb482-12" aria-hidden="true" tabindex="-1"></a> rankdir = &quot;LR&quot;;</span>
+<span id="cb482-13"><a href="#cb482-13" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb482-14"><a href="#cb482-14" aria-hidden="true" tabindex="-1"></a> latex -&gt; pmml;</span>
+<span id="cb482-15"><a href="#cb482-15" aria-hidden="true" tabindex="-1"></a> latex -&gt; cmml;</span>
+<span id="cb482-16"><a href="#cb482-16" aria-hidden="true" tabindex="-1"></a> pmml -&gt; slt;</span>
+<span id="cb482-17"><a href="#cb482-17" aria-hidden="true" tabindex="-1"></a> cmml -&gt; opt;</span>
+<span id="cb482-18"><a href="#cb482-18" aria-hidden="true" tabindex="-1"></a> cmml -&gt; prefix;</span>
+<span id="cb482-19"><a href="#cb482-19" aria-hidden="true" tabindex="-1"></a> cmml -&gt; infix;</span>
+<span id="cb482-20"><a href="#cb482-20" aria-hidden="true" tabindex="-1"></a> pmml -&gt; mterms [style=dashed];</span>
+<span id="cb482-21"><a href="#cb482-21" aria-hidden="true" tabindex="-1"></a> cmml -&gt; mterms;</span>
+<span id="cb482-22"><a href="#cb482-22" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb482-23"><a href="#cb482-23" aria-hidden="true" tabindex="-1"></a> latex [label = &quot;LaTeX&quot;];</span>
+<span id="cb482-24"><a href="#cb482-24" aria-hidden="true" tabindex="-1"></a> pmml [label = &quot;Presentation MathML&quot;];</span>
+<span id="cb482-25"><a href="#cb482-25" aria-hidden="true" tabindex="-1"></a> cmml [label = &quot;Content MathML&quot;];</span>
+<span id="cb482-26"><a href="#cb482-26" aria-hidden="true" tabindex="-1"></a> slt [label = &quot;Symbol Layout Tree&quot;];</span>
+<span id="cb482-27"><a href="#cb482-27" aria-hidden="true" tabindex="-1"></a> opt [label = &quot;Operator Tree&quot;];</span>
+<span id="cb482-28"><a href="#cb482-28" aria-hidden="true" tabindex="-1"></a> prefix [label = &quot;Prefix&quot;];</span>
+<span id="cb482-29"><a href="#cb482-29" aria-hidden="true" tabindex="-1"></a> infix [label = &quot;Infix&quot;];</span>
+<span id="cb482-30"><a href="#cb482-30" aria-hidden="true" tabindex="-1"></a> mterms [label = &quot;M-Terms&quot;];</span>
+<span id="cb482-31"><a href="#cb482-31" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb482-32"><a href="#cb482-32" aria-hidden="true" tabindex="-1"></a>```</span>
+<span id="cb482-33"><a href="#cb482-33" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb482-34"><a href="#cb482-34" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb480"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb480-1"><a href="#cb480-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb483"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb483-1"><a href="#cb483-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain a drawing of a directed graph similar to Figure 1 from the
following conference article:</p>
@@ -8400,15 +8493,15 @@ href="http://ceur-ws.org/Vol-2696/paper_235.pdf"
class="uri">http://ceur-ws.org/Vol-2696/paper_235.pdf</a></p>
</blockquote>
<dl>
-<dt><strong><code>witiko/graphicx/http</code></strong></dt>
+<dt><code><strong>witiko/graphicx/http</strong></code></dt>
<dd>
<p>A theme that adds support for downloading images whose URL has the
http or https protocol. The theme requires the
-<strong><code>catchfile</code></strong> <span
+<code><strong>catchfile</strong></code> <span
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> package and a Unix-like
operating system with GNU Coreutils <code>md5sum</code> and either GNU
Wget or cURL installed. The theme also requires shell access unless the
-<strong><code>frozenCache</code></strong> plain <span
+<code><strong>frozenCache</strong></code> plain <span
class="tex">T<sub>e</sub>X</span> option is enabled.</p>
</dd>
</dl>
@@ -8416,18 +8509,18 @@ class="tex">T<sub>e</sub>X</span> option is enabled.</p>
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb481"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb481-1"><a href="#cb481-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb481-2"><a href="#cb481-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[import=witiko/graphicx/http]{<span class="ex">markdown</span>}</span>
-<span id="cb481-3"><a href="#cb481-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb481-4"><a href="#cb481-4" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb481-5"><a href="#cb481-5" aria-hidden="true" tabindex="-1"></a>![img](https://github.com/witiko/markdown/raw/main/markdown.png</span>
-<span id="cb481-6"><a href="#cb481-6" aria-hidden="true" tabindex="-1"></a> &quot;The banner of the Markdown package&quot;)</span>
-<span id="cb481-7"><a href="#cb481-7" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb481-8"><a href="#cb481-8" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb484"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb484-1"><a href="#cb484-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb484-2"><a href="#cb484-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[import=witiko/graphicx/http]{<span class="ex">markdown</span>}</span>
+<span id="cb484-3"><a href="#cb484-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb484-4"><a href="#cb484-4" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb484-5"><a href="#cb484-5" aria-hidden="true" tabindex="-1"></a>![img](https://github.com/witiko/markdown/raw/main/markdown.png</span>
+<span id="cb484-6"><a href="#cb484-6" aria-hidden="true" tabindex="-1"></a> &quot;The banner of the Markdown package&quot;)</span>
+<span id="cb484-7"><a href="#cb484-7" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb484-8"><a href="#cb484-8" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb482"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb482-1"><a href="#cb482-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb485"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb485-1"><a href="#cb485-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following image:</p>
<blockquote>
@@ -8438,7 +8531,7 @@ title="The banner of the Markdown package" alt="img" />
</figure>
</blockquote>
<dl>
-<dt><strong><code>witiko/markdown/defaults</code></strong></dt>
+<dt><code><strong>witiko/markdown/defaults</strong></code></dt>
<dd>
<p>A <span class="latex">L<sup>a</sup>T<sub>e</sub>X</span> theme with
the default definitions of token renderer prototypes for plain <span
@@ -8471,16 +8564,16 @@ where different code is needed for different <span
class="tex">T<sub>e</sub>X</span> formats. To enable code reuse,
developers can load the <code>.tex</code> theme file from the
<code>t-*.tex</code> theme file using the
-<code>\markdownLoadPlainTeXTheme</code> macro.</p>
+<code>markdownLoadPlainTeXTheme</code> macro.</p>
<p>For example, to load a theme named <code>witiko/tilde</code> in your
document:</p>
-<div class="sourceCode" id="cb483"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb483-1"><a href="#cb483-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
-<span id="cb483-2"><a href="#cb483-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[import=witiko/tilde]</span></code></pre></div>
+<div class="sourceCode" id="cb486"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb486-1"><a href="#cb486-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
+<span id="cb486-2"><a href="#cb486-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[import=witiko/tilde]</span></code></pre></div>
<p>Built-in Con<span class="tex">T<sub>e</sub>X</span>t themes provided
with the Markdown package include:</p>
<dl>
-<dt><strong><code>witiko/markdown/defaults</code></strong></dt>
+<dt><code><strong>witiko/markdown/defaults</strong></code></dt>
<dd>
<p>A Con<span class="tex">T<sub>e</sub>X</span>t theme with the default
definitions of token renderer prototypes for plain <span
@@ -8507,26 +8600,26 @@ class="header-section-number">2.3.1.1</span> Attribute Renderers</h4>
following options for markdown attributes on different elements is
enabled:</p>
<ul>
-<li><strong><code>autoIdentifiers</code></strong></li>
-<li><strong><code>fencedCodeAttributes</code></strong></li>
-<li><strong><code>gfmAutoIdentifiers</code></strong></li>
-<li><strong><code>headerAttributes</code></strong></li>
-<li><strong><code>inlineCodeAttributes</code></strong></li>
-<li><strong><code>linkAttributes</code></strong></li>
+<li><code><strong>autoIdentifiers</strong></code></li>
+<li><code><strong>fencedCodeAttributes</strong></code></li>
+<li><code><strong>gfmAutoIdentifiers</strong></code></li>
+<li><code><strong>headerAttributes</strong></code></li>
+<li><code><strong>inlineCodeAttributes</strong></code></li>
+<li><code><strong>linkAttributes</strong></code></li>
</ul>
-<p><code>\markdownRendererAttributeIdentifier</code> represents the
+<p><code>markdownRendererAttributeIdentifier</code> represents the
⟨<em>identifier</em>⟩ of a markdown element
(<code>id="</code>⟨<em>identifier</em>⟩<code>"</code> in HTML and
<code>#</code>⟨<em>identifier</em>⟩ in markdown attributes). The macro
receives a single attribute that corresponds to the
⟨<em>identifier</em>⟩.</p>
-<p><code>\markdownRendererAttributeClassName</code> represents the
+<p><code>markdownRendererAttributeClassName</code> represents the
⟨<em>class name</em>⟩ of a markdown element
(<code>class="</code>⟨<em>class name</em>⟩ …<code>"</code> in HTML and
<code>.</code>⟨<em>class name</em>⟩ in markdown attributes). The macro
receives a single attribute that corresponds to the ⟨<em>class
name</em>⟩.</p>
-<p><code>\markdownRendererAttributeKeyValue</code> represents a HTML
+<p><code>markdownRendererAttributeKeyValue</code> represents a HTML
attribute in the form ⟨<em>key</em>⟩<code>=</code>⟨<em>value</em>⟩ that
is neither an identifier nor a class name. The macro receives two
attributes that correspond to the ⟨<em>key</em>⟩ and the
@@ -8535,42 +8628,42 @@ attributes that correspond to the ⟨<em>key</em>⟩ and the
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb484"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb484-1"><a href="#cb484-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb484-2"><a href="#cb484-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[headerAttributes, underscores=false]{<span class="ex">markdown</span>}</span>
-<span id="cb484-3"><a href="#cb484-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb484-4"><a href="#cb484-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb484-5"><a href="#cb484-5" aria-hidden="true" tabindex="-1"></a> attributeIdentifier = {<span class="co">%</span></span>
-<span id="cb484-6"><a href="#cb484-6" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
-<span id="cb484-7"><a href="#cb484-7" aria-hidden="true" tabindex="-1"></a> <span class="fu">\emph</span>{(Identifier: #1)}</span>
-<span id="cb484-8"><a href="#cb484-8" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
-<span id="cb484-9"><a href="#cb484-9" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb484-10"><a href="#cb484-10" aria-hidden="true" tabindex="-1"></a> attributeClassName = {<span class="co">%</span></span>
-<span id="cb484-11"><a href="#cb484-11" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
-<span id="cb484-12"><a href="#cb484-12" aria-hidden="true" tabindex="-1"></a> <span class="fu">\emph</span>{(Class name: #1)}</span>
-<span id="cb484-13"><a href="#cb484-13" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
-<span id="cb484-14"><a href="#cb484-14" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb484-15"><a href="#cb484-15" aria-hidden="true" tabindex="-1"></a> attributeKeyValue = {<span class="co">%</span></span>
-<span id="cb484-16"><a href="#cb484-16" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
-<span id="cb484-17"><a href="#cb484-17" aria-hidden="true" tabindex="-1"></a> <span class="fu">\emph</span>{(Key: #1, Value: #2)}</span>
-<span id="cb484-18"><a href="#cb484-18" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
-<span id="cb484-19"><a href="#cb484-19" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb484-20"><a href="#cb484-20" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb484-21"><a href="#cb484-21" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb484-22"><a href="#cb484-22" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb484-23"><a href="#cb484-23" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb484-24"><a href="#cb484-24" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb484-25"><a href="#cb484-25" aria-hidden="true" tabindex="-1"></a># First top-level heading {jane=doe}</span>
-<span id="cb484-26"><a href="#cb484-26" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb484-27"><a href="#cb484-27" aria-hidden="true" tabindex="-1"></a>## A subheading {#identifier}</span>
-<span id="cb484-28"><a href="#cb484-28" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb484-29"><a href="#cb484-29" aria-hidden="true" tabindex="-1"></a># Second top-level heading {.class_name}</span>
-<span id="cb484-30"><a href="#cb484-30" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb484-31"><a href="#cb484-31" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb484-32"><a href="#cb484-32" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb487"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb487-1"><a href="#cb487-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb487-2"><a href="#cb487-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[headerAttributes, underscores=false]{<span class="ex">markdown</span>}</span>
+<span id="cb487-3"><a href="#cb487-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb487-4"><a href="#cb487-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb487-5"><a href="#cb487-5" aria-hidden="true" tabindex="-1"></a> attributeIdentifier = {<span class="co">%</span></span>
+<span id="cb487-6"><a href="#cb487-6" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
+<span id="cb487-7"><a href="#cb487-7" aria-hidden="true" tabindex="-1"></a> <span class="fu">\emph</span>{(Identifier: #1)}</span>
+<span id="cb487-8"><a href="#cb487-8" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
+<span id="cb487-9"><a href="#cb487-9" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb487-10"><a href="#cb487-10" aria-hidden="true" tabindex="-1"></a> attributeClassName = {<span class="co">%</span></span>
+<span id="cb487-11"><a href="#cb487-11" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
+<span id="cb487-12"><a href="#cb487-12" aria-hidden="true" tabindex="-1"></a> <span class="fu">\emph</span>{(Class name: #1)}</span>
+<span id="cb487-13"><a href="#cb487-13" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
+<span id="cb487-14"><a href="#cb487-14" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb487-15"><a href="#cb487-15" aria-hidden="true" tabindex="-1"></a> attributeKeyValue = {<span class="co">%</span></span>
+<span id="cb487-16"><a href="#cb487-16" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
+<span id="cb487-17"><a href="#cb487-17" aria-hidden="true" tabindex="-1"></a> <span class="fu">\emph</span>{(Key: #1, Value: #2)}</span>
+<span id="cb487-18"><a href="#cb487-18" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
+<span id="cb487-19"><a href="#cb487-19" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb487-20"><a href="#cb487-20" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb487-21"><a href="#cb487-21" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb487-22"><a href="#cb487-22" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb487-23"><a href="#cb487-23" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb487-24"><a href="#cb487-24" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb487-25"><a href="#cb487-25" aria-hidden="true" tabindex="-1"></a># First top-level heading {jane=doe}</span>
+<span id="cb487-26"><a href="#cb487-26" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb487-27"><a href="#cb487-27" aria-hidden="true" tabindex="-1"></a>## A subheading {#identifier}</span>
+<span id="cb487-28"><a href="#cb487-28" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb487-29"><a href="#cb487-29" aria-hidden="true" tabindex="-1"></a># Second top-level heading {.class_name}</span>
+<span id="cb487-30"><a href="#cb487-30" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb487-31"><a href="#cb487-31" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb487-32"><a href="#cb487-32" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb485"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb485-1"><a href="#cb485-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb488"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb488-1"><a href="#cb488-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -8583,39 +8676,39 @@ contain the following text:</p>
</blockquote>
<h4 data-number="2.3.1.2" id="block-quote-renderers"><span
class="header-section-number">2.3.1.2</span> Block Quote Renderers</h4>
-<p>The <code>\markdownRendererBlockQuoteBegin</code> macro represents
-the beginning of a block quote. The macro receives no arguments.</p>
-<p>The <code>\markdownRendererBlockQuoteEnd</code> macro represents the
+<p>The <code>markdownRendererBlockQuoteBegin</code> macro represents the
+beginning of a block quote. The macro receives no arguments.</p>
+<p>The <code>markdownRendererBlockQuoteEnd</code> macro represents the
end of a block quote. The macro receives no arguments.</p>
<h5 class="unnumbered" id="plain-tex-example-25">Plain <span
class="tex">T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb486"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb486-1"><a href="#cb486-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
-<span id="cb486-2"><a href="#cb486-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererBlockQuoteBegin</span>{<span class="co">%</span></span>
-<span id="cb486-3"><a href="#cb486-3" aria-hidden="true" tabindex="-1"></a> <span class="fu">\begingroup</span></span>
-<span id="cb486-4"><a href="#cb486-4" aria-hidden="true" tabindex="-1"></a> <span class="fu">\vskip\parindent</span></span>
-<span id="cb486-5"><a href="#cb486-5" aria-hidden="true" tabindex="-1"></a> <span class="fu">\leftskip</span>=2<span class="fu">\parindent</span></span>
-<span id="cb486-6"><a href="#cb486-6" aria-hidden="true" tabindex="-1"></a> <span class="fu">\parindent</span>=0pt</span>
-<span id="cb486-7"><a href="#cb486-7" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb486-8"><a href="#cb486-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererBlockQuoteEnd</span>{<span class="co">%</span></span>
-<span id="cb486-9"><a href="#cb486-9" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
-<span id="cb486-10"><a href="#cb486-10" aria-hidden="true" tabindex="-1"></a> <span class="fu">\vskip\parindent</span></span>
-<span id="cb486-11"><a href="#cb486-11" aria-hidden="true" tabindex="-1"></a> <span class="fu">\endgroup</span></span>
-<span id="cb486-12"><a href="#cb486-12" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb486-13"><a href="#cb486-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
-<span id="cb486-14"><a href="#cb486-14" aria-hidden="true" tabindex="-1"></a>A quote from William Shakespeare&#39;s King Lear:</span>
-<span id="cb486-15"><a href="#cb486-15" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb486-16"><a href="#cb486-16" aria-hidden="true" tabindex="-1"></a>&gt; This is the excellent foppery of the world that when we are</span>
-<span id="cb486-17"><a href="#cb486-17" aria-hidden="true" tabindex="-1"></a>&gt; sick in fortune---often the surfeit of our own behavior---we</span>
-<span id="cb486-18"><a href="#cb486-18" aria-hidden="true" tabindex="-1"></a>&gt; make guilty of our disasters the sun, the moon, and the</span>
-<span id="cb486-19"><a href="#cb486-19" aria-hidden="true" tabindex="-1"></a>&gt; stars [...]</span>
-<span id="cb486-20"><a href="#cb486-20" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
-<span id="cb486-21"><a href="#cb486-21" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb489"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb489-1"><a href="#cb489-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
+<span id="cb489-2"><a href="#cb489-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererBlockQuoteBegin</span>{<span class="co">%</span></span>
+<span id="cb489-3"><a href="#cb489-3" aria-hidden="true" tabindex="-1"></a> <span class="fu">\begingroup</span></span>
+<span id="cb489-4"><a href="#cb489-4" aria-hidden="true" tabindex="-1"></a> <span class="fu">\vskip\parindent</span></span>
+<span id="cb489-5"><a href="#cb489-5" aria-hidden="true" tabindex="-1"></a> <span class="fu">\leftskip</span>=2<span class="fu">\parindent</span></span>
+<span id="cb489-6"><a href="#cb489-6" aria-hidden="true" tabindex="-1"></a> <span class="fu">\parindent</span>=0pt</span>
+<span id="cb489-7"><a href="#cb489-7" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb489-8"><a href="#cb489-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererBlockQuoteEnd</span>{<span class="co">%</span></span>
+<span id="cb489-9"><a href="#cb489-9" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
+<span id="cb489-10"><a href="#cb489-10" aria-hidden="true" tabindex="-1"></a> <span class="fu">\vskip\parindent</span></span>
+<span id="cb489-11"><a href="#cb489-11" aria-hidden="true" tabindex="-1"></a> <span class="fu">\endgroup</span></span>
+<span id="cb489-12"><a href="#cb489-12" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb489-13"><a href="#cb489-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
+<span id="cb489-14"><a href="#cb489-14" aria-hidden="true" tabindex="-1"></a>A quote from William Shakespeare&#39;s King Lear:</span>
+<span id="cb489-15"><a href="#cb489-15" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb489-16"><a href="#cb489-16" aria-hidden="true" tabindex="-1"></a>&gt; This is the excellent foppery of the world that when we are</span>
+<span id="cb489-17"><a href="#cb489-17" aria-hidden="true" tabindex="-1"></a>&gt; sick in fortune---often the surfeit of our own behavior---we</span>
+<span id="cb489-18"><a href="#cb489-18" aria-hidden="true" tabindex="-1"></a>&gt; make guilty of our disasters the sun, the moon, and the</span>
+<span id="cb489-19"><a href="#cb489-19" aria-hidden="true" tabindex="-1"></a>&gt; stars [...]</span>
+<span id="cb489-20"><a href="#cb489-20" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
+<span id="cb489-21"><a href="#cb489-21" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb487"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb487-1"><a href="#cb487-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb490"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb490-1"><a href="#cb490-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -8630,28 +8723,28 @@ disasters the sun, the moon, and the stars […]</p>
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb488"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb488-1"><a href="#cb488-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb488-2"><a href="#cb488-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span>
-<span id="cb488-3"><a href="#cb488-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb488-4"><a href="#cb488-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb488-5"><a href="#cb488-5" aria-hidden="true" tabindex="-1"></a> blockQuoteBegin = {<span class="kw">\begin</span>{<span class="ex">quote</span>}},</span>
-<span id="cb488-6"><a href="#cb488-6" aria-hidden="true" tabindex="-1"></a> blockQuoteEnd = {<span class="kw">\end</span>{<span class="ex">quote</span>}},</span>
-<span id="cb488-7"><a href="#cb488-7" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb488-8"><a href="#cb488-8" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb488-9"><a href="#cb488-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb488-10"><a href="#cb488-10" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb488-11"><a href="#cb488-11" aria-hidden="true" tabindex="-1"></a>A quote from William Shakespeare&#39;s King Lear:</span>
-<span id="cb488-12"><a href="#cb488-12" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb488-13"><a href="#cb488-13" aria-hidden="true" tabindex="-1"></a>&gt; This is the excellent foppery of the world that when we are</span>
-<span id="cb488-14"><a href="#cb488-14" aria-hidden="true" tabindex="-1"></a>&gt; sick in fortune---often the surfeit of our own behavior---we</span>
-<span id="cb488-15"><a href="#cb488-15" aria-hidden="true" tabindex="-1"></a>&gt; make guilty of our disasters the sun, the moon, and the</span>
-<span id="cb488-16"><a href="#cb488-16" aria-hidden="true" tabindex="-1"></a>&gt; stars [...]</span>
-<span id="cb488-17"><a href="#cb488-17" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb488-18"><a href="#cb488-18" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb491"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb491-1"><a href="#cb491-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb491-2"><a href="#cb491-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span>
+<span id="cb491-3"><a href="#cb491-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb491-4"><a href="#cb491-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb491-5"><a href="#cb491-5" aria-hidden="true" tabindex="-1"></a> blockQuoteBegin = {<span class="kw">\begin</span>{<span class="ex">quote</span>}},</span>
+<span id="cb491-6"><a href="#cb491-6" aria-hidden="true" tabindex="-1"></a> blockQuoteEnd = {<span class="kw">\end</span>{<span class="ex">quote</span>}},</span>
+<span id="cb491-7"><a href="#cb491-7" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb491-8"><a href="#cb491-8" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb491-9"><a href="#cb491-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb491-10"><a href="#cb491-10" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb491-11"><a href="#cb491-11" aria-hidden="true" tabindex="-1"></a>A quote from William Shakespeare&#39;s King Lear:</span>
+<span id="cb491-12"><a href="#cb491-12" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb491-13"><a href="#cb491-13" aria-hidden="true" tabindex="-1"></a>&gt; This is the excellent foppery of the world that when we are</span>
+<span id="cb491-14"><a href="#cb491-14" aria-hidden="true" tabindex="-1"></a>&gt; sick in fortune---often the surfeit of our own behavior---we</span>
+<span id="cb491-15"><a href="#cb491-15" aria-hidden="true" tabindex="-1"></a>&gt; make guilty of our disasters the sun, the moon, and the</span>
+<span id="cb491-16"><a href="#cb491-16" aria-hidden="true" tabindex="-1"></a>&gt; stars [...]</span>
+<span id="cb491-17"><a href="#cb491-17" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb491-18"><a href="#cb491-18" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb489"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb489-1"><a href="#cb489-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb492"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb492-1"><a href="#cb492-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -8666,23 +8759,23 @@ disasters the sun, the moon, and the stars […]</p>
class="tex">T<sub>e</sub>X</span>t Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb490"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb490-1"><a href="#cb490-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
-<span id="cb490-2"><a href="#cb490-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererBlockQuoteBegin</span>{<span class="fu">\startquotation</span>}</span>
-<span id="cb490-3"><a href="#cb490-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererBlockQuoteEnd</span>{<span class="fu">\stopquotation</span>}</span>
-<span id="cb490-4"><a href="#cb490-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
-<span id="cb490-5"><a href="#cb490-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb490-6"><a href="#cb490-6" aria-hidden="true" tabindex="-1"></a>A quote from William Shakespeare&#39;s King Lear:</span>
-<span id="cb490-7"><a href="#cb490-7" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb490-8"><a href="#cb490-8" aria-hidden="true" tabindex="-1"></a>&gt; This is the excellent foppery of the world that when we are</span>
-<span id="cb490-9"><a href="#cb490-9" aria-hidden="true" tabindex="-1"></a>&gt; sick in fortune---often the surfeit of our own behavior---we</span>
-<span id="cb490-10"><a href="#cb490-10" aria-hidden="true" tabindex="-1"></a>&gt; make guilty of our disasters the sun, the moon, and the</span>
-<span id="cb490-11"><a href="#cb490-11" aria-hidden="true" tabindex="-1"></a>&gt; stars [...]</span>
-<span id="cb490-12"><a href="#cb490-12" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb490-13"><a href="#cb490-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
+<div class="sourceCode" id="cb493"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb493-1"><a href="#cb493-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
+<span id="cb493-2"><a href="#cb493-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererBlockQuoteBegin</span>{<span class="fu">\startquotation</span>}</span>
+<span id="cb493-3"><a href="#cb493-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererBlockQuoteEnd</span>{<span class="fu">\stopquotation</span>}</span>
+<span id="cb493-4"><a href="#cb493-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
+<span id="cb493-5"><a href="#cb493-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb493-6"><a href="#cb493-6" aria-hidden="true" tabindex="-1"></a>A quote from William Shakespeare&#39;s King Lear:</span>
+<span id="cb493-7"><a href="#cb493-7" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb493-8"><a href="#cb493-8" aria-hidden="true" tabindex="-1"></a>&gt; This is the excellent foppery of the world that when we are</span>
+<span id="cb493-9"><a href="#cb493-9" aria-hidden="true" tabindex="-1"></a>&gt; sick in fortune---often the surfeit of our own behavior---we</span>
+<span id="cb493-10"><a href="#cb493-10" aria-hidden="true" tabindex="-1"></a>&gt; make guilty of our disasters the sun, the moon, and the</span>
+<span id="cb493-11"><a href="#cb493-11" aria-hidden="true" tabindex="-1"></a>&gt; stars [...]</span>
+<span id="cb493-12"><a href="#cb493-12" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb493-13"><a href="#cb493-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb491"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb491-1"><a href="#cb491-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb494"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb494-1"><a href="#cb494-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -8698,35 +8791,34 @@ id="bracketed-spans-attribute-context-renderers"><span
class="header-section-number">2.3.1.3</span> Bracketed Spans Attribute
Context Renderers</h4>
<p>The following macros are only produced, when the
-<strong><code>bracketedSpans</code></strong> option is enabled.</p>
-<p>The <code>\markdownRendererBracketedSpanAttributeContextBegin</code>
-and <code>\markdownRendererBracketedSpanAttributeContextEnd</code>
-macros represent the beginning and the end of a context in which the
-attributes of an inline bracketed span apply. The macros receive no
-arguments.</p>
+<code><strong>bracketedSpans</strong></code> option is enabled.</p>
+<p>The <code>markdownRendererBracketedSpanAttributeContextBegin</code>
+and <code>markdownRendererBracketedSpanAttributeContextEnd</code> macros
+represent the beginning and the end of a context in which the attributes
+of an inline bracketed span apply. The macros receive no arguments.</p>
<h5 class="unnumbered" id="latex-example-58"><span
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb492"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb492-1"><a href="#cb492-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb492-2"><a href="#cb492-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[bracketedSpans]{<span class="ex">markdown</span>}</span>
-<span id="cb492-3"><a href="#cb492-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb492-4"><a href="#cb492-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb492-5"><a href="#cb492-5" aria-hidden="true" tabindex="-1"></a> bracketedSpanAttributeContextBegin = {(},</span>
-<span id="cb492-6"><a href="#cb492-6" aria-hidden="true" tabindex="-1"></a> bracketedSpanAttributeContextEnd = {)},</span>
-<span id="cb492-7"><a href="#cb492-7" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb492-8"><a href="#cb492-8" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb492-9"><a href="#cb492-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb492-10"><a href="#cb492-10" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb492-11"><a href="#cb492-11" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb492-12"><a href="#cb492-12" aria-hidden="true" tabindex="-1"></a>[foo [bar]{#identifier}]{key=value} [baz]{.class_name}</span>
-<span id="cb492-13"><a href="#cb492-13" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb492-14"><a href="#cb492-14" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb492-15"><a href="#cb492-15" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb495"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb495-1"><a href="#cb495-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb495-2"><a href="#cb495-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[bracketedSpans]{<span class="ex">markdown</span>}</span>
+<span id="cb495-3"><a href="#cb495-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb495-4"><a href="#cb495-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb495-5"><a href="#cb495-5" aria-hidden="true" tabindex="-1"></a> bracketedSpanAttributeContextBegin = {(},</span>
+<span id="cb495-6"><a href="#cb495-6" aria-hidden="true" tabindex="-1"></a> bracketedSpanAttributeContextEnd = {)},</span>
+<span id="cb495-7"><a href="#cb495-7" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb495-8"><a href="#cb495-8" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb495-9"><a href="#cb495-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb495-10"><a href="#cb495-10" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb495-11"><a href="#cb495-11" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb495-12"><a href="#cb495-12" aria-hidden="true" tabindex="-1"></a>[foo [bar]{#identifier}]{key=value} [baz]{.class_name}</span>
+<span id="cb495-13"><a href="#cb495-13" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb495-14"><a href="#cb495-14" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb495-15"><a href="#cb495-15" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb493"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb493-1"><a href="#cb493-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb496"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb496-1"><a href="#cb496-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -8734,77 +8826,77 @@ contain the following text:</p>
</blockquote>
<h4 data-number="2.3.1.4" id="bullet-list-renderers"><span
class="header-section-number">2.3.1.4</span> Bullet List Renderers</h4>
-<p>The <code>\markdownRendererUlBegin</code> macro represents the
+<p>The <code>markdownRendererUlBegin</code> macro represents the
beginning of a bulleted list that contains an item with several
paragraphs of text (the list is not tight). The macro receives no
arguments.</p>
-<p>The <code>\markdownRendererUlBeginTight</code> macro represents the
+<p>The <code>markdownRendererUlBeginTight</code> macro represents the
beginning of a bulleted list that contains no item with several
paragraphs of text (the list is tight). This macro will only be
-produced, when the <strong><code>tightLists</code></strong> option is
+produced, when the <code><strong>tightLists</strong></code> option is
disabled. The macro receives no arguments.</p>
-<p>The <code>\markdownRendererUlItem</code> macro represents an item in
-a bulleted list. The macro receives no arguments.</p>
-<p>The <code>\markdownRendererUlItemEnd</code> macro represents the end
+<p>The <code>markdownRendererUlItem</code> macro represents an item in a
+bulleted list. The macro receives no arguments.</p>
+<p>The <code>markdownRendererUlItemEnd</code> macro represents the end
of an item in a bulleted list. The macro receives no arguments.</p>
-<p>The <code>\markdownRendererUlEnd</code> macro represents the end of a
+<p>The <code>markdownRendererUlEnd</code> macro represents the end of a
bulleted list that contains an item with several paragraphs of text (the
list is not tight). The macro receives no arguments.</p>
-<p>The <code>\markdownRendererUlEndTight</code> macro represents the end
+<p>The <code>markdownRendererUlEndTight</code> macro represents the end
of a bulleted list that contains no item with several paragraphs of text
(the list is tight). This macro will only be produced, when the
-<strong><code>tightLists</code></strong> option is disabled. The macro
+<code><strong>tightLists</strong></code> option is disabled. The macro
receives no arguments.</p>
<h5 class="unnumbered" id="plain-tex-example-26">Plain <span
class="tex">T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb494"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb494-1"><a href="#cb494-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
-<span id="cb494-2"><a href="#cb494-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionTightLists</span>{true}</span>
-<span id="cb494-3"><a href="#cb494-3" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb494-4"><a href="#cb494-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{}</span>
-<span id="cb494-5"><a href="#cb494-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererUlBeginTight</span>{ (}</span>
-<span id="cb494-6"><a href="#cb494-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererUlItem</span>{<span class="co">%</span></span>
-<span id="cb494-7"><a href="#cb494-7" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererUlItem</span>{<span class="co">%</span></span>
-<span id="cb494-8"><a href="#cb494-8" aria-hidden="true" tabindex="-1"></a> ,</span>
-<span id="cb494-9"><a href="#cb494-9" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererUlItem</span>{, and }<span class="co">%</span></span>
-<span id="cb494-10"><a href="#cb494-10" aria-hidden="true" tabindex="-1"></a> }<span class="co">%</span></span>
-<span id="cb494-11"><a href="#cb494-11" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb494-12"><a href="#cb494-12" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererUlItemEnd</span>{}</span>
-<span id="cb494-13"><a href="#cb494-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererUlEndTight</span>{).}</span>
-<span id="cb494-14"><a href="#cb494-14" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb494-15"><a href="#cb494-15" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
-<span id="cb494-16"><a href="#cb494-16" aria-hidden="true" tabindex="-1"></a>This is a tight list</span>
-<span id="cb494-17"><a href="#cb494-17" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb494-18"><a href="#cb494-18" aria-hidden="true" tabindex="-1"></a>- the first item</span>
-<span id="cb494-19"><a href="#cb494-19" aria-hidden="true" tabindex="-1"></a>- the second item</span>
-<span id="cb494-20"><a href="#cb494-20" aria-hidden="true" tabindex="-1"></a>- the third item</span>
-<span id="cb494-21"><a href="#cb494-21" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
-<span id="cb494-22"><a href="#cb494-22" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb494-23"><a href="#cb494-23" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span>
-<span id="cb494-24"><a href="#cb494-24" aria-hidden="true" tabindex="-1"></a> :<span class="fu">\par</span></span>
-<span id="cb494-25"><a href="#cb494-25" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="fu">\par</span>}<span class="co">%</span></span>
-<span id="cb494-26"><a href="#cb494-26" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb494-27"><a href="#cb494-27" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererUlBegin</span>{}</span>
-<span id="cb494-28"><a href="#cb494-28" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererUlItem</span>{--<span class="fu">\kern</span> 0.5em}</span>
-<span id="cb494-29"><a href="#cb494-29" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererUlItemEnd</span>{.<span class="fu">\par</span>}</span>
-<span id="cb494-30"><a href="#cb494-30" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererUlEnd</span>{}</span>
-<span id="cb494-31"><a href="#cb494-31" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb494-32"><a href="#cb494-32" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
-<span id="cb494-33"><a href="#cb494-33" aria-hidden="true" tabindex="-1"></a>This is a loose list</span>
-<span id="cb494-34"><a href="#cb494-34" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb494-35"><a href="#cb494-35" aria-hidden="true" tabindex="-1"></a>- This is the first item</span>
-<span id="cb494-36"><a href="#cb494-36" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb494-37"><a href="#cb494-37" aria-hidden="true" tabindex="-1"></a>- This is the second item</span>
-<span id="cb494-38"><a href="#cb494-38" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb494-39"><a href="#cb494-39" aria-hidden="true" tabindex="-1"></a>- This is the third item</span>
-<span id="cb494-40"><a href="#cb494-40" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
-<span id="cb494-41"><a href="#cb494-41" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb494-42"><a href="#cb494-42" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb497"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb497-1"><a href="#cb497-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
+<span id="cb497-2"><a href="#cb497-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionTightLists</span>{true}</span>
+<span id="cb497-3"><a href="#cb497-3" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb497-4"><a href="#cb497-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{}</span>
+<span id="cb497-5"><a href="#cb497-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererUlBeginTight</span>{ (}</span>
+<span id="cb497-6"><a href="#cb497-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererUlItem</span>{<span class="co">%</span></span>
+<span id="cb497-7"><a href="#cb497-7" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererUlItem</span>{<span class="co">%</span></span>
+<span id="cb497-8"><a href="#cb497-8" aria-hidden="true" tabindex="-1"></a> ,</span>
+<span id="cb497-9"><a href="#cb497-9" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererUlItem</span>{, and }<span class="co">%</span></span>
+<span id="cb497-10"><a href="#cb497-10" aria-hidden="true" tabindex="-1"></a> }<span class="co">%</span></span>
+<span id="cb497-11"><a href="#cb497-11" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb497-12"><a href="#cb497-12" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererUlItemEnd</span>{}</span>
+<span id="cb497-13"><a href="#cb497-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererUlEndTight</span>{).}</span>
+<span id="cb497-14"><a href="#cb497-14" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb497-15"><a href="#cb497-15" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
+<span id="cb497-16"><a href="#cb497-16" aria-hidden="true" tabindex="-1"></a>This is a tight list</span>
+<span id="cb497-17"><a href="#cb497-17" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb497-18"><a href="#cb497-18" aria-hidden="true" tabindex="-1"></a>- the first item</span>
+<span id="cb497-19"><a href="#cb497-19" aria-hidden="true" tabindex="-1"></a>- the second item</span>
+<span id="cb497-20"><a href="#cb497-20" aria-hidden="true" tabindex="-1"></a>- the third item</span>
+<span id="cb497-21"><a href="#cb497-21" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
+<span id="cb497-22"><a href="#cb497-22" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb497-23"><a href="#cb497-23" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span>
+<span id="cb497-24"><a href="#cb497-24" aria-hidden="true" tabindex="-1"></a> :<span class="fu">\par</span></span>
+<span id="cb497-25"><a href="#cb497-25" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="fu">\par</span>}<span class="co">%</span></span>
+<span id="cb497-26"><a href="#cb497-26" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb497-27"><a href="#cb497-27" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererUlBegin</span>{}</span>
+<span id="cb497-28"><a href="#cb497-28" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererUlItem</span>{--<span class="fu">\kern</span> 0.5em}</span>
+<span id="cb497-29"><a href="#cb497-29" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererUlItemEnd</span>{.<span class="fu">\par</span>}</span>
+<span id="cb497-30"><a href="#cb497-30" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererUlEnd</span>{}</span>
+<span id="cb497-31"><a href="#cb497-31" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb497-32"><a href="#cb497-32" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
+<span id="cb497-33"><a href="#cb497-33" aria-hidden="true" tabindex="-1"></a>This is a loose list</span>
+<span id="cb497-34"><a href="#cb497-34" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb497-35"><a href="#cb497-35" aria-hidden="true" tabindex="-1"></a>- This is the first item</span>
+<span id="cb497-36"><a href="#cb497-36" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb497-37"><a href="#cb497-37" aria-hidden="true" tabindex="-1"></a>- This is the second item</span>
+<span id="cb497-38"><a href="#cb497-38" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb497-39"><a href="#cb497-39" aria-hidden="true" tabindex="-1"></a>- This is the third item</span>
+<span id="cb497-40"><a href="#cb497-40" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
+<span id="cb497-41"><a href="#cb497-41" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb497-42"><a href="#cb497-42" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb495"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb495-1"><a href="#cb495-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb498"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb498-1"><a href="#cb498-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -8821,57 +8913,57 @@ item).</p>
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb496"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb496-1"><a href="#cb496-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb496-2"><a href="#cb496-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[tightLists]{<span class="ex">markdown</span>}</span>
-<span id="cb496-3"><a href="#cb496-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb496-4"><a href="#cb496-4" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb496-5"><a href="#cb496-5" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}[</span>
-<span id="cb496-6"><a href="#cb496-6" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb496-7"><a href="#cb496-7" aria-hidden="true" tabindex="-1"></a> interblockSeparator = {},</span>
-<span id="cb496-8"><a href="#cb496-8" aria-hidden="true" tabindex="-1"></a> ulBeginTight = { (},</span>
-<span id="cb496-9"><a href="#cb496-9" aria-hidden="true" tabindex="-1"></a> ulItem = {<span class="co">%</span></span>
-<span id="cb496-10"><a href="#cb496-10" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererUlItem</span>{<span class="co">%</span></span>
-<span id="cb496-11"><a href="#cb496-11" aria-hidden="true" tabindex="-1"></a> ,</span>
-<span id="cb496-12"><a href="#cb496-12" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererUlItem</span>{, and }<span class="co">%</span></span>
-<span id="cb496-13"><a href="#cb496-13" aria-hidden="true" tabindex="-1"></a> }<span class="co">%</span></span>
-<span id="cb496-14"><a href="#cb496-14" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb496-15"><a href="#cb496-15" aria-hidden="true" tabindex="-1"></a> ulItemEnd = {},</span>
-<span id="cb496-16"><a href="#cb496-16" aria-hidden="true" tabindex="-1"></a> ulEndTight = {).},</span>
-<span id="cb496-17"><a href="#cb496-17" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb496-18"><a href="#cb496-18" aria-hidden="true" tabindex="-1"></a>]</span>
-<span id="cb496-19"><a href="#cb496-19" aria-hidden="true" tabindex="-1"></a>This is a tight list</span>
-<span id="cb496-20"><a href="#cb496-20" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb496-21"><a href="#cb496-21" aria-hidden="true" tabindex="-1"></a>- the first item</span>
-<span id="cb496-22"><a href="#cb496-22" aria-hidden="true" tabindex="-1"></a>- the second item</span>
-<span id="cb496-23"><a href="#cb496-23" aria-hidden="true" tabindex="-1"></a>- the third item</span>
-<span id="cb496-24"><a href="#cb496-24" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb496-25"><a href="#cb496-25" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb496-26"><a href="#cb496-26" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}[</span>
-<span id="cb496-27"><a href="#cb496-27" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb496-28"><a href="#cb496-28" aria-hidden="true" tabindex="-1"></a> interblockSeparator = {<span class="co">%</span></span>
-<span id="cb496-29"><a href="#cb496-29" aria-hidden="true" tabindex="-1"></a> :<span class="fu">\par</span></span>
-<span id="cb496-30"><a href="#cb496-30" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="fu">\par</span>}<span class="co">%</span></span>
-<span id="cb496-31"><a href="#cb496-31" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb496-32"><a href="#cb496-32" aria-hidden="true" tabindex="-1"></a> ulBeginTight = {<span class="kw">\begin</span>{<span class="ex">itemize</span>}},</span>
-<span id="cb496-33"><a href="#cb496-33" aria-hidden="true" tabindex="-1"></a> ulItem = {<span class="fu">\item</span>},</span>
-<span id="cb496-34"><a href="#cb496-34" aria-hidden="true" tabindex="-1"></a> ulItemEnd = {.},</span>
-<span id="cb496-35"><a href="#cb496-35" aria-hidden="true" tabindex="-1"></a> ulEnd = {<span class="kw">\end</span>{<span class="ex">itemize</span>}},</span>
-<span id="cb496-36"><a href="#cb496-36" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb496-37"><a href="#cb496-37" aria-hidden="true" tabindex="-1"></a>]</span>
-<span id="cb496-38"><a href="#cb496-38" aria-hidden="true" tabindex="-1"></a>This is a loose list</span>
-<span id="cb496-39"><a href="#cb496-39" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb496-40"><a href="#cb496-40" aria-hidden="true" tabindex="-1"></a>- This is the first item</span>
-<span id="cb496-41"><a href="#cb496-41" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb496-42"><a href="#cb496-42" aria-hidden="true" tabindex="-1"></a>- This is the second item</span>
-<span id="cb496-43"><a href="#cb496-43" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb496-44"><a href="#cb496-44" aria-hidden="true" tabindex="-1"></a>- This is the third item</span>
-<span id="cb496-45"><a href="#cb496-45" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb496-46"><a href="#cb496-46" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb496-47"><a href="#cb496-47" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb499"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb499-1"><a href="#cb499-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb499-2"><a href="#cb499-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[tightLists]{<span class="ex">markdown</span>}</span>
+<span id="cb499-3"><a href="#cb499-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb499-4"><a href="#cb499-4" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb499-5"><a href="#cb499-5" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}[</span>
+<span id="cb499-6"><a href="#cb499-6" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb499-7"><a href="#cb499-7" aria-hidden="true" tabindex="-1"></a> interblockSeparator = {},</span>
+<span id="cb499-8"><a href="#cb499-8" aria-hidden="true" tabindex="-1"></a> ulBeginTight = { (},</span>
+<span id="cb499-9"><a href="#cb499-9" aria-hidden="true" tabindex="-1"></a> ulItem = {<span class="co">%</span></span>
+<span id="cb499-10"><a href="#cb499-10" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererUlItem</span>{<span class="co">%</span></span>
+<span id="cb499-11"><a href="#cb499-11" aria-hidden="true" tabindex="-1"></a> ,</span>
+<span id="cb499-12"><a href="#cb499-12" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererUlItem</span>{, and }<span class="co">%</span></span>
+<span id="cb499-13"><a href="#cb499-13" aria-hidden="true" tabindex="-1"></a> }<span class="co">%</span></span>
+<span id="cb499-14"><a href="#cb499-14" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb499-15"><a href="#cb499-15" aria-hidden="true" tabindex="-1"></a> ulItemEnd = {},</span>
+<span id="cb499-16"><a href="#cb499-16" aria-hidden="true" tabindex="-1"></a> ulEndTight = {).},</span>
+<span id="cb499-17"><a href="#cb499-17" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb499-18"><a href="#cb499-18" aria-hidden="true" tabindex="-1"></a>]</span>
+<span id="cb499-19"><a href="#cb499-19" aria-hidden="true" tabindex="-1"></a>This is a tight list</span>
+<span id="cb499-20"><a href="#cb499-20" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb499-21"><a href="#cb499-21" aria-hidden="true" tabindex="-1"></a>- the first item</span>
+<span id="cb499-22"><a href="#cb499-22" aria-hidden="true" tabindex="-1"></a>- the second item</span>
+<span id="cb499-23"><a href="#cb499-23" aria-hidden="true" tabindex="-1"></a>- the third item</span>
+<span id="cb499-24"><a href="#cb499-24" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb499-25"><a href="#cb499-25" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb499-26"><a href="#cb499-26" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}[</span>
+<span id="cb499-27"><a href="#cb499-27" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb499-28"><a href="#cb499-28" aria-hidden="true" tabindex="-1"></a> interblockSeparator = {<span class="co">%</span></span>
+<span id="cb499-29"><a href="#cb499-29" aria-hidden="true" tabindex="-1"></a> :<span class="fu">\par</span></span>
+<span id="cb499-30"><a href="#cb499-30" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="fu">\par</span>}<span class="co">%</span></span>
+<span id="cb499-31"><a href="#cb499-31" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb499-32"><a href="#cb499-32" aria-hidden="true" tabindex="-1"></a> ulBeginTight = {<span class="kw">\begin</span>{<span class="ex">itemize</span>}},</span>
+<span id="cb499-33"><a href="#cb499-33" aria-hidden="true" tabindex="-1"></a> ulItem = {<span class="fu">\item</span>},</span>
+<span id="cb499-34"><a href="#cb499-34" aria-hidden="true" tabindex="-1"></a> ulItemEnd = {.},</span>
+<span id="cb499-35"><a href="#cb499-35" aria-hidden="true" tabindex="-1"></a> ulEnd = {<span class="kw">\end</span>{<span class="ex">itemize</span>}},</span>
+<span id="cb499-36"><a href="#cb499-36" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb499-37"><a href="#cb499-37" aria-hidden="true" tabindex="-1"></a>]</span>
+<span id="cb499-38"><a href="#cb499-38" aria-hidden="true" tabindex="-1"></a>This is a loose list</span>
+<span id="cb499-39"><a href="#cb499-39" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb499-40"><a href="#cb499-40" aria-hidden="true" tabindex="-1"></a>- This is the first item</span>
+<span id="cb499-41"><a href="#cb499-41" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb499-42"><a href="#cb499-42" aria-hidden="true" tabindex="-1"></a>- This is the second item</span>
+<span id="cb499-43"><a href="#cb499-43" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb499-44"><a href="#cb499-44" aria-hidden="true" tabindex="-1"></a>- This is the third item</span>
+<span id="cb499-45"><a href="#cb499-45" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb499-46"><a href="#cb499-46" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb499-47"><a href="#cb499-47" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb497"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb497-1"><a href="#cb497-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb500"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb500-1"><a href="#cb500-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -8888,53 +8980,53 @@ item).</p>
class="tex">T<sub>e</sub>X</span>t Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb498"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb498-1"><a href="#cb498-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
-<span id="cb498-2"><a href="#cb498-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[tightLists = yes]</span>
-<span id="cb498-3"><a href="#cb498-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
-<span id="cb498-4"><a href="#cb498-4" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb498-5"><a href="#cb498-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{}</span>
-<span id="cb498-6"><a href="#cb498-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererUlBeginTight</span>{ (}</span>
-<span id="cb498-7"><a href="#cb498-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererUlItem</span>{<span class="co">%</span></span>
-<span id="cb498-8"><a href="#cb498-8" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererUlItem</span>{<span class="co">%</span></span>
-<span id="cb498-9"><a href="#cb498-9" aria-hidden="true" tabindex="-1"></a> ,</span>
-<span id="cb498-10"><a href="#cb498-10" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererUlItem</span>{, and }<span class="co">%</span></span>
-<span id="cb498-11"><a href="#cb498-11" aria-hidden="true" tabindex="-1"></a> }<span class="co">%</span></span>
-<span id="cb498-12"><a href="#cb498-12" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb498-13"><a href="#cb498-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererUlItemEnd</span>{}</span>
-<span id="cb498-14"><a href="#cb498-14" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererUlEndTight</span>{).}</span>
-<span id="cb498-15"><a href="#cb498-15" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb498-16"><a href="#cb498-16" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb498-17"><a href="#cb498-17" aria-hidden="true" tabindex="-1"></a>This is a tight list</span>
-<span id="cb498-18"><a href="#cb498-18" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb498-19"><a href="#cb498-19" aria-hidden="true" tabindex="-1"></a>- the first item</span>
-<span id="cb498-20"><a href="#cb498-20" aria-hidden="true" tabindex="-1"></a>- the second item</span>
-<span id="cb498-21"><a href="#cb498-21" aria-hidden="true" tabindex="-1"></a>- the third item</span>
-<span id="cb498-22"><a href="#cb498-22" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb498-23"><a href="#cb498-23" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb498-24"><a href="#cb498-24" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span>
-<span id="cb498-25"><a href="#cb498-25" aria-hidden="true" tabindex="-1"></a> :<span class="fu">\par</span></span>
-<span id="cb498-26"><a href="#cb498-26" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="fu">\par</span>}<span class="co">%</span></span>
-<span id="cb498-27"><a href="#cb498-27" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb498-28"><a href="#cb498-28" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererUlBegin</span>{<span class="fu">\startitemize</span>}</span>
-<span id="cb498-29"><a href="#cb498-29" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererUlItem</span>{<span class="fu">\item</span>}</span>
-<span id="cb498-30"><a href="#cb498-30" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererUlItemEnd</span>{.}</span>
-<span id="cb498-31"><a href="#cb498-31" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererUlEnd</span>{<span class="fu">\stopitemize</span>}</span>
-<span id="cb498-32"><a href="#cb498-32" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb498-33"><a href="#cb498-33" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb498-34"><a href="#cb498-34" aria-hidden="true" tabindex="-1"></a>This is a loose list</span>
-<span id="cb498-35"><a href="#cb498-35" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb498-36"><a href="#cb498-36" aria-hidden="true" tabindex="-1"></a>- This is the first item</span>
-<span id="cb498-37"><a href="#cb498-37" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb498-38"><a href="#cb498-38" aria-hidden="true" tabindex="-1"></a>- This is the second item</span>
-<span id="cb498-39"><a href="#cb498-39" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb498-40"><a href="#cb498-40" aria-hidden="true" tabindex="-1"></a>- This is the third item</span>
-<span id="cb498-41"><a href="#cb498-41" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb498-42"><a href="#cb498-42" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb498-43"><a href="#cb498-43" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
+<div class="sourceCode" id="cb501"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb501-1"><a href="#cb501-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
+<span id="cb501-2"><a href="#cb501-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[tightLists = yes]</span>
+<span id="cb501-3"><a href="#cb501-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
+<span id="cb501-4"><a href="#cb501-4" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb501-5"><a href="#cb501-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{}</span>
+<span id="cb501-6"><a href="#cb501-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererUlBeginTight</span>{ (}</span>
+<span id="cb501-7"><a href="#cb501-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererUlItem</span>{<span class="co">%</span></span>
+<span id="cb501-8"><a href="#cb501-8" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererUlItem</span>{<span class="co">%</span></span>
+<span id="cb501-9"><a href="#cb501-9" aria-hidden="true" tabindex="-1"></a> ,</span>
+<span id="cb501-10"><a href="#cb501-10" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererUlItem</span>{, and }<span class="co">%</span></span>
+<span id="cb501-11"><a href="#cb501-11" aria-hidden="true" tabindex="-1"></a> }<span class="co">%</span></span>
+<span id="cb501-12"><a href="#cb501-12" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb501-13"><a href="#cb501-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererUlItemEnd</span>{}</span>
+<span id="cb501-14"><a href="#cb501-14" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererUlEndTight</span>{).}</span>
+<span id="cb501-15"><a href="#cb501-15" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb501-16"><a href="#cb501-16" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb501-17"><a href="#cb501-17" aria-hidden="true" tabindex="-1"></a>This is a tight list</span>
+<span id="cb501-18"><a href="#cb501-18" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb501-19"><a href="#cb501-19" aria-hidden="true" tabindex="-1"></a>- the first item</span>
+<span id="cb501-20"><a href="#cb501-20" aria-hidden="true" tabindex="-1"></a>- the second item</span>
+<span id="cb501-21"><a href="#cb501-21" aria-hidden="true" tabindex="-1"></a>- the third item</span>
+<span id="cb501-22"><a href="#cb501-22" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb501-23"><a href="#cb501-23" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb501-24"><a href="#cb501-24" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span>
+<span id="cb501-25"><a href="#cb501-25" aria-hidden="true" tabindex="-1"></a> :<span class="fu">\par</span></span>
+<span id="cb501-26"><a href="#cb501-26" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="fu">\par</span>}<span class="co">%</span></span>
+<span id="cb501-27"><a href="#cb501-27" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb501-28"><a href="#cb501-28" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererUlBegin</span>{<span class="fu">\startitemize</span>}</span>
+<span id="cb501-29"><a href="#cb501-29" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererUlItem</span>{<span class="fu">\item</span>}</span>
+<span id="cb501-30"><a href="#cb501-30" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererUlItemEnd</span>{.}</span>
+<span id="cb501-31"><a href="#cb501-31" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererUlEnd</span>{<span class="fu">\stopitemize</span>}</span>
+<span id="cb501-32"><a href="#cb501-32" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb501-33"><a href="#cb501-33" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb501-34"><a href="#cb501-34" aria-hidden="true" tabindex="-1"></a>This is a loose list</span>
+<span id="cb501-35"><a href="#cb501-35" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb501-36"><a href="#cb501-36" aria-hidden="true" tabindex="-1"></a>- This is the first item</span>
+<span id="cb501-37"><a href="#cb501-37" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb501-38"><a href="#cb501-38" aria-hidden="true" tabindex="-1"></a>- This is the second item</span>
+<span id="cb501-39"><a href="#cb501-39" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb501-40"><a href="#cb501-40" aria-hidden="true" tabindex="-1"></a>- This is the third item</span>
+<span id="cb501-41"><a href="#cb501-41" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb501-42"><a href="#cb501-42" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb501-43"><a href="#cb501-43" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb499"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb499-1"><a href="#cb499-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb502"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb502-1"><a href="#cb502-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -8949,9 +9041,9 @@ item).</p>
</blockquote>
<h4 data-number="2.3.1.5" id="citation-renderers"><span
class="header-section-number">2.3.1.5</span> Citation Renderers</h4>
-<p>The <code>\markdownRendererCite</code> macro represents a string of
+<p>The <code>markdownRendererCite</code> macro represents a string of
one or more parenthetical citations. This macro will only be produced,
-when the <strong><code>citations</code></strong> option is enabled. The
+when the <code><strong>citations</strong></code> option is enabled. The
macro receives the parameter <code>{</code>⟨<em>number of
citations</em>⟩<code>}</code> followed by ⟨<em>suppress author</em>⟩
<code>{</code>⟨<em>prenote</em>⟩<code>}{</code>⟨<em>postnote</em>⟩<code>}{</code>⟨<em>name</em>⟩<code>}</code>
@@ -8962,50 +9054,50 @@ author’s name is to be suppressed, or <code>+</code> otherwise.</p>
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb500"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb500-1"><a href="#cb500-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb500-2"><a href="#cb500-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[citations]{<span class="ex">markdown</span>}</span>
-<span id="cb500-3"><a href="#cb500-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\newcount\citationsCounter</span></span>
-<span id="cb500-4"><a href="#cb500-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\newcount\citationsTotal</span></span>
-<span id="cb500-5"><a href="#cb500-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\makeatletter</span></span>
-<span id="cb500-6"><a href="#cb500-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\citations</span>#1#2#3#4{<span class="co">%</span></span>
-<span id="cb500-7"><a href="#cb500-7" aria-hidden="true" tabindex="-1"></a> a parenthesized citation <span class="fu">\emph</span>{#4}</span>
-<span id="cb500-8"><a href="#cb500-8" aria-hidden="true" tabindex="-1"></a> <span class="fu">\advance\citationsCounter</span> by 1<span class="fu">\relax</span></span>
-<span id="cb500-9"><a href="#cb500-9" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifx\relax</span>#2<span class="fu">\relax</span></span>
-<span id="cb500-10"><a href="#cb500-10" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifx\relax</span>#3<span class="fu">\relax\else</span></span>
-<span id="cb500-11"><a href="#cb500-11" aria-hidden="true" tabindex="-1"></a> with a postfix <span class="fu">\emph</span>{#3}<span class="co">%</span></span>
-<span id="cb500-12"><a href="#cb500-12" aria-hidden="true" tabindex="-1"></a> <span class="fu">\fi</span></span>
-<span id="cb500-13"><a href="#cb500-13" aria-hidden="true" tabindex="-1"></a> <span class="fu">\else</span></span>
-<span id="cb500-14"><a href="#cb500-14" aria-hidden="true" tabindex="-1"></a> with a prefix <span class="fu">\emph</span>{#2}<span class="co">%</span></span>
-<span id="cb500-15"><a href="#cb500-15" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifx\relax</span>#3<span class="fu">\relax\else</span></span>
-<span id="cb500-16"><a href="#cb500-16" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ </span>and a postfix <span class="fu">\emph</span>{#3}<span class="co">%</span></span>
-<span id="cb500-17"><a href="#cb500-17" aria-hidden="true" tabindex="-1"></a> <span class="fu">\fi</span></span>
-<span id="cb500-18"><a href="#cb500-18" aria-hidden="true" tabindex="-1"></a> <span class="fu">\fi</span></span>
-<span id="cb500-19"><a href="#cb500-19" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifnum\citationsCounter</span>&gt;<span class="fu">\citationsTotal\relax</span></span>
-<span id="cb500-20"><a href="#cb500-20" aria-hidden="true" tabindex="-1"></a> .<span class="co">%</span></span>
-<span id="cb500-21"><a href="#cb500-21" aria-hidden="true" tabindex="-1"></a> <span class="fu">\expandafter\@gobble</span></span>
-<span id="cb500-22"><a href="#cb500-22" aria-hidden="true" tabindex="-1"></a> <span class="fu">\else</span></span>
-<span id="cb500-23"><a href="#cb500-23" aria-hidden="true" tabindex="-1"></a> , and</span>
-<span id="cb500-24"><a href="#cb500-24" aria-hidden="true" tabindex="-1"></a> <span class="fu">\fi\citations</span>}</span>
-<span id="cb500-25"><a href="#cb500-25" aria-hidden="true" tabindex="-1"></a><span class="fu">\makeatother</span></span>
-<span id="cb500-26"><a href="#cb500-26" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb500-27"><a href="#cb500-27" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb500-28"><a href="#cb500-28" aria-hidden="true" tabindex="-1"></a> cite = {<span class="co">%</span></span>
-<span id="cb500-29"><a href="#cb500-29" aria-hidden="true" tabindex="-1"></a> <span class="fu">\citationsCounter</span>=1<span class="co">%</span></span>
-<span id="cb500-30"><a href="#cb500-30" aria-hidden="true" tabindex="-1"></a> <span class="fu">\citationsTotal</span>=#1<span class="co">%</span></span>
-<span id="cb500-31"><a href="#cb500-31" aria-hidden="true" tabindex="-1"></a> This is</span>
-<span id="cb500-32"><a href="#cb500-32" aria-hidden="true" tabindex="-1"></a> <span class="fu">\expandafter\citations</span></span>
-<span id="cb500-33"><a href="#cb500-33" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb500-34"><a href="#cb500-34" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb500-35"><a href="#cb500-35" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb500-36"><a href="#cb500-36" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb500-37"><a href="#cb500-37" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb500-38"><a href="#cb500-38" aria-hidden="true" tabindex="-1"></a>[see @abrahams90, pp. 12; @eijkhout91, pp. 34]</span>
-<span id="cb500-39"><a href="#cb500-39" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb500-40"><a href="#cb500-40" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb503"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb503-1"><a href="#cb503-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb503-2"><a href="#cb503-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[citations]{<span class="ex">markdown</span>}</span>
+<span id="cb503-3"><a href="#cb503-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\newcount\citationsCounter</span></span>
+<span id="cb503-4"><a href="#cb503-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\newcount\citationsTotal</span></span>
+<span id="cb503-5"><a href="#cb503-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\makeatletter</span></span>
+<span id="cb503-6"><a href="#cb503-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\citations</span>#1#2#3#4{<span class="co">%</span></span>
+<span id="cb503-7"><a href="#cb503-7" aria-hidden="true" tabindex="-1"></a> a parenthesized citation <span class="fu">\emph</span>{#4}</span>
+<span id="cb503-8"><a href="#cb503-8" aria-hidden="true" tabindex="-1"></a> <span class="fu">\advance\citationsCounter</span> by 1<span class="fu">\relax</span></span>
+<span id="cb503-9"><a href="#cb503-9" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifx\relax</span>#2<span class="fu">\relax</span></span>
+<span id="cb503-10"><a href="#cb503-10" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifx\relax</span>#3<span class="fu">\relax\else</span></span>
+<span id="cb503-11"><a href="#cb503-11" aria-hidden="true" tabindex="-1"></a> with a postfix <span class="fu">\emph</span>{#3}<span class="co">%</span></span>
+<span id="cb503-12"><a href="#cb503-12" aria-hidden="true" tabindex="-1"></a> <span class="fu">\fi</span></span>
+<span id="cb503-13"><a href="#cb503-13" aria-hidden="true" tabindex="-1"></a> <span class="fu">\else</span></span>
+<span id="cb503-14"><a href="#cb503-14" aria-hidden="true" tabindex="-1"></a> with a prefix <span class="fu">\emph</span>{#2}<span class="co">%</span></span>
+<span id="cb503-15"><a href="#cb503-15" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifx\relax</span>#3<span class="fu">\relax\else</span></span>
+<span id="cb503-16"><a href="#cb503-16" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ </span>and a postfix <span class="fu">\emph</span>{#3}<span class="co">%</span></span>
+<span id="cb503-17"><a href="#cb503-17" aria-hidden="true" tabindex="-1"></a> <span class="fu">\fi</span></span>
+<span id="cb503-18"><a href="#cb503-18" aria-hidden="true" tabindex="-1"></a> <span class="fu">\fi</span></span>
+<span id="cb503-19"><a href="#cb503-19" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifnum\citationsCounter</span>&gt;<span class="fu">\citationsTotal\relax</span></span>
+<span id="cb503-20"><a href="#cb503-20" aria-hidden="true" tabindex="-1"></a> .<span class="co">%</span></span>
+<span id="cb503-21"><a href="#cb503-21" aria-hidden="true" tabindex="-1"></a> <span class="fu">\expandafter\@gobble</span></span>
+<span id="cb503-22"><a href="#cb503-22" aria-hidden="true" tabindex="-1"></a> <span class="fu">\else</span></span>
+<span id="cb503-23"><a href="#cb503-23" aria-hidden="true" tabindex="-1"></a> , and</span>
+<span id="cb503-24"><a href="#cb503-24" aria-hidden="true" tabindex="-1"></a> <span class="fu">\fi\citations</span>}</span>
+<span id="cb503-25"><a href="#cb503-25" aria-hidden="true" tabindex="-1"></a><span class="fu">\makeatother</span></span>
+<span id="cb503-26"><a href="#cb503-26" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb503-27"><a href="#cb503-27" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb503-28"><a href="#cb503-28" aria-hidden="true" tabindex="-1"></a> cite = {<span class="co">%</span></span>
+<span id="cb503-29"><a href="#cb503-29" aria-hidden="true" tabindex="-1"></a> <span class="fu">\citationsCounter</span>=1<span class="co">%</span></span>
+<span id="cb503-30"><a href="#cb503-30" aria-hidden="true" tabindex="-1"></a> <span class="fu">\citationsTotal</span>=#1<span class="co">%</span></span>
+<span id="cb503-31"><a href="#cb503-31" aria-hidden="true" tabindex="-1"></a> This is</span>
+<span id="cb503-32"><a href="#cb503-32" aria-hidden="true" tabindex="-1"></a> <span class="fu">\expandafter\citations</span></span>
+<span id="cb503-33"><a href="#cb503-33" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb503-34"><a href="#cb503-34" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb503-35"><a href="#cb503-35" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb503-36"><a href="#cb503-36" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb503-37"><a href="#cb503-37" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb503-38"><a href="#cb503-38" aria-hidden="true" tabindex="-1"></a>[see @abrahams90, pp. 12; @eijkhout91, pp. 34]</span>
+<span id="cb503-39"><a href="#cb503-39" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb503-40"><a href="#cb503-40" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb501"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb501-1"><a href="#cb501-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb504"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb504-1"><a href="#cb504-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -9013,59 +9105,59 @@ contain the following text:</p>
see and a postfix <em>pp. 12</em>, and a citation <em>eijkhout91</em>
with a postfix <em>pp. 34</em>.</p>
</blockquote>
-<p>The <code>\markdownRendererTextCite</code> macro represents a string
+<p>The <code>markdownRendererTextCite</code> macro represents a string
of one or more text citations. This macro will only be produced, when
-the <strong><code>citations</code></strong> option is enabled. The macro
+the <code><strong>citations</strong></code> option is enabled. The macro
receives parameters in the same format as the
-<code>\markdownRendererCite</code> macro.</p>
+<code>markdownRendererCite</code> macro.</p>
<h5 class="unnumbered" id="latex-example-61"><span
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb502"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb502-1"><a href="#cb502-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb502-2"><a href="#cb502-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[citations]{<span class="ex">markdown</span>}</span>
-<span id="cb502-3"><a href="#cb502-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\newcount\citationsCounter</span></span>
-<span id="cb502-4"><a href="#cb502-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\newcount\citationsTotal</span></span>
-<span id="cb502-5"><a href="#cb502-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\makeatletter</span></span>
-<span id="cb502-6"><a href="#cb502-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\citations</span>#1#2#3#4{<span class="co">%</span></span>
-<span id="cb502-7"><a href="#cb502-7" aria-hidden="true" tabindex="-1"></a> a text citation <span class="fu">\emph</span>{#4}</span>
-<span id="cb502-8"><a href="#cb502-8" aria-hidden="true" tabindex="-1"></a> <span class="fu">\advance\citationsCounter</span> by 1<span class="fu">\relax</span></span>
-<span id="cb502-9"><a href="#cb502-9" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifx\relax</span>#2<span class="fu">\relax</span></span>
-<span id="cb502-10"><a href="#cb502-10" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifx\relax</span>#3<span class="fu">\relax\else</span></span>
-<span id="cb502-11"><a href="#cb502-11" aria-hidden="true" tabindex="-1"></a> with a postfix <span class="fu">\emph</span>{#3}<span class="co">%</span></span>
-<span id="cb502-12"><a href="#cb502-12" aria-hidden="true" tabindex="-1"></a> <span class="fu">\fi</span></span>
-<span id="cb502-13"><a href="#cb502-13" aria-hidden="true" tabindex="-1"></a> <span class="fu">\else</span></span>
-<span id="cb502-14"><a href="#cb502-14" aria-hidden="true" tabindex="-1"></a> with a prefix <span class="fu">\emph</span>{#2}<span class="co">%</span></span>
-<span id="cb502-15"><a href="#cb502-15" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifx\relax</span>#3<span class="fu">\relax\else</span></span>
-<span id="cb502-16"><a href="#cb502-16" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ </span>and a postfix <span class="fu">\emph</span>{#3}<span class="co">%</span></span>
-<span id="cb502-17"><a href="#cb502-17" aria-hidden="true" tabindex="-1"></a> <span class="fu">\fi</span></span>
-<span id="cb502-18"><a href="#cb502-18" aria-hidden="true" tabindex="-1"></a> <span class="fu">\fi</span></span>
-<span id="cb502-19"><a href="#cb502-19" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifnum\citationsCounter</span>&gt;<span class="fu">\citationsTotal\relax</span></span>
-<span id="cb502-20"><a href="#cb502-20" aria-hidden="true" tabindex="-1"></a> .<span class="co">%</span></span>
-<span id="cb502-21"><a href="#cb502-21" aria-hidden="true" tabindex="-1"></a> <span class="fu">\expandafter\@gobble</span></span>
-<span id="cb502-22"><a href="#cb502-22" aria-hidden="true" tabindex="-1"></a> <span class="fu">\else</span></span>
-<span id="cb502-23"><a href="#cb502-23" aria-hidden="true" tabindex="-1"></a> , and</span>
-<span id="cb502-24"><a href="#cb502-24" aria-hidden="true" tabindex="-1"></a> <span class="fu">\fi\citations</span>}</span>
-<span id="cb502-25"><a href="#cb502-25" aria-hidden="true" tabindex="-1"></a><span class="fu">\makeatother</span></span>
-<span id="cb502-26"><a href="#cb502-26" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb502-27"><a href="#cb502-27" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb502-28"><a href="#cb502-28" aria-hidden="true" tabindex="-1"></a> textCite = {<span class="co">%</span></span>
-<span id="cb502-29"><a href="#cb502-29" aria-hidden="true" tabindex="-1"></a> <span class="fu">\citationsCounter</span>=1<span class="co">%</span></span>
-<span id="cb502-30"><a href="#cb502-30" aria-hidden="true" tabindex="-1"></a> <span class="fu">\citationsTotal</span>=#1<span class="co">%</span></span>
-<span id="cb502-31"><a href="#cb502-31" aria-hidden="true" tabindex="-1"></a> This is</span>
-<span id="cb502-32"><a href="#cb502-32" aria-hidden="true" tabindex="-1"></a> <span class="fu">\expandafter\citations</span></span>
-<span id="cb502-33"><a href="#cb502-33" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb502-34"><a href="#cb502-34" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb502-35"><a href="#cb502-35" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb502-36"><a href="#cb502-36" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb502-37"><a href="#cb502-37" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb502-38"><a href="#cb502-38" aria-hidden="true" tabindex="-1"></a>@abrahams90 [pp. 12; also @eijkhout91]</span>
-<span id="cb502-39"><a href="#cb502-39" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb502-40"><a href="#cb502-40" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb505"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb505-1"><a href="#cb505-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb505-2"><a href="#cb505-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[citations]{<span class="ex">markdown</span>}</span>
+<span id="cb505-3"><a href="#cb505-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\newcount\citationsCounter</span></span>
+<span id="cb505-4"><a href="#cb505-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\newcount\citationsTotal</span></span>
+<span id="cb505-5"><a href="#cb505-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\makeatletter</span></span>
+<span id="cb505-6"><a href="#cb505-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\citations</span>#1#2#3#4{<span class="co">%</span></span>
+<span id="cb505-7"><a href="#cb505-7" aria-hidden="true" tabindex="-1"></a> a text citation <span class="fu">\emph</span>{#4}</span>
+<span id="cb505-8"><a href="#cb505-8" aria-hidden="true" tabindex="-1"></a> <span class="fu">\advance\citationsCounter</span> by 1<span class="fu">\relax</span></span>
+<span id="cb505-9"><a href="#cb505-9" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifx\relax</span>#2<span class="fu">\relax</span></span>
+<span id="cb505-10"><a href="#cb505-10" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifx\relax</span>#3<span class="fu">\relax\else</span></span>
+<span id="cb505-11"><a href="#cb505-11" aria-hidden="true" tabindex="-1"></a> with a postfix <span class="fu">\emph</span>{#3}<span class="co">%</span></span>
+<span id="cb505-12"><a href="#cb505-12" aria-hidden="true" tabindex="-1"></a> <span class="fu">\fi</span></span>
+<span id="cb505-13"><a href="#cb505-13" aria-hidden="true" tabindex="-1"></a> <span class="fu">\else</span></span>
+<span id="cb505-14"><a href="#cb505-14" aria-hidden="true" tabindex="-1"></a> with a prefix <span class="fu">\emph</span>{#2}<span class="co">%</span></span>
+<span id="cb505-15"><a href="#cb505-15" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifx\relax</span>#3<span class="fu">\relax\else</span></span>
+<span id="cb505-16"><a href="#cb505-16" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ </span>and a postfix <span class="fu">\emph</span>{#3}<span class="co">%</span></span>
+<span id="cb505-17"><a href="#cb505-17" aria-hidden="true" tabindex="-1"></a> <span class="fu">\fi</span></span>
+<span id="cb505-18"><a href="#cb505-18" aria-hidden="true" tabindex="-1"></a> <span class="fu">\fi</span></span>
+<span id="cb505-19"><a href="#cb505-19" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifnum\citationsCounter</span>&gt;<span class="fu">\citationsTotal\relax</span></span>
+<span id="cb505-20"><a href="#cb505-20" aria-hidden="true" tabindex="-1"></a> .<span class="co">%</span></span>
+<span id="cb505-21"><a href="#cb505-21" aria-hidden="true" tabindex="-1"></a> <span class="fu">\expandafter\@gobble</span></span>
+<span id="cb505-22"><a href="#cb505-22" aria-hidden="true" tabindex="-1"></a> <span class="fu">\else</span></span>
+<span id="cb505-23"><a href="#cb505-23" aria-hidden="true" tabindex="-1"></a> , and</span>
+<span id="cb505-24"><a href="#cb505-24" aria-hidden="true" tabindex="-1"></a> <span class="fu">\fi\citations</span>}</span>
+<span id="cb505-25"><a href="#cb505-25" aria-hidden="true" tabindex="-1"></a><span class="fu">\makeatother</span></span>
+<span id="cb505-26"><a href="#cb505-26" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb505-27"><a href="#cb505-27" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb505-28"><a href="#cb505-28" aria-hidden="true" tabindex="-1"></a> textCite = {<span class="co">%</span></span>
+<span id="cb505-29"><a href="#cb505-29" aria-hidden="true" tabindex="-1"></a> <span class="fu">\citationsCounter</span>=1<span class="co">%</span></span>
+<span id="cb505-30"><a href="#cb505-30" aria-hidden="true" tabindex="-1"></a> <span class="fu">\citationsTotal</span>=#1<span class="co">%</span></span>
+<span id="cb505-31"><a href="#cb505-31" aria-hidden="true" tabindex="-1"></a> This is</span>
+<span id="cb505-32"><a href="#cb505-32" aria-hidden="true" tabindex="-1"></a> <span class="fu">\expandafter\citations</span></span>
+<span id="cb505-33"><a href="#cb505-33" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb505-34"><a href="#cb505-34" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb505-35"><a href="#cb505-35" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb505-36"><a href="#cb505-36" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb505-37"><a href="#cb505-37" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb505-38"><a href="#cb505-38" aria-hidden="true" tabindex="-1"></a>@abrahams90 [pp. 12; also @eijkhout91]</span>
+<span id="cb505-39"><a href="#cb505-39" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb505-40"><a href="#cb505-40" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb503"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb503-1"><a href="#cb503-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb506"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb506-1"><a href="#cb506-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -9075,12 +9167,12 @@ contain the following text:</p>
</blockquote>
<h4 data-number="2.3.1.6" id="code-block-renderers"><span
class="header-section-number">2.3.1.6</span> Code Block Renderers</h4>
-<p>The <code>\markdownRendererInputVerbatim</code> macro represents a
+<p>The <code>markdownRendererInputVerbatim</code> macro represents a
code block. The macro receives a single argument that corresponds to the
filename of a file containing the code block contents.</p>
-<p>The <code>\markdownRendererInputFencedCode</code> macro represents a
+<p>The <code>markdownRendererInputFencedCode</code> macro represents a
fenced code block. This macro will only be produced, when the
-<strong><code>fencedCode</code></strong> option is enabled. The macro
+<code><strong>fencedCode</strong></code> option is enabled. The macro
receives three arguments that correspond to the filename of a file
containing the code block contents, the fully escaped code fence
infostring that can be directly typeset, and the raw code fence
@@ -9089,110 +9181,110 @@ infostring that can be used outside typesetting.</p>
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb504"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb504-1"><a href="#cb504-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb504-2"><a href="#cb504-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">verbatim</span>}</span>
-<span id="cb504-3"><a href="#cb504-3" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[hyphens]{<span class="ex">url</span>}</span>
-<span id="cb504-4"><a href="#cb504-4" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[fencedCode]{<span class="ex">markdown</span>}</span>
-<span id="cb504-5"><a href="#cb504-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb504-6"><a href="#cb504-6" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb504-7"><a href="#cb504-7" aria-hidden="true" tabindex="-1"></a> interblockSeparator = {</span>
-<span id="cb504-8"><a href="#cb504-8" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span>
-<span id="cb504-9"><a href="#cb504-9" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
-<span id="cb504-10"><a href="#cb504-10" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span>
-<span id="cb504-11"><a href="#cb504-11" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span>
-<span id="cb504-12"><a href="#cb504-12" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
-<span id="cb504-13"><a href="#cb504-13" aria-hidden="true" tabindex="-1"></a> }<span class="co">%</span></span>
-<span id="cb504-14"><a href="#cb504-14" aria-hidden="true" tabindex="-1"></a> }<span class="co">%</span></span>
-<span id="cb504-15"><a href="#cb504-15" aria-hidden="true" tabindex="-1"></a> }<span class="co">%</span></span>
-<span id="cb504-16"><a href="#cb504-16" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb504-17"><a href="#cb504-17" aria-hidden="true" tabindex="-1"></a> inputVerbatim = {</span>
-<span id="cb504-18"><a href="#cb504-18" aria-hidden="true" tabindex="-1"></a> is contained in file <span class="fu">\url</span>{#1}:<span class="co">%</span></span>
-<span id="cb504-19"><a href="#cb504-19" aria-hidden="true" tabindex="-1"></a> <span class="fu">\verbatiminput</span>{#1}<span class="co">%</span></span>
-<span id="cb504-20"><a href="#cb504-20" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb504-21"><a href="#cb504-21" aria-hidden="true" tabindex="-1"></a> inputFencedCode = {</span>
-<span id="cb504-22"><a href="#cb504-22" aria-hidden="true" tabindex="-1"></a> in #2 <span class="fu">\markdownRendererInputVerbatim</span>{#1}<span class="co">%</span></span>
-<span id="cb504-23"><a href="#cb504-23" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb504-24"><a href="#cb504-24" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb504-25"><a href="#cb504-25" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb504-26"><a href="#cb504-26" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb504-27"><a href="#cb504-27" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb504-28"><a href="#cb504-28" aria-hidden="true" tabindex="-1"></a>The following code</span>
-<span id="cb504-29"><a href="#cb504-29" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb504-30"><a href="#cb504-30" aria-hidden="true" tabindex="-1"></a> def foo(bar):</span>
-<span id="cb504-31"><a href="#cb504-31" aria-hidden="true" tabindex="-1"></a> if len(bar) &lt;= 1:</span>
-<span id="cb504-32"><a href="#cb504-32" aria-hidden="true" tabindex="-1"></a> return bar[0]</span>
-<span id="cb504-33"><a href="#cb504-33" aria-hidden="true" tabindex="-1"></a> elif len(bar) == 2:</span>
-<span id="cb504-34"><a href="#cb504-34" aria-hidden="true" tabindex="-1"></a> return sorted(bar)</span>
-<span id="cb504-35"><a href="#cb504-35" aria-hidden="true" tabindex="-1"></a> else:</span>
-<span id="cb504-36"><a href="#cb504-36" aria-hidden="true" tabindex="-1"></a> baz = len(bar) // 2</span>
-<span id="cb504-37"><a href="#cb504-37" aria-hidden="true" tabindex="-1"></a> return foo(bar[baz:], bar[:baz])</span>
-<span id="cb504-38"><a href="#cb504-38" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb504-39"><a href="#cb504-39" aria-hidden="true" tabindex="-1"></a>The following code</span>
-<span id="cb504-40"><a href="#cb504-40" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb504-41"><a href="#cb504-41" aria-hidden="true" tabindex="-1"></a>~~~ Python</span>
-<span id="cb504-42"><a href="#cb504-42" aria-hidden="true" tabindex="-1"></a>&gt;&gt;&gt; foo([4, 2, 1, 3])</span>
-<span id="cb504-43"><a href="#cb504-43" aria-hidden="true" tabindex="-1"></a>[1, 2, 3, 4]</span>
-<span id="cb504-44"><a href="#cb504-44" aria-hidden="true" tabindex="-1"></a>~~~~~~~~~~</span>
-<span id="cb504-45"><a href="#cb504-45" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb504-46"><a href="#cb504-46" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb507"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb507-1"><a href="#cb507-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb507-2"><a href="#cb507-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">verbatim</span>}</span>
+<span id="cb507-3"><a href="#cb507-3" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[hyphens]{<span class="ex">url</span>}</span>
+<span id="cb507-4"><a href="#cb507-4" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[fencedCode]{<span class="ex">markdown</span>}</span>
+<span id="cb507-5"><a href="#cb507-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb507-6"><a href="#cb507-6" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb507-7"><a href="#cb507-7" aria-hidden="true" tabindex="-1"></a> interblockSeparator = {</span>
+<span id="cb507-8"><a href="#cb507-8" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span>
+<span id="cb507-9"><a href="#cb507-9" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
+<span id="cb507-10"><a href="#cb507-10" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span>
+<span id="cb507-11"><a href="#cb507-11" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span>
+<span id="cb507-12"><a href="#cb507-12" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
+<span id="cb507-13"><a href="#cb507-13" aria-hidden="true" tabindex="-1"></a> }<span class="co">%</span></span>
+<span id="cb507-14"><a href="#cb507-14" aria-hidden="true" tabindex="-1"></a> }<span class="co">%</span></span>
+<span id="cb507-15"><a href="#cb507-15" aria-hidden="true" tabindex="-1"></a> }<span class="co">%</span></span>
+<span id="cb507-16"><a href="#cb507-16" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb507-17"><a href="#cb507-17" aria-hidden="true" tabindex="-1"></a> inputVerbatim = {</span>
+<span id="cb507-18"><a href="#cb507-18" aria-hidden="true" tabindex="-1"></a> is contained in file <span class="fu">\url</span>{#1}:<span class="co">%</span></span>
+<span id="cb507-19"><a href="#cb507-19" aria-hidden="true" tabindex="-1"></a> <span class="fu">\verbatiminput</span>{#1}<span class="co">%</span></span>
+<span id="cb507-20"><a href="#cb507-20" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb507-21"><a href="#cb507-21" aria-hidden="true" tabindex="-1"></a> inputFencedCode = {</span>
+<span id="cb507-22"><a href="#cb507-22" aria-hidden="true" tabindex="-1"></a> in #2 <span class="fu">\markdownRendererInputVerbatim</span>{#1}<span class="co">%</span></span>
+<span id="cb507-23"><a href="#cb507-23" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb507-24"><a href="#cb507-24" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb507-25"><a href="#cb507-25" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb507-26"><a href="#cb507-26" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb507-27"><a href="#cb507-27" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb507-28"><a href="#cb507-28" aria-hidden="true" tabindex="-1"></a>The following code</span>
+<span id="cb507-29"><a href="#cb507-29" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb507-30"><a href="#cb507-30" aria-hidden="true" tabindex="-1"></a> def foo(bar):</span>
+<span id="cb507-31"><a href="#cb507-31" aria-hidden="true" tabindex="-1"></a> if len(bar) &lt;= 1:</span>
+<span id="cb507-32"><a href="#cb507-32" aria-hidden="true" tabindex="-1"></a> return bar[0]</span>
+<span id="cb507-33"><a href="#cb507-33" aria-hidden="true" tabindex="-1"></a> elif len(bar) == 2:</span>
+<span id="cb507-34"><a href="#cb507-34" aria-hidden="true" tabindex="-1"></a> return sorted(bar)</span>
+<span id="cb507-35"><a href="#cb507-35" aria-hidden="true" tabindex="-1"></a> else:</span>
+<span id="cb507-36"><a href="#cb507-36" aria-hidden="true" tabindex="-1"></a> baz = len(bar) // 2</span>
+<span id="cb507-37"><a href="#cb507-37" aria-hidden="true" tabindex="-1"></a> return foo(bar[baz:], bar[:baz])</span>
+<span id="cb507-38"><a href="#cb507-38" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb507-39"><a href="#cb507-39" aria-hidden="true" tabindex="-1"></a>The following code</span>
+<span id="cb507-40"><a href="#cb507-40" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb507-41"><a href="#cb507-41" aria-hidden="true" tabindex="-1"></a>~~~ Python</span>
+<span id="cb507-42"><a href="#cb507-42" aria-hidden="true" tabindex="-1"></a>&gt;&gt;&gt; foo([4, 2, 1, 3])</span>
+<span id="cb507-43"><a href="#cb507-43" aria-hidden="true" tabindex="-1"></a>[1, 2, 3, 4]</span>
+<span id="cb507-44"><a href="#cb507-44" aria-hidden="true" tabindex="-1"></a>~~~~~~~~~~</span>
+<span id="cb507-45"><a href="#cb507-45" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb507-46"><a href="#cb507-46" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb505"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb505-1"><a href="#cb505-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb508"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb508-1"><a href="#cb508-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text except for the filename, which may
differ:</p>
<blockquote>
<p>The following code is contained in file
<code>./_markdown_document/882453149edcf288976647f6fe147ada.verbatim</code>:</p>
-<div class="sourceCode" id="cb506"><pre
-class="sourceCode py"><code class="sourceCode python"><span id="cb506-1"><a href="#cb506-1" aria-hidden="true" tabindex="-1"></a><span class="kw">def</span> foo(bar):</span>
-<span id="cb506-2"><a href="#cb506-2" aria-hidden="true" tabindex="-1"></a> <span class="cf">if</span> <span class="bu">len</span>(bar) <span class="op">&lt;=</span> <span class="dv">1</span>:</span>
-<span id="cb506-3"><a href="#cb506-3" aria-hidden="true" tabindex="-1"></a> <span class="cf">return</span> bar[:<span class="dv">1</span>]</span>
-<span id="cb506-4"><a href="#cb506-4" aria-hidden="true" tabindex="-1"></a> <span class="cf">elif</span> <span class="bu">len</span>(bar) <span class="op">==</span> <span class="dv">2</span>:</span>
-<span id="cb506-5"><a href="#cb506-5" aria-hidden="true" tabindex="-1"></a> <span class="cf">return</span> <span class="bu">sorted</span>(bar)</span>
-<span id="cb506-6"><a href="#cb506-6" aria-hidden="true" tabindex="-1"></a> <span class="cf">else</span>:</span>
-<span id="cb506-7"><a href="#cb506-7" aria-hidden="true" tabindex="-1"></a> baz <span class="op">=</span> bar[<span class="bu">len</span>(bar) <span class="op">//</span> <span class="dv">2</span>]</span>
-<span id="cb506-8"><a href="#cb506-8" aria-hidden="true" tabindex="-1"></a> <span class="cf">return</span> (</span>
-<span id="cb506-9"><a href="#cb506-9" aria-hidden="true" tabindex="-1"></a> foo([qux <span class="cf">for</span> qux <span class="kw">in</span> bar <span class="cf">if</span> qux <span class="op">&lt;</span> baz]) <span class="op">+</span> [baz] <span class="op">+</span></span>
-<span id="cb506-10"><a href="#cb506-10" aria-hidden="true" tabindex="-1"></a> foo([qux <span class="cf">for</span> qux <span class="kw">in</span> bar <span class="cf">if</span> qux <span class="op">&gt;</span> baz])</span>
-<span id="cb506-11"><a href="#cb506-11" aria-hidden="true" tabindex="-1"></a> )</span></code></pre></div>
+<div class="sourceCode" id="cb509"><pre
+class="sourceCode py"><code class="sourceCode python"><span id="cb509-1"><a href="#cb509-1" aria-hidden="true" tabindex="-1"></a><span class="kw">def</span> foo(bar):</span>
+<span id="cb509-2"><a href="#cb509-2" aria-hidden="true" tabindex="-1"></a> <span class="cf">if</span> <span class="bu">len</span>(bar) <span class="op">&lt;=</span> <span class="dv">1</span>:</span>
+<span id="cb509-3"><a href="#cb509-3" aria-hidden="true" tabindex="-1"></a> <span class="cf">return</span> bar[:<span class="dv">1</span>]</span>
+<span id="cb509-4"><a href="#cb509-4" aria-hidden="true" tabindex="-1"></a> <span class="cf">elif</span> <span class="bu">len</span>(bar) <span class="op">==</span> <span class="dv">2</span>:</span>
+<span id="cb509-5"><a href="#cb509-5" aria-hidden="true" tabindex="-1"></a> <span class="cf">return</span> <span class="bu">sorted</span>(bar)</span>
+<span id="cb509-6"><a href="#cb509-6" aria-hidden="true" tabindex="-1"></a> <span class="cf">else</span>:</span>
+<span id="cb509-7"><a href="#cb509-7" aria-hidden="true" tabindex="-1"></a> baz <span class="op">=</span> bar[<span class="bu">len</span>(bar) <span class="op">//</span> <span class="dv">2</span>]</span>
+<span id="cb509-8"><a href="#cb509-8" aria-hidden="true" tabindex="-1"></a> <span class="cf">return</span> (</span>
+<span id="cb509-9"><a href="#cb509-9" aria-hidden="true" tabindex="-1"></a> foo([qux <span class="cf">for</span> qux <span class="kw">in</span> bar <span class="cf">if</span> qux <span class="op">&lt;</span> baz]) <span class="op">+</span> [baz] <span class="op">+</span></span>
+<span id="cb509-10"><a href="#cb509-10" aria-hidden="true" tabindex="-1"></a> foo([qux <span class="cf">for</span> qux <span class="kw">in</span> bar <span class="cf">if</span> qux <span class="op">&gt;</span> baz])</span>
+<span id="cb509-11"><a href="#cb509-11" aria-hidden="true" tabindex="-1"></a> )</span></code></pre></div>
<p>The following code in Python contained in file
<code>./_markdown_document/cf2a96e2120cef5b1fae5fea36fcc27b.verbatim</code>:</p>
-<div class="sourceCode" id="cb507"><pre
-class="sourceCode py"><code class="sourceCode python"><span id="cb507-1"><a href="#cb507-1" aria-hidden="true" tabindex="-1"></a><span class="op">&gt;&gt;&gt;</span> foo([<span class="dv">4</span>, <span class="dv">2</span>, <span class="dv">1</span>, <span class="dv">3</span>])</span>
-<span id="cb507-2"><a href="#cb507-2" aria-hidden="true" tabindex="-1"></a>[<span class="dv">1</span>, <span class="dv">2</span>, <span class="dv">3</span>, <span class="dv">4</span>]</span></code></pre></div>
+<div class="sourceCode" id="cb510"><pre
+class="sourceCode py"><code class="sourceCode python"><span id="cb510-1"><a href="#cb510-1" aria-hidden="true" tabindex="-1"></a><span class="op">&gt;&gt;&gt;</span> foo([<span class="dv">4</span>, <span class="dv">2</span>, <span class="dv">1</span>, <span class="dv">3</span>])</span>
+<span id="cb510-2"><a href="#cb510-2" aria-hidden="true" tabindex="-1"></a>[<span class="dv">1</span>, <span class="dv">2</span>, <span class="dv">3</span>, <span class="dv">4</span>]</span></code></pre></div>
</blockquote>
<h4 data-number="2.3.1.7" id="code-span-renderer"><span
class="header-section-number">2.3.1.7</span> Code Span Renderer</h4>
-<p>The <code>\markdownRendererCodeSpan</code> macro represents inline
+<p>The <code>markdownRendererCodeSpan</code> macro represents inline
code span in the input text. It receives a single argument that
corresponds to the inline code span.</p>
<h5 class="unnumbered" id="plain-tex-example-27">Plain <span
class="tex">T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb508"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb508-1"><a href="#cb508-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
-<span id="cb508-2"><a href="#cb508-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> lmfonts</span>
-<span id="cb508-3"><a href="#cb508-3" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb508-4"><a href="#cb508-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererCodeSpan</span>#1{#1}</span>
-<span id="cb508-5"><a href="#cb508-5" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb508-6"><a href="#cb508-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
-<span id="cb508-7"><a href="#cb508-7" aria-hidden="true" tabindex="-1"></a>`<span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span>`</span>
-<span id="cb508-8"><a href="#cb508-8" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb508-9"><a href="#cb508-9" aria-hidden="true" tabindex="-1"></a><span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span></span>
-<span id="cb508-10"><a href="#cb508-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
-<span id="cb508-11"><a href="#cb508-11" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb508-12"><a href="#cb508-12" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionHybrid</span>{true}</span>
-<span id="cb508-13"><a href="#cb508-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
-<span id="cb508-14"><a href="#cb508-14" aria-hidden="true" tabindex="-1"></a><span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span></span>
-<span id="cb508-15"><a href="#cb508-15" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
-<span id="cb508-16"><a href="#cb508-16" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb508-17"><a href="#cb508-17" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb511"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb511-1"><a href="#cb511-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
+<span id="cb511-2"><a href="#cb511-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> lmfonts</span>
+<span id="cb511-3"><a href="#cb511-3" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb511-4"><a href="#cb511-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererCodeSpan</span>#1{#1}</span>
+<span id="cb511-5"><a href="#cb511-5" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb511-6"><a href="#cb511-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
+<span id="cb511-7"><a href="#cb511-7" aria-hidden="true" tabindex="-1"></a>`<span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span>`</span>
+<span id="cb511-8"><a href="#cb511-8" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb511-9"><a href="#cb511-9" aria-hidden="true" tabindex="-1"></a><span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span></span>
+<span id="cb511-10"><a href="#cb511-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
+<span id="cb511-11"><a href="#cb511-11" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb511-12"><a href="#cb511-12" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionHybrid</span>{true}</span>
+<span id="cb511-13"><a href="#cb511-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
+<span id="cb511-14"><a href="#cb511-14" aria-hidden="true" tabindex="-1"></a><span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span></span>
+<span id="cb511-15"><a href="#cb511-15" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
+<span id="cb511-16"><a href="#cb511-16" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb511-17"><a href="#cb511-17" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb509"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb509-1"><a href="#cb509-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb512"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb512-1"><a href="#cb512-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -9205,30 +9297,30 @@ contain the following text:</p>
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb510"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb510-1"><a href="#cb510-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb510-2"><a href="#cb510-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[smartEllipses]{<span class="ex">markdown</span>}</span>
-<span id="cb510-3"><a href="#cb510-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb510-4"><a href="#cb510-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb510-5"><a href="#cb510-5" aria-hidden="true" tabindex="-1"></a> codeSpan = {#1},</span>
-<span id="cb510-6"><a href="#cb510-6" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb510-7"><a href="#cb510-7" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb510-8"><a href="#cb510-8" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb510-9"><a href="#cb510-9" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb510-10"><a href="#cb510-10" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb510-11"><a href="#cb510-11" aria-hidden="true" tabindex="-1"></a>`<span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span>`</span>
-<span id="cb510-12"><a href="#cb510-12" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb510-13"><a href="#cb510-13" aria-hidden="true" tabindex="-1"></a><span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span></span>
-<span id="cb510-14"><a href="#cb510-14" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb510-15"><a href="#cb510-15" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb510-16"><a href="#cb510-16" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}[hybrid]</span>
-<span id="cb510-17"><a href="#cb510-17" aria-hidden="true" tabindex="-1"></a><span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span></span>
-<span id="cb510-18"><a href="#cb510-18" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb510-19"><a href="#cb510-19" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb510-20"><a href="#cb510-20" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb513"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb513-1"><a href="#cb513-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb513-2"><a href="#cb513-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[smartEllipses]{<span class="ex">markdown</span>}</span>
+<span id="cb513-3"><a href="#cb513-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb513-4"><a href="#cb513-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb513-5"><a href="#cb513-5" aria-hidden="true" tabindex="-1"></a> codeSpan = {#1},</span>
+<span id="cb513-6"><a href="#cb513-6" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb513-7"><a href="#cb513-7" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb513-8"><a href="#cb513-8" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb513-9"><a href="#cb513-9" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb513-10"><a href="#cb513-10" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb513-11"><a href="#cb513-11" aria-hidden="true" tabindex="-1"></a>`<span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span>`</span>
+<span id="cb513-12"><a href="#cb513-12" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb513-13"><a href="#cb513-13" aria-hidden="true" tabindex="-1"></a><span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span></span>
+<span id="cb513-14"><a href="#cb513-14" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb513-15"><a href="#cb513-15" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb513-16"><a href="#cb513-16" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}[hybrid]</span>
+<span id="cb513-17"><a href="#cb513-17" aria-hidden="true" tabindex="-1"></a><span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span></span>
+<span id="cb513-18"><a href="#cb513-18" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb513-19"><a href="#cb513-19" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb513-20"><a href="#cb513-20" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb511"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb511-1"><a href="#cb511-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb514"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb514-1"><a href="#cb514-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -9241,26 +9333,26 @@ contain the following text:</p>
class="tex">T<sub>e</sub>X</span>t Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb512"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb512-1"><a href="#cb512-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
-<span id="cb512-2"><a href="#cb512-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererCodeSpan</span>#1{#1}</span>
-<span id="cb512-3"><a href="#cb512-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
-<span id="cb512-4"><a href="#cb512-4" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb512-5"><a href="#cb512-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb512-6"><a href="#cb512-6" aria-hidden="true" tabindex="-1"></a>`<span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span>`</span>
-<span id="cb512-7"><a href="#cb512-7" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb512-8"><a href="#cb512-8" aria-hidden="true" tabindex="-1"></a><span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span></span>
-<span id="cb512-9"><a href="#cb512-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb512-10"><a href="#cb512-10" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb512-11"><a href="#cb512-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[hybrid = yes]</span>
-<span id="cb512-12"><a href="#cb512-12" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb512-13"><a href="#cb512-13" aria-hidden="true" tabindex="-1"></a><span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span></span>
-<span id="cb512-14"><a href="#cb512-14" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb512-15"><a href="#cb512-15" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb512-16"><a href="#cb512-16" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb515"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb515-1"><a href="#cb515-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
+<span id="cb515-2"><a href="#cb515-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererCodeSpan</span>#1{#1}</span>
+<span id="cb515-3"><a href="#cb515-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
+<span id="cb515-4"><a href="#cb515-4" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb515-5"><a href="#cb515-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb515-6"><a href="#cb515-6" aria-hidden="true" tabindex="-1"></a>`<span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span>`</span>
+<span id="cb515-7"><a href="#cb515-7" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb515-8"><a href="#cb515-8" aria-hidden="true" tabindex="-1"></a><span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span></span>
+<span id="cb515-9"><a href="#cb515-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb515-10"><a href="#cb515-10" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb515-11"><a href="#cb515-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[hybrid = yes]</span>
+<span id="cb515-12"><a href="#cb515-12" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb515-13"><a href="#cb515-13" aria-hidden="true" tabindex="-1"></a><span class="ss">$</span><span class="sc">\sqrt</span><span class="ss">{-1}$</span> *equals* <span class="ss">$i$</span></span>
+<span id="cb515-14"><a href="#cb515-14" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb515-15"><a href="#cb515-15" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb515-16"><a href="#cb515-16" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb513"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb513-1"><a href="#cb513-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb516"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb516-1"><a href="#cb516-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -9274,36 +9366,36 @@ id="code-span-attribute-context-renderers"><span
class="header-section-number">2.3.1.8</span> Code Span Attribute Context
Renderers</h4>
<p>The following macros are only produced, when the
-<strong><code>inlineCodeAttributes</code></strong> option is
+<code><strong>inlineCodeAttributes</strong></code> option is
enabled.</p>
-<p>The <code>\markdownRendererCodeSpanAttributeContextBegin</code> and
-<code>\markdownRendererCodeSpanAttributeContextEnd</code> macros
+<p>The <code>markdownRendererCodeSpanAttributeContextBegin</code> and
+<code>markdownRendererCodeSpanAttributeContextEnd</code> macros
represent the beginning and the end of a context in which the attributes
of an inline code span apply. The macros receive no arguments.</p>
<h5 class="unnumbered" id="latex-example-64"><span
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb514"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb514-1"><a href="#cb514-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb514-2"><a href="#cb514-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[inlineCodeAttributes]{<span class="ex">markdown</span>}</span>
-<span id="cb514-3"><a href="#cb514-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb514-4"><a href="#cb514-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb514-5"><a href="#cb514-5" aria-hidden="true" tabindex="-1"></a> codeSpanAttributeContextBegin = {(},</span>
-<span id="cb514-6"><a href="#cb514-6" aria-hidden="true" tabindex="-1"></a> codeSpan = {#1},</span>
-<span id="cb514-7"><a href="#cb514-7" aria-hidden="true" tabindex="-1"></a> codeSpanAttributeContextEnd = {)},</span>
-<span id="cb514-8"><a href="#cb514-8" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb514-9"><a href="#cb514-9" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb514-10"><a href="#cb514-10" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb514-11"><a href="#cb514-11" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb514-12"><a href="#cb514-12" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb514-13"><a href="#cb514-13" aria-hidden="true" tabindex="-1"></a>foo `bar`{key=value} baz</span>
-<span id="cb514-14"><a href="#cb514-14" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb514-15"><a href="#cb514-15" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb514-16"><a href="#cb514-16" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb517"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb517-1"><a href="#cb517-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb517-2"><a href="#cb517-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[inlineCodeAttributes]{<span class="ex">markdown</span>}</span>
+<span id="cb517-3"><a href="#cb517-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb517-4"><a href="#cb517-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb517-5"><a href="#cb517-5" aria-hidden="true" tabindex="-1"></a> codeSpanAttributeContextBegin = {(},</span>
+<span id="cb517-6"><a href="#cb517-6" aria-hidden="true" tabindex="-1"></a> codeSpan = {#1},</span>
+<span id="cb517-7"><a href="#cb517-7" aria-hidden="true" tabindex="-1"></a> codeSpanAttributeContextEnd = {)},</span>
+<span id="cb517-8"><a href="#cb517-8" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb517-9"><a href="#cb517-9" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb517-10"><a href="#cb517-10" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb517-11"><a href="#cb517-11" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb517-12"><a href="#cb517-12" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb517-13"><a href="#cb517-13" aria-hidden="true" tabindex="-1"></a>foo `bar`{key=value} baz</span>
+<span id="cb517-14"><a href="#cb517-14" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb517-15"><a href="#cb517-15" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb517-16"><a href="#cb517-16" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb515"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb515-1"><a href="#cb515-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb518"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb518-1"><a href="#cb518-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -9312,21 +9404,21 @@ contain the following text:</p>
<h4 data-number="2.3.1.9" id="texcontentblockrenderers"><span
class="header-section-number">2.3.1.9</span> Content Block
Renderers</h4>
-<p>The <code>\markdownRendererContentBlock</code> macro represents an
+<p>The <code>markdownRendererContentBlock</code> macro represents an
iA Writer content block. It receives four arguments: the local file or
online image filename extension cast to the lower case, the fully
escaped <abbr>uri</abbr> that can be directly typeset, the raw
<abbr>uri</abbr> that can be used outside typesetting, and the title of
the content block.</p>
-<p>The <code>\markdownRendererContentBlockOnlineImage</code> macro
+<p>The <code>markdownRendererContentBlockOnlineImage</code> macro
represents an iA Writer online image content block. The macro receives
-the same arguments as <code>\markdownRendererContentBlock</code>.</p>
-<p>The <code>\markdownRendererContentBlockCode</code> macro represents
-an iA Writer content block that was recognized as a file in a known
+the same arguments as <code>markdownRendererContentBlock</code>.</p>
+<p>The <code>markdownRendererContentBlockCode</code> macro represents an
+iA Writer content block that was recognized as a file in a known
programming language by its filename extension <span
class="math inline"><em>s</em></span>. If any
<code>markdown-languages.json</code> file found by
-<strong><code>kpathsea</code></strong><a href="#fn3"
+<code><strong>kpathsea</strong></code><a href="#fn3"
class="footnote-ref" id="fnref3" role="doc-noteref"><sup>3</sup></a>
contains a record <span
class="math inline">(<em>k</em>,<em>v</em>)</span>, then a
@@ -9354,34 +9446,34 @@ starting point.</p>
class="tex">T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb516"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb516-1"><a href="#cb516-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
-<span id="cb516-2"><a href="#cb516-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionContentBlocks</span>{true}</span>
-<span id="cb516-3"><a href="#cb516-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererContentBlock</span>#1#2#3#4{<span class="co">%</span></span>
-<span id="cb516-4"><a href="#cb516-4" aria-hidden="true" tabindex="-1"></a> This is {<span class="fu">\tt</span> #2}, #4.</span>
-<span id="cb516-5"><a href="#cb516-5" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb516-6"><a href="#cb516-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererContentBlockOnlineImage</span>#1#2#3#4{<span class="co">%</span></span>
-<span id="cb516-7"><a href="#cb516-7" aria-hidden="true" tabindex="-1"></a> This is the image {<span class="fu">\tt</span> #2}, #4.</span>
-<span id="cb516-8"><a href="#cb516-8" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb516-9"><a href="#cb516-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererContentBlockCode</span>#1#2#3#4#5{<span class="co">%</span></span>
-<span id="cb516-10"><a href="#cb516-10" aria-hidden="true" tabindex="-1"></a> This is the #2 (<span class="fu">\uppercase</span>{#1}) document {<span class="fu">\tt</span> #3}, #5.</span>
-<span id="cb516-11"><a href="#cb516-11" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb516-12"><a href="#cb516-12" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
-<span id="cb516-13"><a href="#cb516-13" aria-hidden="true" tabindex="-1"></a>/document.tex (the document that we are currently typesetting)</span>
-<span id="cb516-14"><a href="#cb516-14" aria-hidden="true" tabindex="-1"></a>/markdown-languages.json (the mapping between filename extensions</span>
-<span id="cb516-15"><a href="#cb516-15" aria-hidden="true" tabindex="-1"></a> and programming language names)</span>
-<span id="cb516-16"><a href="#cb516-16" aria-hidden="true" tabindex="-1"></a>https://tug.org/tugboat/noword.jpg (the logotype of TUGboat)</span>
-<span id="cb516-17"><a href="#cb516-17" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
-<span id="cb516-18"><a href="#cb516-18" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb519"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb519-1"><a href="#cb519-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
+<span id="cb519-2"><a href="#cb519-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionContentBlocks</span>{true}</span>
+<span id="cb519-3"><a href="#cb519-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererContentBlock</span>#1#2#3#4{<span class="co">%</span></span>
+<span id="cb519-4"><a href="#cb519-4" aria-hidden="true" tabindex="-1"></a> This is {<span class="fu">\tt</span> #2}, #4.</span>
+<span id="cb519-5"><a href="#cb519-5" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb519-6"><a href="#cb519-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererContentBlockOnlineImage</span>#1#2#3#4{<span class="co">%</span></span>
+<span id="cb519-7"><a href="#cb519-7" aria-hidden="true" tabindex="-1"></a> This is the image {<span class="fu">\tt</span> #2}, #4.</span>
+<span id="cb519-8"><a href="#cb519-8" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb519-9"><a href="#cb519-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererContentBlockCode</span>#1#2#3#4#5{<span class="co">%</span></span>
+<span id="cb519-10"><a href="#cb519-10" aria-hidden="true" tabindex="-1"></a> This is the #2 (<span class="fu">\uppercase</span>{#1}) document {<span class="fu">\tt</span> #3}, #5.</span>
+<span id="cb519-11"><a href="#cb519-11" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb519-12"><a href="#cb519-12" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
+<span id="cb519-13"><a href="#cb519-13" aria-hidden="true" tabindex="-1"></a>/document.tex (the document that we are currently typesetting)</span>
+<span id="cb519-14"><a href="#cb519-14" aria-hidden="true" tabindex="-1"></a>/markdown-languages.json (the mapping between filename extensions</span>
+<span id="cb519-15"><a href="#cb519-15" aria-hidden="true" tabindex="-1"></a> and programming language names)</span>
+<span id="cb519-16"><a href="#cb519-16" aria-hidden="true" tabindex="-1"></a>https://tug.org/tugboat/noword.jpg (the logotype of TUGboat)</span>
+<span id="cb519-17"><a href="#cb519-17" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
+<span id="cb519-18"><a href="#cb519-18" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Create also a text document named
<code>markdown-languages.json</code> with the following content:</p>
-<div class="sourceCode" id="cb517"><pre
-class="sourceCode js"><code class="sourceCode javascript"><span id="cb517-1"><a href="#cb517-1" aria-hidden="true" tabindex="-1"></a>{</span>
-<span id="cb517-2"><a href="#cb517-2" aria-hidden="true" tabindex="-1"></a> <span class="st">&quot;json&quot;</span><span class="op">:</span> <span class="st">&quot;JavaScript Object Notation&quot;</span><span class="op">,</span></span>
-<span id="cb517-3"><a href="#cb517-3" aria-hidden="true" tabindex="-1"></a>}</span></code></pre></div>
+<div class="sourceCode" id="cb520"><pre
+class="sourceCode js"><code class="sourceCode javascript"><span id="cb520-1"><a href="#cb520-1" aria-hidden="true" tabindex="-1"></a>{</span>
+<span id="cb520-2"><a href="#cb520-2" aria-hidden="true" tabindex="-1"></a> <span class="st">&quot;json&quot;</span><span class="op">:</span> <span class="st">&quot;JavaScript Object Notation&quot;</span><span class="op">,</span></span>
+<span id="cb520-3"><a href="#cb520-3" aria-hidden="true" tabindex="-1"></a>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb518"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb518-1"><a href="#cb518-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb521"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb521-1"><a href="#cb521-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -9397,34 +9489,34 @@ the logotype of TUGboat.</p>
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb519"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb519-1"><a href="#cb519-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb519-2"><a href="#cb519-2" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">filecontents</span>}[overwrite,nosearch,noheader]{markdown-languages.json}</span>
-<span id="cb519-3"><a href="#cb519-3" aria-hidden="true" tabindex="-1"></a>{</span>
-<span id="cb519-4"><a href="#cb519-4" aria-hidden="true" tabindex="-1"></a> &quot;json&quot;: &quot;JavaScript Object Notation&quot;,</span>
-<span id="cb519-5"><a href="#cb519-5" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb519-6"><a href="#cb519-6" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">filecontents</span>}</span>
-<span id="cb519-7"><a href="#cb519-7" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[contentBlocks]{<span class="ex">markdown</span>}</span>
-<span id="cb519-8"><a href="#cb519-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb519-9"><a href="#cb519-9" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb519-10"><a href="#cb519-10" aria-hidden="true" tabindex="-1"></a> contentBlock = {This is <span class="fu">\texttt</span>{#2}, #4.},</span>
-<span id="cb519-11"><a href="#cb519-11" aria-hidden="true" tabindex="-1"></a> contentBlockOnlineImage = {This is the image <span class="fu">\texttt</span>{#2}, #4.},</span>
-<span id="cb519-12"><a href="#cb519-12" aria-hidden="true" tabindex="-1"></a> contentBlockCode = {<span class="co">%</span></span>
-<span id="cb519-13"><a href="#cb519-13" aria-hidden="true" tabindex="-1"></a> This is the #2 (<span class="fu">\MakeUppercase</span>{#1}) document <span class="fu">\texttt</span>{#3}, #5.</span>
-<span id="cb519-14"><a href="#cb519-14" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb519-15"><a href="#cb519-15" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb519-16"><a href="#cb519-16" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb519-17"><a href="#cb519-17" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb519-18"><a href="#cb519-18" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb519-19"><a href="#cb519-19" aria-hidden="true" tabindex="-1"></a>/document.tex (the document that we are currently typesetting)</span>
-<span id="cb519-20"><a href="#cb519-20" aria-hidden="true" tabindex="-1"></a>/markdown-languages.json (the mapping between filename extensions</span>
-<span id="cb519-21"><a href="#cb519-21" aria-hidden="true" tabindex="-1"></a> and programming language names)</span>
-<span id="cb519-22"><a href="#cb519-22" aria-hidden="true" tabindex="-1"></a>https://tug.org/tugboat/noword.jpg (the logotype of TUGboat)</span>
-<span id="cb519-23"><a href="#cb519-23" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb519-24"><a href="#cb519-24" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb522"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb522-1"><a href="#cb522-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb522-2"><a href="#cb522-2" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">filecontents</span>}[overwrite,nosearch,noheader]{markdown-languages.json}</span>
+<span id="cb522-3"><a href="#cb522-3" aria-hidden="true" tabindex="-1"></a>{</span>
+<span id="cb522-4"><a href="#cb522-4" aria-hidden="true" tabindex="-1"></a> &quot;json&quot;: &quot;JavaScript Object Notation&quot;,</span>
+<span id="cb522-5"><a href="#cb522-5" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb522-6"><a href="#cb522-6" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">filecontents</span>}</span>
+<span id="cb522-7"><a href="#cb522-7" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[contentBlocks]{<span class="ex">markdown</span>}</span>
+<span id="cb522-8"><a href="#cb522-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb522-9"><a href="#cb522-9" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb522-10"><a href="#cb522-10" aria-hidden="true" tabindex="-1"></a> contentBlock = {This is <span class="fu">\texttt</span>{#2}, #4.},</span>
+<span id="cb522-11"><a href="#cb522-11" aria-hidden="true" tabindex="-1"></a> contentBlockOnlineImage = {This is the image <span class="fu">\texttt</span>{#2}, #4.},</span>
+<span id="cb522-12"><a href="#cb522-12" aria-hidden="true" tabindex="-1"></a> contentBlockCode = {<span class="co">%</span></span>
+<span id="cb522-13"><a href="#cb522-13" aria-hidden="true" tabindex="-1"></a> This is the #2 (<span class="fu">\MakeUppercase</span>{#1}) document <span class="fu">\texttt</span>{#3}, #5.</span>
+<span id="cb522-14"><a href="#cb522-14" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb522-15"><a href="#cb522-15" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb522-16"><a href="#cb522-16" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb522-17"><a href="#cb522-17" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb522-18"><a href="#cb522-18" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb522-19"><a href="#cb522-19" aria-hidden="true" tabindex="-1"></a>/document.tex (the document that we are currently typesetting)</span>
+<span id="cb522-20"><a href="#cb522-20" aria-hidden="true" tabindex="-1"></a>/markdown-languages.json (the mapping between filename extensions</span>
+<span id="cb522-21"><a href="#cb522-21" aria-hidden="true" tabindex="-1"></a> and programming language names)</span>
+<span id="cb522-22"><a href="#cb522-22" aria-hidden="true" tabindex="-1"></a>https://tug.org/tugboat/noword.jpg (the logotype of TUGboat)</span>
+<span id="cb522-23"><a href="#cb522-23" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb522-24"><a href="#cb522-24" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb520"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb520-1"><a href="#cb520-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb523"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb523-1"><a href="#cb523-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -9440,35 +9532,35 @@ the logotype of TUGboat.</p>
class="tex">T<sub>e</sub>X</span>t Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb521"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb521-1"><a href="#cb521-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
-<span id="cb521-2"><a href="#cb521-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[contentBlocks = yes]</span>
-<span id="cb521-3"><a href="#cb521-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererContentBlock</span>#1#2#3#4{<span class="co">%</span></span>
-<span id="cb521-4"><a href="#cb521-4" aria-hidden="true" tabindex="-1"></a> This is {<span class="fu">\tt</span> #2}, #4.</span>
-<span id="cb521-5"><a href="#cb521-5" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb521-6"><a href="#cb521-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererContentBlockOnlineImage</span>#1#2#3#4{<span class="co">%</span></span>
-<span id="cb521-7"><a href="#cb521-7" aria-hidden="true" tabindex="-1"></a> This is the image {<span class="fu">\tt</span> #2}, #4.</span>
-<span id="cb521-8"><a href="#cb521-8" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb521-9"><a href="#cb521-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererContentBlockCode</span>#1#2#3#4#5{<span class="co">%</span></span>
-<span id="cb521-10"><a href="#cb521-10" aria-hidden="true" tabindex="-1"></a> This is the #2 (<span class="fu">\uppercase</span>{#1}) document {<span class="fu">\tt</span> #3}, #5.</span>
-<span id="cb521-11"><a href="#cb521-11" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb521-12"><a href="#cb521-12" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
-<span id="cb521-13"><a href="#cb521-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb521-14"><a href="#cb521-14" aria-hidden="true" tabindex="-1"></a>/document.tex (the document that we are currently typesetting)</span>
-<span id="cb521-15"><a href="#cb521-15" aria-hidden="true" tabindex="-1"></a>/markdown-languages.json (the mapping between filename extensions</span>
-<span id="cb521-16"><a href="#cb521-16" aria-hidden="true" tabindex="-1"></a> and programming language names)</span>
-<span id="cb521-17"><a href="#cb521-17" aria-hidden="true" tabindex="-1"></a>https://tug.org/tugboat/noword.jpg (the logotype of TUGboat)</span>
-<span id="cb521-18"><a href="#cb521-18" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb521-19"><a href="#cb521-19" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
+<div class="sourceCode" id="cb524"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb524-1"><a href="#cb524-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
+<span id="cb524-2"><a href="#cb524-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[contentBlocks = yes]</span>
+<span id="cb524-3"><a href="#cb524-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererContentBlock</span>#1#2#3#4{<span class="co">%</span></span>
+<span id="cb524-4"><a href="#cb524-4" aria-hidden="true" tabindex="-1"></a> This is {<span class="fu">\tt</span> #2}, #4.</span>
+<span id="cb524-5"><a href="#cb524-5" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb524-6"><a href="#cb524-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererContentBlockOnlineImage</span>#1#2#3#4{<span class="co">%</span></span>
+<span id="cb524-7"><a href="#cb524-7" aria-hidden="true" tabindex="-1"></a> This is the image {<span class="fu">\tt</span> #2}, #4.</span>
+<span id="cb524-8"><a href="#cb524-8" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb524-9"><a href="#cb524-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererContentBlockCode</span>#1#2#3#4#5{<span class="co">%</span></span>
+<span id="cb524-10"><a href="#cb524-10" aria-hidden="true" tabindex="-1"></a> This is the #2 (<span class="fu">\uppercase</span>{#1}) document {<span class="fu">\tt</span> #3}, #5.</span>
+<span id="cb524-11"><a href="#cb524-11" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb524-12"><a href="#cb524-12" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
+<span id="cb524-13"><a href="#cb524-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb524-14"><a href="#cb524-14" aria-hidden="true" tabindex="-1"></a>/document.tex (the document that we are currently typesetting)</span>
+<span id="cb524-15"><a href="#cb524-15" aria-hidden="true" tabindex="-1"></a>/markdown-languages.json (the mapping between filename extensions</span>
+<span id="cb524-16"><a href="#cb524-16" aria-hidden="true" tabindex="-1"></a> and programming language names)</span>
+<span id="cb524-17"><a href="#cb524-17" aria-hidden="true" tabindex="-1"></a>https://tug.org/tugboat/noword.jpg (the logotype of TUGboat)</span>
+<span id="cb524-18"><a href="#cb524-18" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb524-19"><a href="#cb524-19" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
<p>Create also a text document named
<code>markdown-languages.json</code> with the following content:</p>
-<div class="sourceCode" id="cb522"><pre
-class="sourceCode js"><code class="sourceCode javascript"><span id="cb522-1"><a href="#cb522-1" aria-hidden="true" tabindex="-1"></a>{</span>
-<span id="cb522-2"><a href="#cb522-2" aria-hidden="true" tabindex="-1"></a> <span class="st">&quot;json&quot;</span><span class="op">:</span> <span class="st">&quot;JavaScript Object Notation&quot;</span><span class="op">,</span></span>
-<span id="cb522-3"><a href="#cb522-3" aria-hidden="true" tabindex="-1"></a>}</span></code></pre></div>
+<div class="sourceCode" id="cb525"><pre
+class="sourceCode js"><code class="sourceCode javascript"><span id="cb525-1"><a href="#cb525-1" aria-hidden="true" tabindex="-1"></a>{</span>
+<span id="cb525-2"><a href="#cb525-2" aria-hidden="true" tabindex="-1"></a> <span class="st">&quot;json&quot;</span><span class="op">:</span> <span class="st">&quot;JavaScript Object Notation&quot;</span><span class="op">,</span></span>
+<span id="cb525-3"><a href="#cb525-3" aria-hidden="true" tabindex="-1"></a>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb523"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb523-1"><a href="#cb523-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb526"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb526-1"><a href="#cb526-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -9484,121 +9576,121 @@ the logotype of TUGboat.</p>
class="header-section-number">2.3.1.10</span> Definition List
Renderers</h4>
<p>The following macros are only produced, when the
-<strong><code>definitionLists</code></strong> option is enabled.</p>
-<p>The <code>\markdownRendererDlBegin</code> macro represents the
+<code><strong>definitionLists</strong></code> option is enabled.</p>
+<p>The <code>markdownRendererDlBegin</code> macro represents the
beginning of a definition list that contains an item with several
paragraphs of text (the list is not tight). The macro receives no
arguments.</p>
-<p>The <code>\markdownRendererDlBeginTight</code> macro represents the
+<p>The <code>markdownRendererDlBeginTight</code> macro represents the
beginning of a definition list that contains no item with several
paragraphs of text (the list is tight). This macro will only be
-produced, when the <strong><code>tightLists</code></strong> option is
+produced, when the <code><strong>tightLists</strong></code> option is
disabled. The macro receives no arguments.</p>
-<p>The <code>\markdownRendererDlItem</code> macro represents a term in a
+<p>The <code>markdownRendererDlItem</code> macro represents a term in a
definition list. The macro receives a single argument that corresponds
to the term being defined.</p>
-<p>The <code>\markdownRendererDlItemEnd</code> macro represents the end
+<p>The <code>markdownRendererDlItemEnd</code> macro represents the end
of a list of definitions for a single term.</p>
-<p>The <code>\markdownRendererDlDefinitionBegin</code> macro represents
+<p>The <code>markdownRendererDlDefinitionBegin</code> macro represents
the beginning of a definition in a definition list. There can be several
definitions for a single term.</p>
-<p>The <code>\markdownRendererDlDefinitionEnd</code> macro represents
-the end of a definition in a definition list. There can be several
+<p>The <code>markdownRendererDlDefinitionEnd</code> macro represents the
+end of a definition in a definition list. There can be several
definitions for a single term.</p>
-<p>The <code>\markdownRendererDlEnd</code> macro represents the end of a
+<p>The <code>markdownRendererDlEnd</code> macro represents the end of a
definition list that contains an item with several paragraphs of text
(the list is not tight). The macro receives no arguments.</p>
-<p>The <code>\markdownRendererDlEndTight</code> macro represents the end
+<p>The <code>markdownRendererDlEndTight</code> macro represents the end
of a definition list that contains no item with several paragraphs of
text (the list is tight). This macro will only be produced, when the
-<strong><code>tightLists</code></strong> option is disabled. The macro
+<code><strong>tightLists</strong></code> option is disabled. The macro
receives no arguments.</p>
<h5 class="unnumbered" id="plain-tex-example-29">Plain <span
class="tex">T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb524"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb524-1"><a href="#cb524-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
-<span id="cb524-2"><a href="#cb524-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionDefinitionLists</span>{true}</span>
-<span id="cb524-3"><a href="#cb524-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionTightLists</span>{true}</span>
-<span id="cb524-4"><a href="#cb524-4" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb524-5"><a href="#cb524-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span>
-<span id="cb524-6"><a href="#cb524-6" aria-hidden="true" tabindex="-1"></a> :<span class="co">%</span></span>
-<span id="cb524-7"><a href="#cb524-7" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="fu">\par</span>}<span class="co">%</span></span>
-<span id="cb524-8"><a href="#cb524-8" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb524-9"><a href="#cb524-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererDlBeginTight</span>{<span class="co">%</span></span>
-<span id="cb524-10"><a href="#cb524-10" aria-hidden="true" tabindex="-1"></a> <span class="fu">\begingroup</span></span>
-<span id="cb524-11"><a href="#cb524-11" aria-hidden="true" tabindex="-1"></a> <span class="fu">\parindent</span>=0pt</span>
-<span id="cb524-12"><a href="#cb524-12" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb524-13"><a href="#cb524-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererDlItem</span>#1{<span class="co">%</span></span>
-<span id="cb524-14"><a href="#cb524-14" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span>{<span class="fu">\bf</span>#1}<span class="co">%</span></span>
-<span id="cb524-15"><a href="#cb524-15" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererDlDefinitionEnd</span>{<span class="co">%</span></span>
-<span id="cb524-16"><a href="#cb524-16" aria-hidden="true" tabindex="-1"></a> ,</span>
-<span id="cb524-17"><a href="#cb524-17" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererDlDefinitionEnd</span>{<span class="co">%</span></span>
-<span id="cb524-18"><a href="#cb524-18" aria-hidden="true" tabindex="-1"></a> , and</span>
-<span id="cb524-19"><a href="#cb524-19" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererDlDefinitionEnd</span>{.}<span class="co">%</span></span>
-<span id="cb524-20"><a href="#cb524-20" aria-hidden="true" tabindex="-1"></a> }<span class="co">%</span></span>
-<span id="cb524-21"><a href="#cb524-21" aria-hidden="true" tabindex="-1"></a> }<span class="co">%</span></span>
-<span id="cb524-22"><a href="#cb524-22" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb524-23"><a href="#cb524-23" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererDlItemEnd</span>{}</span>
-<span id="cb524-24"><a href="#cb524-24" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererDlDefinitionBegin</span>{<span class="fu">\par</span>--<span class="fu">\kern</span> 0.5em}</span>
-<span id="cb524-25"><a href="#cb524-25" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererDlEndTight</span>{<span class="fu">\endgroup</span>}</span>
-<span id="cb524-26"><a href="#cb524-26" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb524-27"><a href="#cb524-27" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
-<span id="cb524-28"><a href="#cb524-28" aria-hidden="true" tabindex="-1"></a>This is a tight definition list</span>
-<span id="cb524-29"><a href="#cb524-29" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb524-30"><a href="#cb524-30" aria-hidden="true" tabindex="-1"></a>Coffee</span>
-<span id="cb524-31"><a href="#cb524-31" aria-hidden="true" tabindex="-1"></a>: black hot drink</span>
-<span id="cb524-32"><a href="#cb524-32" aria-hidden="true" tabindex="-1"></a>: prepared from roasted coffee beans</span>
-<span id="cb524-33"><a href="#cb524-33" aria-hidden="true" tabindex="-1"></a>: one of the most traded agricultural commodities in the world</span>
-<span id="cb524-34"><a href="#cb524-34" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb524-35"><a href="#cb524-35" aria-hidden="true" tabindex="-1"></a>Milk</span>
-<span id="cb524-36"><a href="#cb524-36" aria-hidden="true" tabindex="-1"></a>: white cold drink</span>
-<span id="cb524-37"><a href="#cb524-37" aria-hidden="true" tabindex="-1"></a>: nutrient-rich</span>
-<span id="cb524-38"><a href="#cb524-38" aria-hidden="true" tabindex="-1"></a>: produced on an industrial scale</span>
-<span id="cb524-39"><a href="#cb524-39" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
-<span id="cb524-40"><a href="#cb524-40" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb524-41"><a href="#cb524-41" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span>
-<span id="cb524-42"><a href="#cb524-42" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="fu">\par</span>}<span class="co">%</span></span>
-<span id="cb524-43"><a href="#cb524-43" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb524-44"><a href="#cb524-44" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererDlBegin</span>{}</span>
-<span id="cb524-45"><a href="#cb524-45" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererDlItem</span>#1{<span class="co">%</span></span>
-<span id="cb524-46"><a href="#cb524-46" aria-hidden="true" tabindex="-1"></a> . #1 is a</span>
-<span id="cb524-47"><a href="#cb524-47" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererDlDefinitionBegin</span>{<span class="co">%</span></span>
-<span id="cb524-48"><a href="#cb524-48" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererDlDefinitionBegin</span>{<span class="co">%</span></span>
-<span id="cb524-49"><a href="#cb524-49" aria-hidden="true" tabindex="-1"></a> ,</span>
-<span id="cb524-50"><a href="#cb524-50" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererDlDefinitionBegin</span>{, and }<span class="co">%</span></span>
-<span id="cb524-51"><a href="#cb524-51" aria-hidden="true" tabindex="-1"></a> }<span class="co">%</span></span>
-<span id="cb524-52"><a href="#cb524-52" aria-hidden="true" tabindex="-1"></a> }<span class="co">%</span></span>
-<span id="cb524-53"><a href="#cb524-53" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb524-54"><a href="#cb524-54" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererDlItemEnd</span>{}</span>
-<span id="cb524-55"><a href="#cb524-55" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererDlDefinitionEnd</span>{}</span>
-<span id="cb524-56"><a href="#cb524-56" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererDlEnd</span>{.}</span>
-<span id="cb524-57"><a href="#cb524-57" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb524-58"><a href="#cb524-58" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
-<span id="cb524-59"><a href="#cb524-59" aria-hidden="true" tabindex="-1"></a>This is a loose definition list</span>
-<span id="cb524-60"><a href="#cb524-60" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb524-61"><a href="#cb524-61" aria-hidden="true" tabindex="-1"></a>Coffee</span>
-<span id="cb524-62"><a href="#cb524-62" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb524-63"><a href="#cb524-63" aria-hidden="true" tabindex="-1"></a>: black hot drink</span>
-<span id="cb524-64"><a href="#cb524-64" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb524-65"><a href="#cb524-65" aria-hidden="true" tabindex="-1"></a>: prepared from roasted coffee beans</span>
-<span id="cb524-66"><a href="#cb524-66" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb524-67"><a href="#cb524-67" aria-hidden="true" tabindex="-1"></a>: one of the most traded agricultural commodities in the world</span>
-<span id="cb524-68"><a href="#cb524-68" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb524-69"><a href="#cb524-69" aria-hidden="true" tabindex="-1"></a>Milk</span>
-<span id="cb524-70"><a href="#cb524-70" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb524-71"><a href="#cb524-71" aria-hidden="true" tabindex="-1"></a>: white cold drink</span>
-<span id="cb524-72"><a href="#cb524-72" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb524-73"><a href="#cb524-73" aria-hidden="true" tabindex="-1"></a>: nutrient-rich</span>
-<span id="cb524-74"><a href="#cb524-74" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb524-75"><a href="#cb524-75" aria-hidden="true" tabindex="-1"></a>: produced on an industrial scale</span>
-<span id="cb524-76"><a href="#cb524-76" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
-<span id="cb524-77"><a href="#cb524-77" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb524-78"><a href="#cb524-78" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb527"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb527-1"><a href="#cb527-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
+<span id="cb527-2"><a href="#cb527-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionDefinitionLists</span>{true}</span>
+<span id="cb527-3"><a href="#cb527-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionTightLists</span>{true}</span>
+<span id="cb527-4"><a href="#cb527-4" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb527-5"><a href="#cb527-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span>
+<span id="cb527-6"><a href="#cb527-6" aria-hidden="true" tabindex="-1"></a> :<span class="co">%</span></span>
+<span id="cb527-7"><a href="#cb527-7" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="fu">\par</span>}<span class="co">%</span></span>
+<span id="cb527-8"><a href="#cb527-8" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb527-9"><a href="#cb527-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererDlBeginTight</span>{<span class="co">%</span></span>
+<span id="cb527-10"><a href="#cb527-10" aria-hidden="true" tabindex="-1"></a> <span class="fu">\begingroup</span></span>
+<span id="cb527-11"><a href="#cb527-11" aria-hidden="true" tabindex="-1"></a> <span class="fu">\parindent</span>=0pt</span>
+<span id="cb527-12"><a href="#cb527-12" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb527-13"><a href="#cb527-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererDlItem</span>#1{<span class="co">%</span></span>
+<span id="cb527-14"><a href="#cb527-14" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span>{<span class="fu">\bf</span>#1}<span class="co">%</span></span>
+<span id="cb527-15"><a href="#cb527-15" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererDlDefinitionEnd</span>{<span class="co">%</span></span>
+<span id="cb527-16"><a href="#cb527-16" aria-hidden="true" tabindex="-1"></a> ,</span>
+<span id="cb527-17"><a href="#cb527-17" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererDlDefinitionEnd</span>{<span class="co">%</span></span>
+<span id="cb527-18"><a href="#cb527-18" aria-hidden="true" tabindex="-1"></a> , and</span>
+<span id="cb527-19"><a href="#cb527-19" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererDlDefinitionEnd</span>{.}<span class="co">%</span></span>
+<span id="cb527-20"><a href="#cb527-20" aria-hidden="true" tabindex="-1"></a> }<span class="co">%</span></span>
+<span id="cb527-21"><a href="#cb527-21" aria-hidden="true" tabindex="-1"></a> }<span class="co">%</span></span>
+<span id="cb527-22"><a href="#cb527-22" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb527-23"><a href="#cb527-23" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererDlItemEnd</span>{}</span>
+<span id="cb527-24"><a href="#cb527-24" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererDlDefinitionBegin</span>{<span class="fu">\par</span>--<span class="fu">\kern</span> 0.5em}</span>
+<span id="cb527-25"><a href="#cb527-25" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererDlEndTight</span>{<span class="fu">\endgroup</span>}</span>
+<span id="cb527-26"><a href="#cb527-26" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb527-27"><a href="#cb527-27" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
+<span id="cb527-28"><a href="#cb527-28" aria-hidden="true" tabindex="-1"></a>This is a tight definition list</span>
+<span id="cb527-29"><a href="#cb527-29" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb527-30"><a href="#cb527-30" aria-hidden="true" tabindex="-1"></a>Coffee</span>
+<span id="cb527-31"><a href="#cb527-31" aria-hidden="true" tabindex="-1"></a>: black hot drink</span>
+<span id="cb527-32"><a href="#cb527-32" aria-hidden="true" tabindex="-1"></a>: prepared from roasted coffee beans</span>
+<span id="cb527-33"><a href="#cb527-33" aria-hidden="true" tabindex="-1"></a>: one of the most traded agricultural commodities in the world</span>
+<span id="cb527-34"><a href="#cb527-34" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb527-35"><a href="#cb527-35" aria-hidden="true" tabindex="-1"></a>Milk</span>
+<span id="cb527-36"><a href="#cb527-36" aria-hidden="true" tabindex="-1"></a>: white cold drink</span>
+<span id="cb527-37"><a href="#cb527-37" aria-hidden="true" tabindex="-1"></a>: nutrient-rich</span>
+<span id="cb527-38"><a href="#cb527-38" aria-hidden="true" tabindex="-1"></a>: produced on an industrial scale</span>
+<span id="cb527-39"><a href="#cb527-39" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
+<span id="cb527-40"><a href="#cb527-40" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb527-41"><a href="#cb527-41" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span>
+<span id="cb527-42"><a href="#cb527-42" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="fu">\par</span>}<span class="co">%</span></span>
+<span id="cb527-43"><a href="#cb527-43" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb527-44"><a href="#cb527-44" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererDlBegin</span>{}</span>
+<span id="cb527-45"><a href="#cb527-45" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererDlItem</span>#1{<span class="co">%</span></span>
+<span id="cb527-46"><a href="#cb527-46" aria-hidden="true" tabindex="-1"></a> . #1 is a</span>
+<span id="cb527-47"><a href="#cb527-47" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererDlDefinitionBegin</span>{<span class="co">%</span></span>
+<span id="cb527-48"><a href="#cb527-48" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererDlDefinitionBegin</span>{<span class="co">%</span></span>
+<span id="cb527-49"><a href="#cb527-49" aria-hidden="true" tabindex="-1"></a> ,</span>
+<span id="cb527-50"><a href="#cb527-50" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererDlDefinitionBegin</span>{, and }<span class="co">%</span></span>
+<span id="cb527-51"><a href="#cb527-51" aria-hidden="true" tabindex="-1"></a> }<span class="co">%</span></span>
+<span id="cb527-52"><a href="#cb527-52" aria-hidden="true" tabindex="-1"></a> }<span class="co">%</span></span>
+<span id="cb527-53"><a href="#cb527-53" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb527-54"><a href="#cb527-54" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererDlItemEnd</span>{}</span>
+<span id="cb527-55"><a href="#cb527-55" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererDlDefinitionEnd</span>{}</span>
+<span id="cb527-56"><a href="#cb527-56" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererDlEnd</span>{.}</span>
+<span id="cb527-57"><a href="#cb527-57" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb527-58"><a href="#cb527-58" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
+<span id="cb527-59"><a href="#cb527-59" aria-hidden="true" tabindex="-1"></a>This is a loose definition list</span>
+<span id="cb527-60"><a href="#cb527-60" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb527-61"><a href="#cb527-61" aria-hidden="true" tabindex="-1"></a>Coffee</span>
+<span id="cb527-62"><a href="#cb527-62" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb527-63"><a href="#cb527-63" aria-hidden="true" tabindex="-1"></a>: black hot drink</span>
+<span id="cb527-64"><a href="#cb527-64" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb527-65"><a href="#cb527-65" aria-hidden="true" tabindex="-1"></a>: prepared from roasted coffee beans</span>
+<span id="cb527-66"><a href="#cb527-66" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb527-67"><a href="#cb527-67" aria-hidden="true" tabindex="-1"></a>: one of the most traded agricultural commodities in the world</span>
+<span id="cb527-68"><a href="#cb527-68" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb527-69"><a href="#cb527-69" aria-hidden="true" tabindex="-1"></a>Milk</span>
+<span id="cb527-70"><a href="#cb527-70" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb527-71"><a href="#cb527-71" aria-hidden="true" tabindex="-1"></a>: white cold drink</span>
+<span id="cb527-72"><a href="#cb527-72" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb527-73"><a href="#cb527-73" aria-hidden="true" tabindex="-1"></a>: nutrient-rich</span>
+<span id="cb527-74"><a href="#cb527-74" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb527-75"><a href="#cb527-75" aria-hidden="true" tabindex="-1"></a>: produced on an industrial scale</span>
+<span id="cb527-76"><a href="#cb527-76" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
+<span id="cb527-77"><a href="#cb527-77" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb527-78"><a href="#cb527-78" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb525"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb525-1"><a href="#cb525-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb528"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb528-1"><a href="#cb528-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -9624,90 +9716,90 @@ nutrient-rich, and produced on an industrial scale.</p>
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb526"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb526-1"><a href="#cb526-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb526-2"><a href="#cb526-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[definitionLists, tightLists]{<span class="ex">markdown</span>}</span>
-<span id="cb526-3"><a href="#cb526-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb526-4"><a href="#cb526-4" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb526-5"><a href="#cb526-5" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}[</span>
-<span id="cb526-6"><a href="#cb526-6" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb526-7"><a href="#cb526-7" aria-hidden="true" tabindex="-1"></a> interblockSeparator = {<span class="co">%</span></span>
-<span id="cb526-8"><a href="#cb526-8" aria-hidden="true" tabindex="-1"></a> :<span class="co">%</span></span>
-<span id="cb526-9"><a href="#cb526-9" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="fu">\par</span>}<span class="co">%</span></span>
-<span id="cb526-10"><a href="#cb526-10" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb526-11"><a href="#cb526-11" aria-hidden="true" tabindex="-1"></a> dlBeginTight = {<span class="kw">\begin</span>{<span class="ex">description</span>}},</span>
-<span id="cb526-12"><a href="#cb526-12" aria-hidden="true" tabindex="-1"></a> dlItem = {<span class="co">%</span></span>
-<span id="cb526-13"><a href="#cb526-13" aria-hidden="true" tabindex="-1"></a> <span class="fu">\item</span>[#1]</span>
-<span id="cb526-14"><a href="#cb526-14" aria-hidden="true" tabindex="-1"></a> <span class="kw">\begin</span>{<span class="ex">itemize</span>}</span>
-<span id="cb526-15"><a href="#cb526-15" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererDlDefinitionEnd</span>{<span class="co">%</span></span>
-<span id="cb526-16"><a href="#cb526-16" aria-hidden="true" tabindex="-1"></a> ,</span>
-<span id="cb526-17"><a href="#cb526-17" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererDlDefinitionEnd</span>{<span class="co">%</span></span>
-<span id="cb526-18"><a href="#cb526-18" aria-hidden="true" tabindex="-1"></a> , and</span>
-<span id="cb526-19"><a href="#cb526-19" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererDlDefinitionEnd</span>{.}<span class="co">%</span></span>
-<span id="cb526-20"><a href="#cb526-20" aria-hidden="true" tabindex="-1"></a> }<span class="co">%</span></span>
-<span id="cb526-21"><a href="#cb526-21" aria-hidden="true" tabindex="-1"></a> }<span class="co">%</span></span>
-<span id="cb526-22"><a href="#cb526-22" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb526-23"><a href="#cb526-23" aria-hidden="true" tabindex="-1"></a> dlItemEnd = {<span class="kw">\end</span>{<span class="ex">itemize</span>}},</span>
-<span id="cb526-24"><a href="#cb526-24" aria-hidden="true" tabindex="-1"></a> dlDefinitionBegin = <span class="fu">\item</span>,</span>
-<span id="cb526-25"><a href="#cb526-25" aria-hidden="true" tabindex="-1"></a> dlEndTight = {<span class="kw">\end</span>{<span class="ex">description</span>}},</span>
-<span id="cb526-26"><a href="#cb526-26" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb526-27"><a href="#cb526-27" aria-hidden="true" tabindex="-1"></a>]</span>
-<span id="cb526-28"><a href="#cb526-28" aria-hidden="true" tabindex="-1"></a>This is a tight definition list</span>
-<span id="cb526-29"><a href="#cb526-29" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb526-30"><a href="#cb526-30" aria-hidden="true" tabindex="-1"></a>Coffee</span>
-<span id="cb526-31"><a href="#cb526-31" aria-hidden="true" tabindex="-1"></a>: black hot drink</span>
-<span id="cb526-32"><a href="#cb526-32" aria-hidden="true" tabindex="-1"></a>: prepared from roasted coffee beans</span>
-<span id="cb526-33"><a href="#cb526-33" aria-hidden="true" tabindex="-1"></a>: one of the most traded agricultural commodities in the world</span>
-<span id="cb526-34"><a href="#cb526-34" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb526-35"><a href="#cb526-35" aria-hidden="true" tabindex="-1"></a>Milk</span>
-<span id="cb526-36"><a href="#cb526-36" aria-hidden="true" tabindex="-1"></a>: white cold drink</span>
-<span id="cb526-37"><a href="#cb526-37" aria-hidden="true" tabindex="-1"></a>: nutrient-rich</span>
-<span id="cb526-38"><a href="#cb526-38" aria-hidden="true" tabindex="-1"></a>: produced on an industrial scale</span>
-<span id="cb526-39"><a href="#cb526-39" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb526-40"><a href="#cb526-40" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb526-41"><a href="#cb526-41" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}[</span>
-<span id="cb526-42"><a href="#cb526-42" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb526-43"><a href="#cb526-43" aria-hidden="true" tabindex="-1"></a> interblockSeparator = {<span class="co">%</span></span>
-<span id="cb526-44"><a href="#cb526-44" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="fu">\par</span>}<span class="co">%</span></span>
-<span id="cb526-45"><a href="#cb526-45" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb526-46"><a href="#cb526-46" aria-hidden="true" tabindex="-1"></a> dlBegin = {},</span>
-<span id="cb526-47"><a href="#cb526-47" aria-hidden="true" tabindex="-1"></a> dlItem = {<span class="co">%</span></span>
-<span id="cb526-48"><a href="#cb526-48" aria-hidden="true" tabindex="-1"></a> . #1 is a</span>
-<span id="cb526-49"><a href="#cb526-49" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererDlDefinitionBegin</span>{<span class="co">%</span></span>
-<span id="cb526-50"><a href="#cb526-50" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererDlDefinitionBegin</span>{<span class="co">%</span></span>
-<span id="cb526-51"><a href="#cb526-51" aria-hidden="true" tabindex="-1"></a> ,</span>
-<span id="cb526-52"><a href="#cb526-52" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererDlDefinitionBegin</span>{, and }<span class="co">%</span></span>
-<span id="cb526-53"><a href="#cb526-53" aria-hidden="true" tabindex="-1"></a> }<span class="co">%</span></span>
-<span id="cb526-54"><a href="#cb526-54" aria-hidden="true" tabindex="-1"></a> }<span class="co">%</span></span>
-<span id="cb526-55"><a href="#cb526-55" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb526-56"><a href="#cb526-56" aria-hidden="true" tabindex="-1"></a> dlItemEnd = {},</span>
-<span id="cb526-57"><a href="#cb526-57" aria-hidden="true" tabindex="-1"></a> dlDefinitionEnd = {},</span>
-<span id="cb526-58"><a href="#cb526-58" aria-hidden="true" tabindex="-1"></a> dlEnd = {.},</span>
-<span id="cb526-59"><a href="#cb526-59" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb526-60"><a href="#cb526-60" aria-hidden="true" tabindex="-1"></a>]</span>
-<span id="cb526-61"><a href="#cb526-61" aria-hidden="true" tabindex="-1"></a>This is a loose definition list</span>
-<span id="cb526-62"><a href="#cb526-62" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb526-63"><a href="#cb526-63" aria-hidden="true" tabindex="-1"></a>Coffee</span>
-<span id="cb526-64"><a href="#cb526-64" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb526-65"><a href="#cb526-65" aria-hidden="true" tabindex="-1"></a>: black hot drink</span>
-<span id="cb526-66"><a href="#cb526-66" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb526-67"><a href="#cb526-67" aria-hidden="true" tabindex="-1"></a>: prepared from roasted coffee beans</span>
-<span id="cb526-68"><a href="#cb526-68" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb526-69"><a href="#cb526-69" aria-hidden="true" tabindex="-1"></a>: one of the most traded agricultural commodities in the world</span>
-<span id="cb526-70"><a href="#cb526-70" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb526-71"><a href="#cb526-71" aria-hidden="true" tabindex="-1"></a>Milk</span>
-<span id="cb526-72"><a href="#cb526-72" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb526-73"><a href="#cb526-73" aria-hidden="true" tabindex="-1"></a>: white cold drink</span>
-<span id="cb526-74"><a href="#cb526-74" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb526-75"><a href="#cb526-75" aria-hidden="true" tabindex="-1"></a>: nutrient-rich</span>
-<span id="cb526-76"><a href="#cb526-76" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb526-77"><a href="#cb526-77" aria-hidden="true" tabindex="-1"></a>: produced on an industrial scale</span>
-<span id="cb526-78"><a href="#cb526-78" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb526-79"><a href="#cb526-79" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb526-80"><a href="#cb526-80" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb529"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb529-1"><a href="#cb529-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb529-2"><a href="#cb529-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[definitionLists, tightLists]{<span class="ex">markdown</span>}</span>
+<span id="cb529-3"><a href="#cb529-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb529-4"><a href="#cb529-4" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb529-5"><a href="#cb529-5" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}[</span>
+<span id="cb529-6"><a href="#cb529-6" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb529-7"><a href="#cb529-7" aria-hidden="true" tabindex="-1"></a> interblockSeparator = {<span class="co">%</span></span>
+<span id="cb529-8"><a href="#cb529-8" aria-hidden="true" tabindex="-1"></a> :<span class="co">%</span></span>
+<span id="cb529-9"><a href="#cb529-9" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="fu">\par</span>}<span class="co">%</span></span>
+<span id="cb529-10"><a href="#cb529-10" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb529-11"><a href="#cb529-11" aria-hidden="true" tabindex="-1"></a> dlBeginTight = {<span class="kw">\begin</span>{<span class="ex">description</span>}},</span>
+<span id="cb529-12"><a href="#cb529-12" aria-hidden="true" tabindex="-1"></a> dlItem = {<span class="co">%</span></span>
+<span id="cb529-13"><a href="#cb529-13" aria-hidden="true" tabindex="-1"></a> <span class="fu">\item</span>[#1]</span>
+<span id="cb529-14"><a href="#cb529-14" aria-hidden="true" tabindex="-1"></a> <span class="kw">\begin</span>{<span class="ex">itemize</span>}</span>
+<span id="cb529-15"><a href="#cb529-15" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererDlDefinitionEnd</span>{<span class="co">%</span></span>
+<span id="cb529-16"><a href="#cb529-16" aria-hidden="true" tabindex="-1"></a> ,</span>
+<span id="cb529-17"><a href="#cb529-17" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererDlDefinitionEnd</span>{<span class="co">%</span></span>
+<span id="cb529-18"><a href="#cb529-18" aria-hidden="true" tabindex="-1"></a> , and</span>
+<span id="cb529-19"><a href="#cb529-19" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererDlDefinitionEnd</span>{.}<span class="co">%</span></span>
+<span id="cb529-20"><a href="#cb529-20" aria-hidden="true" tabindex="-1"></a> }<span class="co">%</span></span>
+<span id="cb529-21"><a href="#cb529-21" aria-hidden="true" tabindex="-1"></a> }<span class="co">%</span></span>
+<span id="cb529-22"><a href="#cb529-22" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb529-23"><a href="#cb529-23" aria-hidden="true" tabindex="-1"></a> dlItemEnd = {<span class="kw">\end</span>{<span class="ex">itemize</span>}},</span>
+<span id="cb529-24"><a href="#cb529-24" aria-hidden="true" tabindex="-1"></a> dlDefinitionBegin = <span class="fu">\item</span>,</span>
+<span id="cb529-25"><a href="#cb529-25" aria-hidden="true" tabindex="-1"></a> dlEndTight = {<span class="kw">\end</span>{<span class="ex">description</span>}},</span>
+<span id="cb529-26"><a href="#cb529-26" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb529-27"><a href="#cb529-27" aria-hidden="true" tabindex="-1"></a>]</span>
+<span id="cb529-28"><a href="#cb529-28" aria-hidden="true" tabindex="-1"></a>This is a tight definition list</span>
+<span id="cb529-29"><a href="#cb529-29" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb529-30"><a href="#cb529-30" aria-hidden="true" tabindex="-1"></a>Coffee</span>
+<span id="cb529-31"><a href="#cb529-31" aria-hidden="true" tabindex="-1"></a>: black hot drink</span>
+<span id="cb529-32"><a href="#cb529-32" aria-hidden="true" tabindex="-1"></a>: prepared from roasted coffee beans</span>
+<span id="cb529-33"><a href="#cb529-33" aria-hidden="true" tabindex="-1"></a>: one of the most traded agricultural commodities in the world</span>
+<span id="cb529-34"><a href="#cb529-34" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb529-35"><a href="#cb529-35" aria-hidden="true" tabindex="-1"></a>Milk</span>
+<span id="cb529-36"><a href="#cb529-36" aria-hidden="true" tabindex="-1"></a>: white cold drink</span>
+<span id="cb529-37"><a href="#cb529-37" aria-hidden="true" tabindex="-1"></a>: nutrient-rich</span>
+<span id="cb529-38"><a href="#cb529-38" aria-hidden="true" tabindex="-1"></a>: produced on an industrial scale</span>
+<span id="cb529-39"><a href="#cb529-39" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb529-40"><a href="#cb529-40" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb529-41"><a href="#cb529-41" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}[</span>
+<span id="cb529-42"><a href="#cb529-42" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb529-43"><a href="#cb529-43" aria-hidden="true" tabindex="-1"></a> interblockSeparator = {<span class="co">%</span></span>
+<span id="cb529-44"><a href="#cb529-44" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="fu">\par</span>}<span class="co">%</span></span>
+<span id="cb529-45"><a href="#cb529-45" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb529-46"><a href="#cb529-46" aria-hidden="true" tabindex="-1"></a> dlBegin = {},</span>
+<span id="cb529-47"><a href="#cb529-47" aria-hidden="true" tabindex="-1"></a> dlItem = {<span class="co">%</span></span>
+<span id="cb529-48"><a href="#cb529-48" aria-hidden="true" tabindex="-1"></a> . #1 is a</span>
+<span id="cb529-49"><a href="#cb529-49" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererDlDefinitionBegin</span>{<span class="co">%</span></span>
+<span id="cb529-50"><a href="#cb529-50" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererDlDefinitionBegin</span>{<span class="co">%</span></span>
+<span id="cb529-51"><a href="#cb529-51" aria-hidden="true" tabindex="-1"></a> ,</span>
+<span id="cb529-52"><a href="#cb529-52" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererDlDefinitionBegin</span>{, and }<span class="co">%</span></span>
+<span id="cb529-53"><a href="#cb529-53" aria-hidden="true" tabindex="-1"></a> }<span class="co">%</span></span>
+<span id="cb529-54"><a href="#cb529-54" aria-hidden="true" tabindex="-1"></a> }<span class="co">%</span></span>
+<span id="cb529-55"><a href="#cb529-55" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb529-56"><a href="#cb529-56" aria-hidden="true" tabindex="-1"></a> dlItemEnd = {},</span>
+<span id="cb529-57"><a href="#cb529-57" aria-hidden="true" tabindex="-1"></a> dlDefinitionEnd = {},</span>
+<span id="cb529-58"><a href="#cb529-58" aria-hidden="true" tabindex="-1"></a> dlEnd = {.},</span>
+<span id="cb529-59"><a href="#cb529-59" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb529-60"><a href="#cb529-60" aria-hidden="true" tabindex="-1"></a>]</span>
+<span id="cb529-61"><a href="#cb529-61" aria-hidden="true" tabindex="-1"></a>This is a loose definition list</span>
+<span id="cb529-62"><a href="#cb529-62" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb529-63"><a href="#cb529-63" aria-hidden="true" tabindex="-1"></a>Coffee</span>
+<span id="cb529-64"><a href="#cb529-64" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb529-65"><a href="#cb529-65" aria-hidden="true" tabindex="-1"></a>: black hot drink</span>
+<span id="cb529-66"><a href="#cb529-66" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb529-67"><a href="#cb529-67" aria-hidden="true" tabindex="-1"></a>: prepared from roasted coffee beans</span>
+<span id="cb529-68"><a href="#cb529-68" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb529-69"><a href="#cb529-69" aria-hidden="true" tabindex="-1"></a>: one of the most traded agricultural commodities in the world</span>
+<span id="cb529-70"><a href="#cb529-70" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb529-71"><a href="#cb529-71" aria-hidden="true" tabindex="-1"></a>Milk</span>
+<span id="cb529-72"><a href="#cb529-72" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb529-73"><a href="#cb529-73" aria-hidden="true" tabindex="-1"></a>: white cold drink</span>
+<span id="cb529-74"><a href="#cb529-74" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb529-75"><a href="#cb529-75" aria-hidden="true" tabindex="-1"></a>: nutrient-rich</span>
+<span id="cb529-76"><a href="#cb529-76" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb529-77"><a href="#cb529-77" aria-hidden="true" tabindex="-1"></a>: produced on an industrial scale</span>
+<span id="cb529-78"><a href="#cb529-78" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb529-79"><a href="#cb529-79" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb529-80"><a href="#cb529-80" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb527"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb527-1"><a href="#cb527-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb530"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb530-1"><a href="#cb530-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -9733,90 +9825,90 @@ nutrient-rich, and produced on an industrial scale.</p>
class="tex">T<sub>e</sub>X</span>t Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb528"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb528-1"><a href="#cb528-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
-<span id="cb528-2"><a href="#cb528-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span></span>
-<span id="cb528-3"><a href="#cb528-3" aria-hidden="true" tabindex="-1"></a> [</span>
-<span id="cb528-4"><a href="#cb528-4" aria-hidden="true" tabindex="-1"></a> definitionLists = yes,</span>
-<span id="cb528-5"><a href="#cb528-5" aria-hidden="true" tabindex="-1"></a> tightLists = yes,</span>
-<span id="cb528-6"><a href="#cb528-6" aria-hidden="true" tabindex="-1"></a> ]</span>
-<span id="cb528-7"><a href="#cb528-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
-<span id="cb528-8"><a href="#cb528-8" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb528-9"><a href="#cb528-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span>
-<span id="cb528-10"><a href="#cb528-10" aria-hidden="true" tabindex="-1"></a> :<span class="co">%</span></span>
-<span id="cb528-11"><a href="#cb528-11" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="fu">\par</span>}<span class="co">%</span></span>
-<span id="cb528-12"><a href="#cb528-12" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb528-13"><a href="#cb528-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererDlBeginTight</span>{}</span>
-<span id="cb528-14"><a href="#cb528-14" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererDlItem</span>#1{<span class="co">%</span></span>
-<span id="cb528-15"><a href="#cb528-15" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span>{<span class="fu">\bf</span>#1}<span class="co">%</span></span>
-<span id="cb528-16"><a href="#cb528-16" aria-hidden="true" tabindex="-1"></a> <span class="fu">\startitemize</span></span>
-<span id="cb528-17"><a href="#cb528-17" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererDlDefinitionEnd</span>{<span class="co">%</span></span>
-<span id="cb528-18"><a href="#cb528-18" aria-hidden="true" tabindex="-1"></a> ,</span>
-<span id="cb528-19"><a href="#cb528-19" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererDlDefinitionEnd</span>{<span class="co">%</span></span>
-<span id="cb528-20"><a href="#cb528-20" aria-hidden="true" tabindex="-1"></a> , and</span>
-<span id="cb528-21"><a href="#cb528-21" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererDlDefinitionEnd</span>{.}<span class="co">%</span></span>
-<span id="cb528-22"><a href="#cb528-22" aria-hidden="true" tabindex="-1"></a> }<span class="co">%</span></span>
-<span id="cb528-23"><a href="#cb528-23" aria-hidden="true" tabindex="-1"></a> }<span class="co">%</span></span>
-<span id="cb528-24"><a href="#cb528-24" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb528-25"><a href="#cb528-25" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererDlItemEnd</span>{<span class="fu">\stopitemize</span>}</span>
-<span id="cb528-26"><a href="#cb528-26" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererDlDefinitionBegin</span>{<span class="fu">\item</span>}</span>
-<span id="cb528-27"><a href="#cb528-27" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererDlEndTight</span>{}</span>
-<span id="cb528-28"><a href="#cb528-28" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb528-29"><a href="#cb528-29" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb528-30"><a href="#cb528-30" aria-hidden="true" tabindex="-1"></a>This is a tight definition list</span>
-<span id="cb528-31"><a href="#cb528-31" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb528-32"><a href="#cb528-32" aria-hidden="true" tabindex="-1"></a>Coffee</span>
-<span id="cb528-33"><a href="#cb528-33" aria-hidden="true" tabindex="-1"></a>: black hot drink</span>
-<span id="cb528-34"><a href="#cb528-34" aria-hidden="true" tabindex="-1"></a>: prepared from roasted coffee beans</span>
-<span id="cb528-35"><a href="#cb528-35" aria-hidden="true" tabindex="-1"></a>: one of the most traded agricultural commodities in the world</span>
-<span id="cb528-36"><a href="#cb528-36" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb528-37"><a href="#cb528-37" aria-hidden="true" tabindex="-1"></a>Milk</span>
-<span id="cb528-38"><a href="#cb528-38" aria-hidden="true" tabindex="-1"></a>: white cold drink</span>
-<span id="cb528-39"><a href="#cb528-39" aria-hidden="true" tabindex="-1"></a>: nutrient-rich</span>
-<span id="cb528-40"><a href="#cb528-40" aria-hidden="true" tabindex="-1"></a>: produced on an industrial scale</span>
-<span id="cb528-41"><a href="#cb528-41" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb528-42"><a href="#cb528-42" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb528-43"><a href="#cb528-43" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span>
-<span id="cb528-44"><a href="#cb528-44" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="fu">\par</span>}<span class="co">%</span></span>
-<span id="cb528-45"><a href="#cb528-45" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb528-46"><a href="#cb528-46" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererDlBegin</span>{}</span>
-<span id="cb528-47"><a href="#cb528-47" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererDlItem</span>#1{<span class="co">%</span></span>
-<span id="cb528-48"><a href="#cb528-48" aria-hidden="true" tabindex="-1"></a> . #1 is a</span>
-<span id="cb528-49"><a href="#cb528-49" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererDlDefinitionBegin</span>{<span class="co">%</span></span>
-<span id="cb528-50"><a href="#cb528-50" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererDlDefinitionBegin</span>{<span class="co">%</span></span>
-<span id="cb528-51"><a href="#cb528-51" aria-hidden="true" tabindex="-1"></a> ,</span>
-<span id="cb528-52"><a href="#cb528-52" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererDlDefinitionBegin</span>{, and }<span class="co">%</span></span>
-<span id="cb528-53"><a href="#cb528-53" aria-hidden="true" tabindex="-1"></a> }<span class="co">%</span></span>
-<span id="cb528-54"><a href="#cb528-54" aria-hidden="true" tabindex="-1"></a> }<span class="co">%</span></span>
-<span id="cb528-55"><a href="#cb528-55" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb528-56"><a href="#cb528-56" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererDlItemEnd</span>{}</span>
-<span id="cb528-57"><a href="#cb528-57" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererDlDefinitionEnd</span>{}</span>
-<span id="cb528-58"><a href="#cb528-58" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererDlEnd</span>{.}</span>
-<span id="cb528-59"><a href="#cb528-59" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb528-60"><a href="#cb528-60" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb528-61"><a href="#cb528-61" aria-hidden="true" tabindex="-1"></a>This is a loose definition list</span>
-<span id="cb528-62"><a href="#cb528-62" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb528-63"><a href="#cb528-63" aria-hidden="true" tabindex="-1"></a>Coffee</span>
-<span id="cb528-64"><a href="#cb528-64" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb528-65"><a href="#cb528-65" aria-hidden="true" tabindex="-1"></a>: black hot drink</span>
-<span id="cb528-66"><a href="#cb528-66" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb528-67"><a href="#cb528-67" aria-hidden="true" tabindex="-1"></a>: prepared from roasted coffee beans</span>
-<span id="cb528-68"><a href="#cb528-68" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb528-69"><a href="#cb528-69" aria-hidden="true" tabindex="-1"></a>: one of the most traded agricultural commodities in the world</span>
-<span id="cb528-70"><a href="#cb528-70" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb528-71"><a href="#cb528-71" aria-hidden="true" tabindex="-1"></a>Milk</span>
-<span id="cb528-72"><a href="#cb528-72" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb528-73"><a href="#cb528-73" aria-hidden="true" tabindex="-1"></a>: white cold drink</span>
-<span id="cb528-74"><a href="#cb528-74" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb528-75"><a href="#cb528-75" aria-hidden="true" tabindex="-1"></a>: nutrient-rich</span>
-<span id="cb528-76"><a href="#cb528-76" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb528-77"><a href="#cb528-77" aria-hidden="true" tabindex="-1"></a>: produced on an industrial scale</span>
-<span id="cb528-78"><a href="#cb528-78" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb528-79"><a href="#cb528-79" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb528-80"><a href="#cb528-80" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
+<div class="sourceCode" id="cb531"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb531-1"><a href="#cb531-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
+<span id="cb531-2"><a href="#cb531-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span></span>
+<span id="cb531-3"><a href="#cb531-3" aria-hidden="true" tabindex="-1"></a> [</span>
+<span id="cb531-4"><a href="#cb531-4" aria-hidden="true" tabindex="-1"></a> definitionLists = yes,</span>
+<span id="cb531-5"><a href="#cb531-5" aria-hidden="true" tabindex="-1"></a> tightLists = yes,</span>
+<span id="cb531-6"><a href="#cb531-6" aria-hidden="true" tabindex="-1"></a> ]</span>
+<span id="cb531-7"><a href="#cb531-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
+<span id="cb531-8"><a href="#cb531-8" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb531-9"><a href="#cb531-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span>
+<span id="cb531-10"><a href="#cb531-10" aria-hidden="true" tabindex="-1"></a> :<span class="co">%</span></span>
+<span id="cb531-11"><a href="#cb531-11" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="fu">\par</span>}<span class="co">%</span></span>
+<span id="cb531-12"><a href="#cb531-12" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb531-13"><a href="#cb531-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererDlBeginTight</span>{}</span>
+<span id="cb531-14"><a href="#cb531-14" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererDlItem</span>#1{<span class="co">%</span></span>
+<span id="cb531-15"><a href="#cb531-15" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span>{<span class="fu">\bf</span>#1}<span class="co">%</span></span>
+<span id="cb531-16"><a href="#cb531-16" aria-hidden="true" tabindex="-1"></a> <span class="fu">\startitemize</span></span>
+<span id="cb531-17"><a href="#cb531-17" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererDlDefinitionEnd</span>{<span class="co">%</span></span>
+<span id="cb531-18"><a href="#cb531-18" aria-hidden="true" tabindex="-1"></a> ,</span>
+<span id="cb531-19"><a href="#cb531-19" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererDlDefinitionEnd</span>{<span class="co">%</span></span>
+<span id="cb531-20"><a href="#cb531-20" aria-hidden="true" tabindex="-1"></a> , and</span>
+<span id="cb531-21"><a href="#cb531-21" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererDlDefinitionEnd</span>{.}<span class="co">%</span></span>
+<span id="cb531-22"><a href="#cb531-22" aria-hidden="true" tabindex="-1"></a> }<span class="co">%</span></span>
+<span id="cb531-23"><a href="#cb531-23" aria-hidden="true" tabindex="-1"></a> }<span class="co">%</span></span>
+<span id="cb531-24"><a href="#cb531-24" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb531-25"><a href="#cb531-25" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererDlItemEnd</span>{<span class="fu">\stopitemize</span>}</span>
+<span id="cb531-26"><a href="#cb531-26" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererDlDefinitionBegin</span>{<span class="fu">\item</span>}</span>
+<span id="cb531-27"><a href="#cb531-27" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererDlEndTight</span>{}</span>
+<span id="cb531-28"><a href="#cb531-28" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb531-29"><a href="#cb531-29" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb531-30"><a href="#cb531-30" aria-hidden="true" tabindex="-1"></a>This is a tight definition list</span>
+<span id="cb531-31"><a href="#cb531-31" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb531-32"><a href="#cb531-32" aria-hidden="true" tabindex="-1"></a>Coffee</span>
+<span id="cb531-33"><a href="#cb531-33" aria-hidden="true" tabindex="-1"></a>: black hot drink</span>
+<span id="cb531-34"><a href="#cb531-34" aria-hidden="true" tabindex="-1"></a>: prepared from roasted coffee beans</span>
+<span id="cb531-35"><a href="#cb531-35" aria-hidden="true" tabindex="-1"></a>: one of the most traded agricultural commodities in the world</span>
+<span id="cb531-36"><a href="#cb531-36" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb531-37"><a href="#cb531-37" aria-hidden="true" tabindex="-1"></a>Milk</span>
+<span id="cb531-38"><a href="#cb531-38" aria-hidden="true" tabindex="-1"></a>: white cold drink</span>
+<span id="cb531-39"><a href="#cb531-39" aria-hidden="true" tabindex="-1"></a>: nutrient-rich</span>
+<span id="cb531-40"><a href="#cb531-40" aria-hidden="true" tabindex="-1"></a>: produced on an industrial scale</span>
+<span id="cb531-41"><a href="#cb531-41" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb531-42"><a href="#cb531-42" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb531-43"><a href="#cb531-43" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span>
+<span id="cb531-44"><a href="#cb531-44" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="fu">\par</span>}<span class="co">%</span></span>
+<span id="cb531-45"><a href="#cb531-45" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb531-46"><a href="#cb531-46" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererDlBegin</span>{}</span>
+<span id="cb531-47"><a href="#cb531-47" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererDlItem</span>#1{<span class="co">%</span></span>
+<span id="cb531-48"><a href="#cb531-48" aria-hidden="true" tabindex="-1"></a> . #1 is a</span>
+<span id="cb531-49"><a href="#cb531-49" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererDlDefinitionBegin</span>{<span class="co">%</span></span>
+<span id="cb531-50"><a href="#cb531-50" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererDlDefinitionBegin</span>{<span class="co">%</span></span>
+<span id="cb531-51"><a href="#cb531-51" aria-hidden="true" tabindex="-1"></a> ,</span>
+<span id="cb531-52"><a href="#cb531-52" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererDlDefinitionBegin</span>{, and }<span class="co">%</span></span>
+<span id="cb531-53"><a href="#cb531-53" aria-hidden="true" tabindex="-1"></a> }<span class="co">%</span></span>
+<span id="cb531-54"><a href="#cb531-54" aria-hidden="true" tabindex="-1"></a> }<span class="co">%</span></span>
+<span id="cb531-55"><a href="#cb531-55" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb531-56"><a href="#cb531-56" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererDlItemEnd</span>{}</span>
+<span id="cb531-57"><a href="#cb531-57" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererDlDefinitionEnd</span>{}</span>
+<span id="cb531-58"><a href="#cb531-58" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererDlEnd</span>{.}</span>
+<span id="cb531-59"><a href="#cb531-59" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb531-60"><a href="#cb531-60" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb531-61"><a href="#cb531-61" aria-hidden="true" tabindex="-1"></a>This is a loose definition list</span>
+<span id="cb531-62"><a href="#cb531-62" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb531-63"><a href="#cb531-63" aria-hidden="true" tabindex="-1"></a>Coffee</span>
+<span id="cb531-64"><a href="#cb531-64" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb531-65"><a href="#cb531-65" aria-hidden="true" tabindex="-1"></a>: black hot drink</span>
+<span id="cb531-66"><a href="#cb531-66" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb531-67"><a href="#cb531-67" aria-hidden="true" tabindex="-1"></a>: prepared from roasted coffee beans</span>
+<span id="cb531-68"><a href="#cb531-68" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb531-69"><a href="#cb531-69" aria-hidden="true" tabindex="-1"></a>: one of the most traded agricultural commodities in the world</span>
+<span id="cb531-70"><a href="#cb531-70" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb531-71"><a href="#cb531-71" aria-hidden="true" tabindex="-1"></a>Milk</span>
+<span id="cb531-72"><a href="#cb531-72" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb531-73"><a href="#cb531-73" aria-hidden="true" tabindex="-1"></a>: white cold drink</span>
+<span id="cb531-74"><a href="#cb531-74" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb531-75"><a href="#cb531-75" aria-hidden="true" tabindex="-1"></a>: nutrient-rich</span>
+<span id="cb531-76"><a href="#cb531-76" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb531-77"><a href="#cb531-77" aria-hidden="true" tabindex="-1"></a>: produced on an industrial scale</span>
+<span id="cb531-78"><a href="#cb531-78" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb531-79"><a href="#cb531-79" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb531-80"><a href="#cb531-80" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb529"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb529-1"><a href="#cb529-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb532"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb532-1"><a href="#cb532-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -9840,25 +9932,25 @@ nutrient-rich, and produced on an industrial scale.</p>
</blockquote>
<h4 data-number="2.3.1.11" id="ellipsis-renderer"><span
class="header-section-number">2.3.1.11</span> Ellipsis Renderer</h4>
-<p>The <code>\markdownRendererEllipsis</code> macro replaces any
+<p>The <code>markdownRendererEllipsis</code> macro replaces any
occurrence of ASCII ellipses in the input text. This macro will only be
-produced, when the <strong><code>smartEllipses</code></strong> option is
+produced, when the <code><strong>smartEllipses</strong></code> option is
enabled. The macro receives no arguments.</p>
<h5 class="unnumbered" id="plain-tex-example-30">Plain <span
class="tex">T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb530"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb530-1"><a href="#cb530-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
-<span id="cb530-2"><a href="#cb530-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionSmartEllipses</span>{true}</span>
-<span id="cb530-3"><a href="#cb530-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererEllipsis</span>{{<span class="fu">\it</span> SHAZAM}!}</span>
-<span id="cb530-4"><a href="#cb530-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
-<span id="cb530-5"><a href="#cb530-5" aria-hidden="true" tabindex="-1"></a>The secret word is ...</span>
-<span id="cb530-6"><a href="#cb530-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
-<span id="cb530-7"><a href="#cb530-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb533"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb533-1"><a href="#cb533-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
+<span id="cb533-2"><a href="#cb533-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionSmartEllipses</span>{true}</span>
+<span id="cb533-3"><a href="#cb533-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererEllipsis</span>{{<span class="fu">\it</span> SHAZAM}!}</span>
+<span id="cb533-4"><a href="#cb533-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
+<span id="cb533-5"><a href="#cb533-5" aria-hidden="true" tabindex="-1"></a>The secret word is ...</span>
+<span id="cb533-6"><a href="#cb533-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
+<span id="cb533-7"><a href="#cb533-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb531"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb531-1"><a href="#cb531-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb534"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb534-1"><a href="#cb534-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -9868,22 +9960,22 @@ contain the following text:</p>
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb532"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb532-1"><a href="#cb532-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb532-2"><a href="#cb532-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[smartEllipses]{<span class="ex">markdown</span>}</span>
-<span id="cb532-3"><a href="#cb532-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb532-4"><a href="#cb532-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb532-5"><a href="#cb532-5" aria-hidden="true" tabindex="-1"></a> ellipsis = <span class="fu">\emph</span>{SHAZAM}!,</span>
-<span id="cb532-6"><a href="#cb532-6" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb532-7"><a href="#cb532-7" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb532-8"><a href="#cb532-8" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb532-9"><a href="#cb532-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb532-10"><a href="#cb532-10" aria-hidden="true" tabindex="-1"></a>The secret word is ...</span>
-<span id="cb532-11"><a href="#cb532-11" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb532-12"><a href="#cb532-12" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb535"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb535-1"><a href="#cb535-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb535-2"><a href="#cb535-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[smartEllipses]{<span class="ex">markdown</span>}</span>
+<span id="cb535-3"><a href="#cb535-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb535-4"><a href="#cb535-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb535-5"><a href="#cb535-5" aria-hidden="true" tabindex="-1"></a> ellipsis = <span class="fu">\emph</span>{SHAZAM}!,</span>
+<span id="cb535-6"><a href="#cb535-6" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb535-7"><a href="#cb535-7" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb535-8"><a href="#cb535-8" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb535-9"><a href="#cb535-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb535-10"><a href="#cb535-10" aria-hidden="true" tabindex="-1"></a>The secret word is ...</span>
+<span id="cb535-11"><a href="#cb535-11" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb535-12"><a href="#cb535-12" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb533"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb533-1"><a href="#cb533-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb536"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb536-1"><a href="#cb536-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -9893,18 +9985,18 @@ contain the following text:</p>
class="tex">T<sub>e</sub>X</span>t Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb534"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb534-1"><a href="#cb534-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
-<span id="cb534-2"><a href="#cb534-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[smartEllipses = yes]</span>
-<span id="cb534-3"><a href="#cb534-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererEllipsis</span>{<span class="fu">\emph</span>{SHAZAM}!}</span>
-<span id="cb534-4"><a href="#cb534-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
-<span id="cb534-5"><a href="#cb534-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb534-6"><a href="#cb534-6" aria-hidden="true" tabindex="-1"></a>The secret word is ...</span>
-<span id="cb534-7"><a href="#cb534-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb534-8"><a href="#cb534-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
+<div class="sourceCode" id="cb537"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb537-1"><a href="#cb537-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
+<span id="cb537-2"><a href="#cb537-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[smartEllipses = yes]</span>
+<span id="cb537-3"><a href="#cb537-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererEllipsis</span>{<span class="fu">\emph</span>{SHAZAM}!}</span>
+<span id="cb537-4"><a href="#cb537-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
+<span id="cb537-5"><a href="#cb537-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb537-6"><a href="#cb537-6" aria-hidden="true" tabindex="-1"></a>The secret word is ...</span>
+<span id="cb537-7"><a href="#cb537-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb537-8"><a href="#cb537-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb535"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb535-1"><a href="#cb535-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb538"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb538-1"><a href="#cb538-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -9914,29 +10006,29 @@ contain the following text:</p>
</blockquote>
<h4 data-number="2.3.1.12" id="emphasis-renderers"><span
class="header-section-number">2.3.1.12</span> Emphasis Renderers</h4>
-<p>The <code>\markdownRendererEmphasis</code> macro represents an
+<p>The <code>markdownRendererEmphasis</code> macro represents an
emphasized span of text. The macro receives a single argument that
corresponds to the emphasized span of text.</p>
-<p>The <code>\markdownRendererStrongEmphasis</code> macro represents a
+<p>The <code>markdownRendererStrongEmphasis</code> macro represents a
strongly emphasized span of text. The macro receives a single argument
that corresponds to the emphasized span of text.</p>
<h5 class="unnumbered" id="plain-tex-example-31">Plain <span
class="tex">T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb536"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb536-1"><a href="#cb536-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
-<span id="cb536-2"><a href="#cb536-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererEmphasis</span>#1{{<span class="fu">\it</span>#1}}</span>
-<span id="cb536-3"><a href="#cb536-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererStrongEmphasis</span>#1{{<span class="fu">\bf</span>#1}}</span>
-<span id="cb536-4"><a href="#cb536-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
-<span id="cb536-5"><a href="#cb536-5" aria-hidden="true" tabindex="-1"></a>This is *emphasis*.</span>
-<span id="cb536-6"><a href="#cb536-6" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb536-7"><a href="#cb536-7" aria-hidden="true" tabindex="-1"></a>This is **strong emphasis**.</span>
-<span id="cb536-8"><a href="#cb536-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
-<span id="cb536-9"><a href="#cb536-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb539"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb539-1"><a href="#cb539-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
+<span id="cb539-2"><a href="#cb539-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererEmphasis</span>#1{{<span class="fu">\it</span>#1}}</span>
+<span id="cb539-3"><a href="#cb539-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererStrongEmphasis</span>#1{{<span class="fu">\bf</span>#1}}</span>
+<span id="cb539-4"><a href="#cb539-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
+<span id="cb539-5"><a href="#cb539-5" aria-hidden="true" tabindex="-1"></a>This is *emphasis*.</span>
+<span id="cb539-6"><a href="#cb539-6" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb539-7"><a href="#cb539-7" aria-hidden="true" tabindex="-1"></a>This is **strong emphasis**.</span>
+<span id="cb539-8"><a href="#cb539-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
+<span id="cb539-9"><a href="#cb539-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb537"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb537-1"><a href="#cb537-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb540"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb540-1"><a href="#cb540-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -9947,25 +10039,25 @@ contain the following text:</p>
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb538"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb538-1"><a href="#cb538-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb538-2"><a href="#cb538-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span>
-<span id="cb538-3"><a href="#cb538-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb538-4"><a href="#cb538-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb538-5"><a href="#cb538-5" aria-hidden="true" tabindex="-1"></a> emphasis = {<span class="fu">\emph</span>{#1}},</span>
-<span id="cb538-6"><a href="#cb538-6" aria-hidden="true" tabindex="-1"></a> strongEmphasis = {<span class="fu">\textbf</span>{#1}},</span>
-<span id="cb538-7"><a href="#cb538-7" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb538-8"><a href="#cb538-8" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb538-9"><a href="#cb538-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb538-10"><a href="#cb538-10" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb538-11"><a href="#cb538-11" aria-hidden="true" tabindex="-1"></a>This is *emphasis*.</span>
-<span id="cb538-12"><a href="#cb538-12" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb538-13"><a href="#cb538-13" aria-hidden="true" tabindex="-1"></a>This is **strong emphasis**.</span>
-<span id="cb538-14"><a href="#cb538-14" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb538-15"><a href="#cb538-15" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb541"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb541-1"><a href="#cb541-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb541-2"><a href="#cb541-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span>
+<span id="cb541-3"><a href="#cb541-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb541-4"><a href="#cb541-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb541-5"><a href="#cb541-5" aria-hidden="true" tabindex="-1"></a> emphasis = {<span class="fu">\emph</span>{#1}},</span>
+<span id="cb541-6"><a href="#cb541-6" aria-hidden="true" tabindex="-1"></a> strongEmphasis = {<span class="fu">\textbf</span>{#1}},</span>
+<span id="cb541-7"><a href="#cb541-7" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb541-8"><a href="#cb541-8" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb541-9"><a href="#cb541-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb541-10"><a href="#cb541-10" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb541-11"><a href="#cb541-11" aria-hidden="true" tabindex="-1"></a>This is *emphasis*.</span>
+<span id="cb541-12"><a href="#cb541-12" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb541-13"><a href="#cb541-13" aria-hidden="true" tabindex="-1"></a>This is **strong emphasis**.</span>
+<span id="cb541-14"><a href="#cb541-14" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb541-15"><a href="#cb541-15" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb539"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb539-1"><a href="#cb539-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb542"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb542-1"><a href="#cb542-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -9976,20 +10068,20 @@ contain the following text:</p>
class="tex">T<sub>e</sub>X</span>t Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb540"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb540-1"><a href="#cb540-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
-<span id="cb540-2"><a href="#cb540-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererEmphasis</span>#1{<span class="fu">\emph</span>{#1}}</span>
-<span id="cb540-3"><a href="#cb540-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererStrongEmphasis</span>#1{<span class="fu">\bold</span>{#1}}</span>
-<span id="cb540-4"><a href="#cb540-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
-<span id="cb540-5"><a href="#cb540-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb540-6"><a href="#cb540-6" aria-hidden="true" tabindex="-1"></a>This is *emphasis*.</span>
-<span id="cb540-7"><a href="#cb540-7" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb540-8"><a href="#cb540-8" aria-hidden="true" tabindex="-1"></a>This is **strong emphasis**.</span>
-<span id="cb540-9"><a href="#cb540-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb540-10"><a href="#cb540-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
+<div class="sourceCode" id="cb543"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb543-1"><a href="#cb543-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
+<span id="cb543-2"><a href="#cb543-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererEmphasis</span>#1{<span class="fu">\emph</span>{#1}}</span>
+<span id="cb543-3"><a href="#cb543-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererStrongEmphasis</span>#1{<span class="fu">\bold</span>{#1}}</span>
+<span id="cb543-4"><a href="#cb543-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
+<span id="cb543-5"><a href="#cb543-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb543-6"><a href="#cb543-6" aria-hidden="true" tabindex="-1"></a>This is *emphasis*.</span>
+<span id="cb543-7"><a href="#cb543-7" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb543-8"><a href="#cb543-8" aria-hidden="true" tabindex="-1"></a>This is **strong emphasis**.</span>
+<span id="cb543-9"><a href="#cb543-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb543-10"><a href="#cb543-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb541"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb541-1"><a href="#cb541-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb544"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb544-1"><a href="#cb544-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -10001,114 +10093,116 @@ id="fenced-code-attribute-context-renderers"><span
class="header-section-number">2.3.1.13</span> Fenced Code Attribute
Context Renderers</h4>
<p>The following macros are only produced, when the
-<strong><code>fencedCode</code></strong> option is enabled.</p>
-<p>The <code>\markdownRendererFencedCodeAttributeContextBegin</code> and
-<code>\markdownRendererFencedCodeAttributeContextEnd</code> macros
+<code><strong>fencedCode</strong></code> and
+<code><strong>fencedCodeAttributes</strong></code> options are
+enabled.</p>
+<p>The <code>markdownRendererFencedCodeAttributeContextBegin</code> and
+<code>markdownRendererFencedCodeAttributeContextEnd</code> macros
represent the beginning and the end of a context in which the attributes
of a fenced code apply. The macros receive no arguments.</p>
<h5 class="unnumbered" id="latex-example-69"><span
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb542"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb542-1"><a href="#cb542-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb542-2"><a href="#cb542-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[fencedCode,</span>
-<span id="cb542-3"><a href="#cb542-3" aria-hidden="true" tabindex="-1"></a> fencedCodeAttributes]{<span class="ex">markdown</span>}</span>
-<span id="cb542-4"><a href="#cb542-4" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">minted</span>}</span>
-<span id="cb542-5"><a href="#cb542-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb542-6"><a href="#cb542-6" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb542-7"><a href="#cb542-7" aria-hidden="true" tabindex="-1"></a> fencedCodeAttributeContextBegin = {<span class="co">%</span></span>
-<span id="cb542-8"><a href="#cb542-8" aria-hidden="true" tabindex="-1"></a> <span class="fu">\begingroup</span></span>
-<span id="cb542-9"><a href="#cb542-9" aria-hidden="true" tabindex="-1"></a> <span class="fu">\markdownSetup</span>{</span>
-<span id="cb542-10"><a href="#cb542-10" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb542-11"><a href="#cb542-11" aria-hidden="true" tabindex="-1"></a> attributeKeyValue = {<span class="co">%</span></span>
-<span id="cb542-12"><a href="#cb542-12" aria-hidden="true" tabindex="-1"></a> <span class="fu">\setminted</span>{{#1} = {#2}}<span class="co">%</span></span>
-<span id="cb542-13"><a href="#cb542-13" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb542-14"><a href="#cb542-14" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb542-15"><a href="#cb542-15" aria-hidden="true" tabindex="-1"></a> }<span class="co">%</span></span>
-<span id="cb542-16"><a href="#cb542-16" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb542-17"><a href="#cb542-17" aria-hidden="true" tabindex="-1"></a> fencedCodeAttributeContextEnd = {<span class="co">%</span></span>
-<span id="cb542-18"><a href="#cb542-18" aria-hidden="true" tabindex="-1"></a> <span class="fu">\endgroup</span></span>
-<span id="cb542-19"><a href="#cb542-19" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb542-20"><a href="#cb542-20" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb542-21"><a href="#cb542-21" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb542-22"><a href="#cb542-22" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb542-23"><a href="#cb542-23" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb542-24"><a href="#cb542-24" aria-hidden="true" tabindex="-1"></a>~~~ js {linenos=true}</span>
-<span id="cb542-25"><a href="#cb542-25" aria-hidden="true" tabindex="-1"></a>if (a &gt; 3) {</span>
-<span id="cb542-26"><a href="#cb542-26" aria-hidden="true" tabindex="-1"></a> moveShip(5 * gravity, DOWN);</span>
-<span id="cb542-27"><a href="#cb542-27" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb542-28"><a href="#cb542-28" aria-hidden="true" tabindex="-1"></a>~~~~~~</span>
-<span id="cb542-29"><a href="#cb542-29" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb542-30"><a href="#cb542-30" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb545"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb545-1"><a href="#cb545-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb545-2"><a href="#cb545-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[fencedCode,</span>
+<span id="cb545-3"><a href="#cb545-3" aria-hidden="true" tabindex="-1"></a> fencedCodeAttributes]{<span class="ex">markdown</span>}</span>
+<span id="cb545-4"><a href="#cb545-4" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">minted</span>}</span>
+<span id="cb545-5"><a href="#cb545-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb545-6"><a href="#cb545-6" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb545-7"><a href="#cb545-7" aria-hidden="true" tabindex="-1"></a> fencedCodeAttributeContextBegin = {<span class="co">%</span></span>
+<span id="cb545-8"><a href="#cb545-8" aria-hidden="true" tabindex="-1"></a> <span class="fu">\begingroup</span></span>
+<span id="cb545-9"><a href="#cb545-9" aria-hidden="true" tabindex="-1"></a> <span class="fu">\markdownSetup</span>{</span>
+<span id="cb545-10"><a href="#cb545-10" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb545-11"><a href="#cb545-11" aria-hidden="true" tabindex="-1"></a> attributeKeyValue = {<span class="co">%</span></span>
+<span id="cb545-12"><a href="#cb545-12" aria-hidden="true" tabindex="-1"></a> <span class="fu">\setminted</span>{{#1} = {#2}}<span class="co">%</span></span>
+<span id="cb545-13"><a href="#cb545-13" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb545-14"><a href="#cb545-14" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb545-15"><a href="#cb545-15" aria-hidden="true" tabindex="-1"></a> }<span class="co">%</span></span>
+<span id="cb545-16"><a href="#cb545-16" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb545-17"><a href="#cb545-17" aria-hidden="true" tabindex="-1"></a> fencedCodeAttributeContextEnd = {<span class="co">%</span></span>
+<span id="cb545-18"><a href="#cb545-18" aria-hidden="true" tabindex="-1"></a> <span class="fu">\endgroup</span></span>
+<span id="cb545-19"><a href="#cb545-19" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb545-20"><a href="#cb545-20" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb545-21"><a href="#cb545-21" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb545-22"><a href="#cb545-22" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb545-23"><a href="#cb545-23" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb545-24"><a href="#cb545-24" aria-hidden="true" tabindex="-1"></a>~~~ js {linenos=true}</span>
+<span id="cb545-25"><a href="#cb545-25" aria-hidden="true" tabindex="-1"></a>if (a &gt; 3) {</span>
+<span id="cb545-26"><a href="#cb545-26" aria-hidden="true" tabindex="-1"></a> moveShip(5 * gravity, DOWN);</span>
+<span id="cb545-27"><a href="#cb545-27" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb545-28"><a href="#cb545-28" aria-hidden="true" tabindex="-1"></a>~~~~~~</span>
+<span id="cb545-29"><a href="#cb545-29" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb545-30"><a href="#cb545-30" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb543"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb543-1"><a href="#cb543-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> <span class="at">--shell-escape</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb546"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb546-1"><a href="#cb546-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> <span class="at">--shell-escape</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
-<div class="sourceCode" id="cb544"><pre
-class="sourceCode js linenos"><code class="sourceCode javascript"><span id="cb544-1"><a href="#cb544-1" aria-hidden="true" tabindex="-1"></a><span class="fl">1.</span> <span class="cf">if</span> (a <span class="op">&gt;</span> <span class="dv">3</span>) {</span>
-<span id="cb544-2"><a href="#cb544-2" aria-hidden="true" tabindex="-1"></a><span class="fl">2.</span> <span class="fu">moveShip</span>(<span class="dv">5</span> <span class="op">*</span> gravity<span class="op">,</span> DOWN)<span class="op">;</span></span>
-<span id="cb544-3"><a href="#cb544-3" aria-hidden="true" tabindex="-1"></a><span class="fl">3.</span> }</span></code></pre></div>
+<div class="sourceCode" id="cb547"><pre
+class="sourceCode js linenos"><code class="sourceCode javascript"><span id="cb547-1"><a href="#cb547-1" aria-hidden="true" tabindex="-1"></a><span class="fl">1.</span> <span class="cf">if</span> (a <span class="op">&gt;</span> <span class="dv">3</span>) {</span>
+<span id="cb547-2"><a href="#cb547-2" aria-hidden="true" tabindex="-1"></a><span class="fl">2.</span> <span class="fu">moveShip</span>(<span class="dv">5</span> <span class="op">*</span> gravity<span class="op">,</span> DOWN)<span class="op">;</span></span>
+<span id="cb547-3"><a href="#cb547-3" aria-hidden="true" tabindex="-1"></a><span class="fl">3.</span> }</span></code></pre></div>
</blockquote>
<h4 data-number="2.3.1.14"
id="fenced-div-attribute-context-renderers"><span
class="header-section-number">2.3.1.14</span> Fenced Div Attribute
Context Renderers</h4>
<p>The following macros are only produced, when the
-<strong><code>fencedDiv</code></strong> option is enabled.</p>
-<p>The <code>\markdownRendererFencedDivAttributeContextBegin</code> and
-<code>\markdownRendererFencedDivAttributeContextEnd</code> macros
+<code><strong>fencedDiv</strong></code> option is enabled.</p>
+<p>The <code>markdownRendererFencedDivAttributeContextBegin</code> and
+<code>markdownRendererFencedDivAttributeContextEnd</code> macros
represent the beginning and the end of a context in which the attributes
of a div apply. The macros receive no arguments.</p>
<h5 class="unnumbered" id="latex-example-70"><span
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb545"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb545-1"><a href="#cb545-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb545-2"><a href="#cb545-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[fencedDivs]{<span class="ex">markdown</span>}</span>
-<span id="cb545-3"><a href="#cb545-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb545-4"><a href="#cb545-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb545-5"><a href="#cb545-5" aria-hidden="true" tabindex="-1"></a> fencedDivAttributeContextBegin = {<span class="co">%</span></span>
-<span id="cb545-6"><a href="#cb545-6" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
-<span id="cb545-7"><a href="#cb545-7" aria-hidden="true" tabindex="-1"></a> <span class="fu">\emph</span>{(The beginning of a fenced div attribute context)}</span>
-<span id="cb545-8"><a href="#cb545-8" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
-<span id="cb545-9"><a href="#cb545-9" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb545-10"><a href="#cb545-10" aria-hidden="true" tabindex="-1"></a> fencedDivAttributeContextEnd = {<span class="co">%</span></span>
-<span id="cb545-11"><a href="#cb545-11" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
-<span id="cb545-12"><a href="#cb545-12" aria-hidden="true" tabindex="-1"></a> <span class="fu">\emph</span>{(The end of a fenced div attribute context)}</span>
-<span id="cb545-13"><a href="#cb545-13" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
-<span id="cb545-14"><a href="#cb545-14" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb545-15"><a href="#cb545-15" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb545-16"><a href="#cb545-16" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb545-17"><a href="#cb545-17" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb545-18"><a href="#cb545-18" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb545-19"><a href="#cb545-19" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb545-20"><a href="#cb545-20" aria-hidden="true" tabindex="-1"></a>::: {key=value}</span>
-<span id="cb545-21"><a href="#cb545-21" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb545-22"><a href="#cb545-22" aria-hidden="true" tabindex="-1"></a>foo</span>
-<span id="cb545-23"><a href="#cb545-23" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb545-24"><a href="#cb545-24" aria-hidden="true" tabindex="-1"></a>:::: {#identifier}</span>
-<span id="cb545-25"><a href="#cb545-25" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb545-26"><a href="#cb545-26" aria-hidden="true" tabindex="-1"></a>bar</span>
-<span id="cb545-27"><a href="#cb545-27" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb545-28"><a href="#cb545-28" aria-hidden="true" tabindex="-1"></a>::::</span>
-<span id="cb545-29"><a href="#cb545-29" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb545-30"><a href="#cb545-30" aria-hidden="true" tabindex="-1"></a>:::</span>
-<span id="cb545-31"><a href="#cb545-31" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb545-32"><a href="#cb545-32" aria-hidden="true" tabindex="-1"></a>::: {.class_name}</span>
-<span id="cb545-33"><a href="#cb545-33" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb545-34"><a href="#cb545-34" aria-hidden="true" tabindex="-1"></a>baz</span>
-<span id="cb545-35"><a href="#cb545-35" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb545-36"><a href="#cb545-36" aria-hidden="true" tabindex="-1"></a>:::</span>
-<span id="cb545-37"><a href="#cb545-37" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb545-38"><a href="#cb545-38" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb545-39"><a href="#cb545-39" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb548"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb548-1"><a href="#cb548-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb548-2"><a href="#cb548-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[fencedDivs]{<span class="ex">markdown</span>}</span>
+<span id="cb548-3"><a href="#cb548-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb548-4"><a href="#cb548-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb548-5"><a href="#cb548-5" aria-hidden="true" tabindex="-1"></a> fencedDivAttributeContextBegin = {<span class="co">%</span></span>
+<span id="cb548-6"><a href="#cb548-6" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
+<span id="cb548-7"><a href="#cb548-7" aria-hidden="true" tabindex="-1"></a> <span class="fu">\emph</span>{(The beginning of a fenced div attribute context)}</span>
+<span id="cb548-8"><a href="#cb548-8" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
+<span id="cb548-9"><a href="#cb548-9" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb548-10"><a href="#cb548-10" aria-hidden="true" tabindex="-1"></a> fencedDivAttributeContextEnd = {<span class="co">%</span></span>
+<span id="cb548-11"><a href="#cb548-11" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
+<span id="cb548-12"><a href="#cb548-12" aria-hidden="true" tabindex="-1"></a> <span class="fu">\emph</span>{(The end of a fenced div attribute context)}</span>
+<span id="cb548-13"><a href="#cb548-13" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
+<span id="cb548-14"><a href="#cb548-14" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb548-15"><a href="#cb548-15" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb548-16"><a href="#cb548-16" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb548-17"><a href="#cb548-17" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb548-18"><a href="#cb548-18" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb548-19"><a href="#cb548-19" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb548-20"><a href="#cb548-20" aria-hidden="true" tabindex="-1"></a>::: {key=value}</span>
+<span id="cb548-21"><a href="#cb548-21" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb548-22"><a href="#cb548-22" aria-hidden="true" tabindex="-1"></a>foo</span>
+<span id="cb548-23"><a href="#cb548-23" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb548-24"><a href="#cb548-24" aria-hidden="true" tabindex="-1"></a>:::: {#identifier}</span>
+<span id="cb548-25"><a href="#cb548-25" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb548-26"><a href="#cb548-26" aria-hidden="true" tabindex="-1"></a>bar</span>
+<span id="cb548-27"><a href="#cb548-27" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb548-28"><a href="#cb548-28" aria-hidden="true" tabindex="-1"></a>::::</span>
+<span id="cb548-29"><a href="#cb548-29" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb548-30"><a href="#cb548-30" aria-hidden="true" tabindex="-1"></a>:::</span>
+<span id="cb548-31"><a href="#cb548-31" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb548-32"><a href="#cb548-32" aria-hidden="true" tabindex="-1"></a>::: {.class_name}</span>
+<span id="cb548-33"><a href="#cb548-33" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb548-34"><a href="#cb548-34" aria-hidden="true" tabindex="-1"></a>baz</span>
+<span id="cb548-35"><a href="#cb548-35" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb548-36"><a href="#cb548-36" aria-hidden="true" tabindex="-1"></a>:::</span>
+<span id="cb548-37"><a href="#cb548-37" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb548-38"><a href="#cb548-38" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb548-39"><a href="#cb548-39" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb546"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb546-1"><a href="#cb546-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb549"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb549-1"><a href="#cb549-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -10126,48 +10220,48 @@ contain the following text:</p>
class="header-section-number">2.3.1.15</span> Header Attribute Context
Renderers</h4>
<p>The following macros are only produced, when the
-<strong><code>autoIdentifiers</code></strong>,
-<strong><code>gfmAutoIdentifiers</code></strong>, or
-<strong><code>headerAttributes</code></strong> options are enabled.</p>
-<p>The <code>\markdownRendererHeaderAttributeContextBegin</code> and
-<code>\markdownRendererHeaderAttributeContextEnd</code> macros represent
+<code><strong>autoIdentifiers</strong></code>,
+<code><strong>gfmAutoIdentifiers</strong></code>, or
+<code><strong>headerAttributes</strong></code> options are enabled.</p>
+<p>The <code>markdownRendererHeaderAttributeContextBegin</code> and
+<code>markdownRendererHeaderAttributeContextEnd</code> macros represent
the beginning and the end of a context in which the attributes of a
heading apply. The macros receive no arguments.</p>
<h5 class="unnumbered" id="latex-example-71"><span
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb547"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb547-1"><a href="#cb547-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb547-2"><a href="#cb547-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[headerAttributes]{<span class="ex">markdown</span>}</span>
-<span id="cb547-3"><a href="#cb547-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb547-4"><a href="#cb547-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb547-5"><a href="#cb547-5" aria-hidden="true" tabindex="-1"></a> headerAttributeContextBegin = {<span class="co">%</span></span>
-<span id="cb547-6"><a href="#cb547-6" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
-<span id="cb547-7"><a href="#cb547-7" aria-hidden="true" tabindex="-1"></a> <span class="fu">\emph</span>{(The beginning of a header attribute context)}</span>
-<span id="cb547-8"><a href="#cb547-8" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
-<span id="cb547-9"><a href="#cb547-9" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb547-10"><a href="#cb547-10" aria-hidden="true" tabindex="-1"></a> headerAttributeContextEnd = {<span class="co">%</span></span>
-<span id="cb547-11"><a href="#cb547-11" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
-<span id="cb547-12"><a href="#cb547-12" aria-hidden="true" tabindex="-1"></a> <span class="fu">\emph</span>{(The end of a header attribute context)}</span>
-<span id="cb547-13"><a href="#cb547-13" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
-<span id="cb547-14"><a href="#cb547-14" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb547-15"><a href="#cb547-15" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb547-16"><a href="#cb547-16" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb547-17"><a href="#cb547-17" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb547-18"><a href="#cb547-18" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb547-19"><a href="#cb547-19" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb547-20"><a href="#cb547-20" aria-hidden="true" tabindex="-1"></a># First top-level heading</span>
-<span id="cb547-21"><a href="#cb547-21" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb547-22"><a href="#cb547-22" aria-hidden="true" tabindex="-1"></a>## A subheading {#identifier}</span>
-<span id="cb547-23"><a href="#cb547-23" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb547-24"><a href="#cb547-24" aria-hidden="true" tabindex="-1"></a># Second top-level heading {.class_name}</span>
-<span id="cb547-25"><a href="#cb547-25" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb547-26"><a href="#cb547-26" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb547-27"><a href="#cb547-27" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb550"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb550-1"><a href="#cb550-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb550-2"><a href="#cb550-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[headerAttributes]{<span class="ex">markdown</span>}</span>
+<span id="cb550-3"><a href="#cb550-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb550-4"><a href="#cb550-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb550-5"><a href="#cb550-5" aria-hidden="true" tabindex="-1"></a> headerAttributeContextBegin = {<span class="co">%</span></span>
+<span id="cb550-6"><a href="#cb550-6" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
+<span id="cb550-7"><a href="#cb550-7" aria-hidden="true" tabindex="-1"></a> <span class="fu">\emph</span>{(The beginning of a header attribute context)}</span>
+<span id="cb550-8"><a href="#cb550-8" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
+<span id="cb550-9"><a href="#cb550-9" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb550-10"><a href="#cb550-10" aria-hidden="true" tabindex="-1"></a> headerAttributeContextEnd = {<span class="co">%</span></span>
+<span id="cb550-11"><a href="#cb550-11" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
+<span id="cb550-12"><a href="#cb550-12" aria-hidden="true" tabindex="-1"></a> <span class="fu">\emph</span>{(The end of a header attribute context)}</span>
+<span id="cb550-13"><a href="#cb550-13" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
+<span id="cb550-14"><a href="#cb550-14" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb550-15"><a href="#cb550-15" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb550-16"><a href="#cb550-16" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb550-17"><a href="#cb550-17" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb550-18"><a href="#cb550-18" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb550-19"><a href="#cb550-19" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb550-20"><a href="#cb550-20" aria-hidden="true" tabindex="-1"></a># First top-level heading</span>
+<span id="cb550-21"><a href="#cb550-21" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb550-22"><a href="#cb550-22" aria-hidden="true" tabindex="-1"></a>## A subheading {#identifier}</span>
+<span id="cb550-23"><a href="#cb550-23" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb550-24"><a href="#cb550-24" aria-hidden="true" tabindex="-1"></a># Second top-level heading {.class_name}</span>
+<span id="cb550-25"><a href="#cb550-25" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb550-26"><a href="#cb550-26" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb550-27"><a href="#cb550-27" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb548"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb548-1"><a href="#cb548-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb551"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb551-1"><a href="#cb551-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -10181,48 +10275,48 @@ contain the following text:</p>
</blockquote>
<h4 data-number="2.3.1.16" id="heading-renderers"><span
class="header-section-number">2.3.1.16</span> Heading Renderers</h4>
-<p>The <code>\markdownRendererHeadingOne</code> macro represents a first
+<p>The <code>markdownRendererHeadingOne</code> macro represents a first
level heading. The macro receives a single argument that corresponds to
the heading text.</p>
-<p>The <code>\markdownRendererHeadingTwo</code> macro represents a
-second level heading. The macro receives a single argument that
-corresponds to the heading text.</p>
-<p>The <code>\markdownRendererHeadingThree</code> macro represents a
+<p>The <code>markdownRendererHeadingTwo</code> macro represents a second
+level heading. The macro receives a single argument that corresponds to
+the heading text.</p>
+<p>The <code>markdownRendererHeadingThree</code> macro represents a
third level heading. The macro receives a single argument that
corresponds to the heading text.</p>
-<p>The <code>\markdownRendererHeadingFour</code> macro represents a
+<p>The <code>markdownRendererHeadingFour</code> macro represents a
fourth level heading. The macro receives a single argument that
corresponds to the heading text.</p>
-<p>The <code>\markdownRendererHeadingFive</code> macro represents a
-fifth level heading. The macro receives a single argument that
-corresponds to the heading text.</p>
-<p>The <code>\markdownRendererHeadingSix</code> macro represents a sixth
+<p>The <code>markdownRendererHeadingFive</code> macro represents a fifth
+level heading. The macro receives a single argument that corresponds to
+the heading text.</p>
+<p>The <code>markdownRendererHeadingSix</code> macro represents a sixth
level heading. The macro receives a single argument that corresponds to
the heading text.</p>
<h5 class="unnumbered" id="plain-tex-example-32">Plain <span
class="tex">T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb549"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb549-1"><a href="#cb549-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
-<span id="cb549-2"><a href="#cb549-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{}</span>
-<span id="cb549-3"><a href="#cb549-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererHeadingOne</span>{1}</span>
-<span id="cb549-4"><a href="#cb549-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererHeadingTwo</span>{2}</span>
-<span id="cb549-5"><a href="#cb549-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererHeadingThree</span>{3}</span>
-<span id="cb549-6"><a href="#cb549-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererHeadingFour</span>{4}</span>
-<span id="cb549-7"><a href="#cb549-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererHeadingFive</span>{5}</span>
-<span id="cb549-8"><a href="#cb549-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererHeadingSix</span>{6}</span>
-<span id="cb549-9"><a href="#cb549-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
-<span id="cb549-10"><a href="#cb549-10" aria-hidden="true" tabindex="-1"></a>######</span>
-<span id="cb549-11"><a href="#cb549-11" aria-hidden="true" tabindex="-1"></a>#####</span>
-<span id="cb549-12"><a href="#cb549-12" aria-hidden="true" tabindex="-1"></a>#####</span>
-<span id="cb549-13"><a href="#cb549-13" aria-hidden="true" tabindex="-1"></a>###</span>
-<span id="cb549-14"><a href="#cb549-14" aria-hidden="true" tabindex="-1"></a>######</span>
-<span id="cb549-15"><a href="#cb549-15" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
-<span id="cb549-16"><a href="#cb549-16" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb552"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb552-1"><a href="#cb552-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
+<span id="cb552-2"><a href="#cb552-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{}</span>
+<span id="cb552-3"><a href="#cb552-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererHeadingOne</span>{1}</span>
+<span id="cb552-4"><a href="#cb552-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererHeadingTwo</span>{2}</span>
+<span id="cb552-5"><a href="#cb552-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererHeadingThree</span>{3}</span>
+<span id="cb552-6"><a href="#cb552-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererHeadingFour</span>{4}</span>
+<span id="cb552-7"><a href="#cb552-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererHeadingFive</span>{5}</span>
+<span id="cb552-8"><a href="#cb552-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererHeadingSix</span>{6}</span>
+<span id="cb552-9"><a href="#cb552-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
+<span id="cb552-10"><a href="#cb552-10" aria-hidden="true" tabindex="-1"></a>######</span>
+<span id="cb552-11"><a href="#cb552-11" aria-hidden="true" tabindex="-1"></a>#####</span>
+<span id="cb552-12"><a href="#cb552-12" aria-hidden="true" tabindex="-1"></a>#####</span>
+<span id="cb552-13"><a href="#cb552-13" aria-hidden="true" tabindex="-1"></a>###</span>
+<span id="cb552-14"><a href="#cb552-14" aria-hidden="true" tabindex="-1"></a>######</span>
+<span id="cb552-15"><a href="#cb552-15" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
+<span id="cb552-16"><a href="#cb552-16" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb550"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb550-1"><a href="#cb550-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb553"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb553-1"><a href="#cb553-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -10232,32 +10326,32 @@ contain the following text:</p>
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb551"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb551-1"><a href="#cb551-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb551-2"><a href="#cb551-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span>
-<span id="cb551-3"><a href="#cb551-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb551-4"><a href="#cb551-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb551-5"><a href="#cb551-5" aria-hidden="true" tabindex="-1"></a> interblockSeparator = {},</span>
-<span id="cb551-6"><a href="#cb551-6" aria-hidden="true" tabindex="-1"></a> headingOne = 1,</span>
-<span id="cb551-7"><a href="#cb551-7" aria-hidden="true" tabindex="-1"></a> headingTwo = 2,</span>
-<span id="cb551-8"><a href="#cb551-8" aria-hidden="true" tabindex="-1"></a> headingThree = 3,</span>
-<span id="cb551-9"><a href="#cb551-9" aria-hidden="true" tabindex="-1"></a> headingFour = 4,</span>
-<span id="cb551-10"><a href="#cb551-10" aria-hidden="true" tabindex="-1"></a> headingFive = 5,</span>
-<span id="cb551-11"><a href="#cb551-11" aria-hidden="true" tabindex="-1"></a> headingSix = 6,</span>
-<span id="cb551-12"><a href="#cb551-12" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb551-13"><a href="#cb551-13" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb551-14"><a href="#cb551-14" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb551-15"><a href="#cb551-15" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb551-16"><a href="#cb551-16" aria-hidden="true" tabindex="-1"></a>######</span>
-<span id="cb551-17"><a href="#cb551-17" aria-hidden="true" tabindex="-1"></a>#####</span>
-<span id="cb551-18"><a href="#cb551-18" aria-hidden="true" tabindex="-1"></a>#####</span>
-<span id="cb551-19"><a href="#cb551-19" aria-hidden="true" tabindex="-1"></a>###</span>
-<span id="cb551-20"><a href="#cb551-20" aria-hidden="true" tabindex="-1"></a>######</span>
-<span id="cb551-21"><a href="#cb551-21" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb551-22"><a href="#cb551-22" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb554"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb554-1"><a href="#cb554-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb554-2"><a href="#cb554-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span>
+<span id="cb554-3"><a href="#cb554-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb554-4"><a href="#cb554-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb554-5"><a href="#cb554-5" aria-hidden="true" tabindex="-1"></a> interblockSeparator = {},</span>
+<span id="cb554-6"><a href="#cb554-6" aria-hidden="true" tabindex="-1"></a> headingOne = 1,</span>
+<span id="cb554-7"><a href="#cb554-7" aria-hidden="true" tabindex="-1"></a> headingTwo = 2,</span>
+<span id="cb554-8"><a href="#cb554-8" aria-hidden="true" tabindex="-1"></a> headingThree = 3,</span>
+<span id="cb554-9"><a href="#cb554-9" aria-hidden="true" tabindex="-1"></a> headingFour = 4,</span>
+<span id="cb554-10"><a href="#cb554-10" aria-hidden="true" tabindex="-1"></a> headingFive = 5,</span>
+<span id="cb554-11"><a href="#cb554-11" aria-hidden="true" tabindex="-1"></a> headingSix = 6,</span>
+<span id="cb554-12"><a href="#cb554-12" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb554-13"><a href="#cb554-13" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb554-14"><a href="#cb554-14" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb554-15"><a href="#cb554-15" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb554-16"><a href="#cb554-16" aria-hidden="true" tabindex="-1"></a>######</span>
+<span id="cb554-17"><a href="#cb554-17" aria-hidden="true" tabindex="-1"></a>#####</span>
+<span id="cb554-18"><a href="#cb554-18" aria-hidden="true" tabindex="-1"></a>#####</span>
+<span id="cb554-19"><a href="#cb554-19" aria-hidden="true" tabindex="-1"></a>###</span>
+<span id="cb554-20"><a href="#cb554-20" aria-hidden="true" tabindex="-1"></a>######</span>
+<span id="cb554-21"><a href="#cb554-21" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb554-22"><a href="#cb554-22" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb552"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb552-1"><a href="#cb552-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb555"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb555-1"><a href="#cb555-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -10267,27 +10361,27 @@ contain the following text:</p>
class="tex">T<sub>e</sub>X</span>t Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb553"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb553-1"><a href="#cb553-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
-<span id="cb553-2"><a href="#cb553-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{}</span>
-<span id="cb553-3"><a href="#cb553-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererHeadingOne</span>{1}</span>
-<span id="cb553-4"><a href="#cb553-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererHeadingTwo</span>{2}</span>
-<span id="cb553-5"><a href="#cb553-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererHeadingThree</span>{3}</span>
-<span id="cb553-6"><a href="#cb553-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererHeadingFour</span>{4}</span>
-<span id="cb553-7"><a href="#cb553-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererHeadingFive</span>{5}</span>
-<span id="cb553-8"><a href="#cb553-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererHeadingSix</span>{6}</span>
-<span id="cb553-9"><a href="#cb553-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
-<span id="cb553-10"><a href="#cb553-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb553-11"><a href="#cb553-11" aria-hidden="true" tabindex="-1"></a>######</span>
-<span id="cb553-12"><a href="#cb553-12" aria-hidden="true" tabindex="-1"></a>#####</span>
-<span id="cb553-13"><a href="#cb553-13" aria-hidden="true" tabindex="-1"></a>#####</span>
-<span id="cb553-14"><a href="#cb553-14" aria-hidden="true" tabindex="-1"></a>###</span>
-<span id="cb553-15"><a href="#cb553-15" aria-hidden="true" tabindex="-1"></a>######</span>
-<span id="cb553-16"><a href="#cb553-16" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb553-17"><a href="#cb553-17" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
+<div class="sourceCode" id="cb556"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb556-1"><a href="#cb556-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
+<span id="cb556-2"><a href="#cb556-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{}</span>
+<span id="cb556-3"><a href="#cb556-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererHeadingOne</span>{1}</span>
+<span id="cb556-4"><a href="#cb556-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererHeadingTwo</span>{2}</span>
+<span id="cb556-5"><a href="#cb556-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererHeadingThree</span>{3}</span>
+<span id="cb556-6"><a href="#cb556-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererHeadingFour</span>{4}</span>
+<span id="cb556-7"><a href="#cb556-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererHeadingFive</span>{5}</span>
+<span id="cb556-8"><a href="#cb556-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererHeadingSix</span>{6}</span>
+<span id="cb556-9"><a href="#cb556-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
+<span id="cb556-10"><a href="#cb556-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb556-11"><a href="#cb556-11" aria-hidden="true" tabindex="-1"></a>######</span>
+<span id="cb556-12"><a href="#cb556-12" aria-hidden="true" tabindex="-1"></a>#####</span>
+<span id="cb556-13"><a href="#cb556-13" aria-hidden="true" tabindex="-1"></a>#####</span>
+<span id="cb556-14"><a href="#cb556-14" aria-hidden="true" tabindex="-1"></a>###</span>
+<span id="cb556-15"><a href="#cb556-15" aria-hidden="true" tabindex="-1"></a>######</span>
+<span id="cb556-16"><a href="#cb556-16" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb556-17"><a href="#cb556-17" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb554"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb554-1"><a href="#cb554-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb557"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb557-1"><a href="#cb557-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -10296,35 +10390,35 @@ contain the following text:</p>
<h4 data-number="2.3.1.17" id="inline-html-comment-renderer"><span
class="header-section-number">2.3.1.17</span> Inline HTML Comment
Renderer</h4>
-<p>The <code>\markdownRendererInlineHtmlComment</code> macro represents
+<p>The <code>markdownRendererInlineHtmlComment</code> macro represents
the contents of an inline <abbr>HTML</abbr> comment. This macro will
-only be produced, when the <strong><code>html</code></strong> option is
+only be produced, when the <code><strong>html</strong></code> option is
enabled. The macro receives a single argument that corresponds to the
contents of the <abbr>HTML</abbr> comment.</p>
<h5 class="unnumbered" id="latex-example-73"><span
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb555"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb555-1"><a href="#cb555-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb555-2"><a href="#cb555-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[html]{<span class="ex">markdown</span>}</span>
-<span id="cb555-3"><a href="#cb555-3" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">marginnote</span>}</span>
-<span id="cb555-4"><a href="#cb555-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb555-5"><a href="#cb555-5" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb555-6"><a href="#cb555-6" aria-hidden="true" tabindex="-1"></a> inlineHtmlComment = {<span class="fu">\marginnote</span>{#1}},</span>
-<span id="cb555-7"><a href="#cb555-7" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb555-8"><a href="#cb555-8" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb555-9"><a href="#cb555-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb555-10"><a href="#cb555-10" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb555-11"><a href="#cb555-11" aria-hidden="true" tabindex="-1"></a>A useful use of inline HTML comments are side notes.</span>
-<span id="cb555-12"><a href="#cb555-12" aria-hidden="true" tabindex="-1"></a>&lt;!-- Side notes are displayed in the horizontal margins next to the relevant</span>
-<span id="cb555-13"><a href="#cb555-13" aria-hidden="true" tabindex="-1"></a>passages, which makes them *easier for the reader to find* than notes. --&gt;</span>
-<span id="cb555-14"><a href="#cb555-14" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb555-15"><a href="#cb555-15" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
-<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb556"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb556-1"><a href="#cb556-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span>
-<span id="cb556-2"><a href="#cb556-2" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb558"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb558-1"><a href="#cb558-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb558-2"><a href="#cb558-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[html]{<span class="ex">markdown</span>}</span>
+<span id="cb558-3"><a href="#cb558-3" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">marginnote</span>}</span>
+<span id="cb558-4"><a href="#cb558-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb558-5"><a href="#cb558-5" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb558-6"><a href="#cb558-6" aria-hidden="true" tabindex="-1"></a> inlineHtmlComment = {<span class="fu">\marginnote</span>{#1}},</span>
+<span id="cb558-7"><a href="#cb558-7" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb558-8"><a href="#cb558-8" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb558-9"><a href="#cb558-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb558-10"><a href="#cb558-10" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb558-11"><a href="#cb558-11" aria-hidden="true" tabindex="-1"></a>A useful use of inline HTML comments are side notes.</span>
+<span id="cb558-12"><a href="#cb558-12" aria-hidden="true" tabindex="-1"></a>&lt;!-- Side notes are displayed in the horizontal margins next to the relevant</span>
+<span id="cb558-13"><a href="#cb558-13" aria-hidden="true" tabindex="-1"></a>passages, which makes them *easier for the reader to find* than notes. --&gt;</span>
+<span id="cb558-14"><a href="#cb558-14" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb558-15"><a href="#cb558-15" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<p>Next, invoke LuaTeX from the terminal:</p>
+<div class="sourceCode" id="cb559"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb559-1"><a href="#cb559-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span>
+<span id="cb559-2"><a href="#cb559-2" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following body text:</p>
<blockquote>
@@ -10339,42 +10433,42 @@ find</em> than notes.</p>
<h4 data-number="2.3.1.18" id="html-tag-and-element-renderers"><span
class="header-section-number">2.3.1.18</span> HTML Tag and Element
Renderers</h4>
-<p>The <code>\markdownRendererInlineHtmlTag</code> macro represents an
+<p>The <code>markdownRendererInlineHtmlTag</code> macro represents an
opening, closing, or empty inline <abbr>HTML</abbr> tag. This macro will
-only be produced, when the <strong><code>html</code></strong> option is
+only be produced, when the <code><strong>html</strong></code> option is
enabled. The macro receives a single argument that corresponds to the
contents of the <abbr>HTML</abbr> tag.</p>
-<p>The <code>\markdownRendererInputBlockHtmlElement</code> macro
+<p>The <code>markdownRendererInputBlockHtmlElement</code> macro
represents a block <abbr>HTML</abbr> element. This macro will only be
-produced, when the <strong><code>html</code></strong> option is enabled.
+produced, when the <code><strong>html</strong></code> option is enabled.
The macro receives a single argument that filename of a file containing
the contents of the <abbr>HTML</abbr> element.</p>
<h5 class="unnumbered" id="latex-example-74"><span
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb557"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb557-1"><a href="#cb557-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb557-2"><a href="#cb557-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[html]{<span class="ex">markdown</span>}</span>
-<span id="cb557-3"><a href="#cb557-3" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">marginnote</span>}</span>
-<span id="cb557-4"><a href="#cb557-4" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">verbatim</span>}</span>
-<span id="cb557-5"><a href="#cb557-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb557-6"><a href="#cb557-6" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb557-7"><a href="#cb557-7" aria-hidden="true" tabindex="-1"></a> inlineHtmlTag = {<span class="fu">\textbf</span>{#1}},</span>
-<span id="cb557-8"><a href="#cb557-8" aria-hidden="true" tabindex="-1"></a> inputBlockHtmlElement = {<span class="fu">\verbatiminput</span>{#1}},</span>
-<span id="cb557-9"><a href="#cb557-9" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb557-10"><a href="#cb557-10" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb557-11"><a href="#cb557-11" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb557-12"><a href="#cb557-12" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb557-13"><a href="#cb557-13" aria-hidden="true" tabindex="-1"></a>&lt;b&gt;_Hello,_ world!&lt;/b&gt;&lt;br/&gt;</span>
-<span id="cb557-14"><a href="#cb557-14" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb557-15"><a href="#cb557-15" aria-hidden="true" tabindex="-1"></a>&lt;div&gt;_Hello,_ world!&lt;/div&gt;</span>
-<span id="cb557-16"><a href="#cb557-16" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb557-17"><a href="#cb557-17" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb560"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb560-1"><a href="#cb560-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb560-2"><a href="#cb560-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[html]{<span class="ex">markdown</span>}</span>
+<span id="cb560-3"><a href="#cb560-3" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">marginnote</span>}</span>
+<span id="cb560-4"><a href="#cb560-4" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">verbatim</span>}</span>
+<span id="cb560-5"><a href="#cb560-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb560-6"><a href="#cb560-6" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb560-7"><a href="#cb560-7" aria-hidden="true" tabindex="-1"></a> inlineHtmlTag = {<span class="fu">\textbf</span>{#1}},</span>
+<span id="cb560-8"><a href="#cb560-8" aria-hidden="true" tabindex="-1"></a> inputBlockHtmlElement = {<span class="fu">\verbatiminput</span>{#1}},</span>
+<span id="cb560-9"><a href="#cb560-9" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb560-10"><a href="#cb560-10" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb560-11"><a href="#cb560-11" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb560-12"><a href="#cb560-12" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb560-13"><a href="#cb560-13" aria-hidden="true" tabindex="-1"></a>&lt;b&gt;_Hello,_ world!&lt;/b&gt;&lt;br/&gt;</span>
+<span id="cb560-14"><a href="#cb560-14" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb560-15"><a href="#cb560-15" aria-hidden="true" tabindex="-1"></a>&lt;div&gt;_Hello,_ world!&lt;/div&gt;</span>
+<span id="cb560-16"><a href="#cb560-16" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb560-17"><a href="#cb560-17" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb558"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb558-1"><a href="#cb558-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span>
-<span id="cb558-2"><a href="#cb558-2" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb561"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb561-1"><a href="#cb561-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span>
+<span id="cb561-2"><a href="#cb561-2" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following body text:</p>
<blockquote>
@@ -10383,7 +10477,7 @@ contain the following body text:</p>
</blockquote>
<h4 data-number="2.3.1.19" id="image-renderer"><span
class="header-section-number">2.3.1.19</span> Image Renderer</h4>
-<p>The <code>\markdownRendererImage</code> macro represents an image. It
+<p>The <code>markdownRendererImage</code> macro represents an image. It
receives four arguments: the label, the fully escaped <abbr>uri</abbr>
that can be directly typeset, the raw <abbr>uri</abbr> that can be used
outside typesetting, and the title of the link.</p>
@@ -10391,44 +10485,44 @@ outside typesetting, and the title of the link.</p>
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb560"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb560-1"><a href="#cb560-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb560-2"><a href="#cb560-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span>
-<span id="cb560-3"><a href="#cb560-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\begingroup</span></span>
-<span id="cb560-4"><a href="#cb560-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\catcode</span>`<span class="fu">\@</span>=11</span>
-<span id="cb560-5"><a href="#cb560-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\catcode</span>`<span class="fu">\%</span>=12</span>
-<span id="cb560-6"><a href="#cb560-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\catcode</span>`<span class="fu">\^</span>^A=14</span>
-<span id="cb560-7"><a href="#cb560-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\global\def\markdownRendererImage</span>#1#2#3#4{^^A</span>
-<span id="cb560-8"><a href="#cb560-8" aria-hidden="true" tabindex="-1"></a> <span class="fu">\immediate\write</span>18{^^A</span></code></pre></div>
-<div class="sourceCode" id="cb561"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb561-1"><a href="#cb561-1" aria-hidden="true" tabindex="-1"></a> <span class="cf">if</span> <span class="bu">printf</span> <span class="st">&#39;%s&#39;</span> <span class="st">&quot;#3&quot;</span> <span class="kw">|</span> <span class="fu">grep</span> <span class="at">-q</span> ^http<span class="kw">;</span> <span class="cf">then</span></span>
-<span id="cb561-2"><a href="#cb561-2" aria-hidden="true" tabindex="-1"></a> <span class="va">OUTPUT</span><span class="op">=</span><span class="st">&quot;</span><span class="va">$(</span><span class="bu">printf</span> <span class="st">&#39;%s&#39;</span> <span class="st">&quot;#3&quot;</span> <span class="kw">|</span> <span class="fu">md5sum</span> <span class="kw">|</span> <span class="fu">cut</span> <span class="at">-d</span><span class="st">&#39; &#39;</span> <span class="at">-f1</span><span class="va">)</span><span class="st">.^^A</span></span>
-<span id="cb561-3"><a href="#cb561-3" aria-hidden="true" tabindex="-1"></a><span class="st"> </span><span class="va">$(</span><span class="bu">printf</span> <span class="st">&#39;%s&#39;</span> <span class="st">&quot;#3&quot;</span> <span class="kw">|</span> <span class="fu">sed</span> <span class="st">&#39;s/.*[.]//&#39;</span><span class="va">)</span><span class="st">&quot;</span><span class="kw">;</span></span>
-<span id="cb561-4"><a href="#cb561-4" aria-hidden="true" tabindex="-1"></a> <span class="cf">if</span> <span class="ot">! </span><span class="bu">[</span> <span class="ot">-e</span> <span class="st">&quot;</span><span class="va">$OUTPUT</span><span class="st">&quot;</span> <span class="bu">]</span><span class="kw">;</span> <span class="cf">then</span></span>
-<span id="cb561-5"><a href="#cb561-5" aria-hidden="true" tabindex="-1"></a> <span class="fu">wget</span> <span class="at">-O</span> <span class="st">&quot;</span><span class="va">$OUTPUT</span><span class="st">&quot;</span> <span class="st">&#39;#3&#39;</span> <span class="kw">||</span> <span class="fu">rm</span> <span class="st">&quot;</span><span class="va">$OUTPUT</span><span class="st">&quot;</span><span class="kw">;</span></span>
-<span id="cb561-6"><a href="#cb561-6" aria-hidden="true" tabindex="-1"></a> <span class="ex">convert</span> <span class="st">&quot;</span><span class="va">$OUTPUT</span><span class="st">&quot;</span> png:<span class="st">&quot;</span><span class="va">$OUTPUT</span><span class="st">&quot;</span><span class="kw">;</span></span>
-<span id="cb561-7"><a href="#cb561-7" aria-hidden="true" tabindex="-1"></a> <span class="cf">fi</span><span class="kw">;</span></span>
-<span id="cb561-8"><a href="#cb561-8" aria-hidden="true" tabindex="-1"></a> <span class="bu">printf</span> <span class="st">&#39;%s%%&#39;</span> <span class="st">&quot;</span><span class="va">$OUTPUT</span><span class="st">&quot;</span> <span class="op">&gt;</span> <span class="dt">\j</span>obname.fetched<span class="kw">;</span></span>
-<span id="cb561-9"><a href="#cb561-9" aria-hidden="true" tabindex="-1"></a> <span class="cf">else</span></span>
-<span id="cb561-10"><a href="#cb561-10" aria-hidden="true" tabindex="-1"></a> <span class="bu">printf</span> <span class="st">&#39;%s%%&#39;</span> <span class="st">&quot;#3&quot;</span> <span class="op">&gt;</span> <span class="dt">\j</span>obname.fetched<span class="kw">;</span></span>
-<span id="cb561-11"><a href="#cb561-11" aria-hidden="true" tabindex="-1"></a> <span class="ex">fi^^A</span></span></code></pre></div>
-<div class="sourceCode" id="cb562"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb562-1"><a href="#cb562-1" aria-hidden="true" tabindex="-1"></a> }^^A</span>
-<span id="cb562-2"><a href="#cb562-2" aria-hidden="true" tabindex="-1"></a> {^^A</span>
-<span id="cb562-3"><a href="#cb562-3" aria-hidden="true" tabindex="-1"></a> <span class="fu">\everyeof</span>={<span class="fu">\noexpand</span>}^^A</span>
-<span id="cb562-4"><a href="#cb562-4" aria-hidden="true" tabindex="-1"></a> <span class="fu">\edef\filename</span>{<span class="fu">\@@input</span>&quot;<span class="fu">\jobname</span>.fetched&quot; }^^A</span>
-<span id="cb562-5"><a href="#cb562-5" aria-hidden="true" tabindex="-1"></a> <span class="bu">\includegraphics</span>[width=<span class="fu">\textwidth</span>]{<span class="fu">\filename</span>}^^A</span>
-<span id="cb562-6"><a href="#cb562-6" aria-hidden="true" tabindex="-1"></a> }^^A</span>
-<span id="cb562-7"><a href="#cb562-7" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb562-8"><a href="#cb562-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\endgroup</span></span>
-<span id="cb562-9"><a href="#cb562-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb562-10"><a href="#cb562-10" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb562-11"><a href="#cb562-11" aria-hidden="true" tabindex="-1"></a>![TUGboat](https://tug.org/tugboat/noword.jpg)</span>
-<span id="cb562-12"><a href="#cb562-12" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb562-13"><a href="#cb562-13" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
-<p>Next, invoke LuaTeX from the terminal:</p>
<div class="sourceCode" id="cb563"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb563-1"><a href="#cb563-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> <span class="at">--shell-escape</span> document.tex</span></code></pre></div>
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb563-1"><a href="#cb563-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb563-2"><a href="#cb563-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span>
+<span id="cb563-3"><a href="#cb563-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\begingroup</span></span>
+<span id="cb563-4"><a href="#cb563-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\catcode</span>`<span class="fu">\@</span>=11</span>
+<span id="cb563-5"><a href="#cb563-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\catcode</span>`<span class="fu">\%</span>=12</span>
+<span id="cb563-6"><a href="#cb563-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\catcode</span>`<span class="fu">\^</span>^A=14</span>
+<span id="cb563-7"><a href="#cb563-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\global\def\markdownRendererImage</span>#1#2#3#4{^^A</span>
+<span id="cb563-8"><a href="#cb563-8" aria-hidden="true" tabindex="-1"></a> <span class="fu">\immediate\write</span>18{^^A</span></code></pre></div>
+<div class="sourceCode" id="cb564"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb564-1"><a href="#cb564-1" aria-hidden="true" tabindex="-1"></a> <span class="cf">if</span> <span class="bu">printf</span> <span class="st">&#39;%s&#39;</span> <span class="st">&quot;#3&quot;</span> <span class="kw">|</span> <span class="fu">grep</span> <span class="at">-q</span> ^http<span class="kw">;</span> <span class="cf">then</span></span>
+<span id="cb564-2"><a href="#cb564-2" aria-hidden="true" tabindex="-1"></a> <span class="va">OUTPUT</span><span class="op">=</span><span class="st">&quot;</span><span class="va">$(</span><span class="bu">printf</span> <span class="st">&#39;%s&#39;</span> <span class="st">&quot;#3&quot;</span> <span class="kw">|</span> <span class="fu">md5sum</span> <span class="kw">|</span> <span class="fu">cut</span> <span class="at">-d</span><span class="st">&#39; &#39;</span> <span class="at">-f1</span><span class="va">)</span><span class="st">.^^A</span></span>
+<span id="cb564-3"><a href="#cb564-3" aria-hidden="true" tabindex="-1"></a><span class="st"> </span><span class="va">$(</span><span class="bu">printf</span> <span class="st">&#39;%s&#39;</span> <span class="st">&quot;#3&quot;</span> <span class="kw">|</span> <span class="fu">sed</span> <span class="st">&#39;s/.*[.]//&#39;</span><span class="va">)</span><span class="st">&quot;</span><span class="kw">;</span></span>
+<span id="cb564-4"><a href="#cb564-4" aria-hidden="true" tabindex="-1"></a> <span class="cf">if</span> <span class="ot">! </span><span class="bu">[</span> <span class="ot">-e</span> <span class="st">&quot;</span><span class="va">$OUTPUT</span><span class="st">&quot;</span> <span class="bu">]</span><span class="kw">;</span> <span class="cf">then</span></span>
+<span id="cb564-5"><a href="#cb564-5" aria-hidden="true" tabindex="-1"></a> <span class="fu">wget</span> <span class="at">-O</span> <span class="st">&quot;</span><span class="va">$OUTPUT</span><span class="st">&quot;</span> <span class="st">&#39;#3&#39;</span> <span class="kw">||</span> <span class="fu">rm</span> <span class="st">&quot;</span><span class="va">$OUTPUT</span><span class="st">&quot;</span><span class="kw">;</span></span>
+<span id="cb564-6"><a href="#cb564-6" aria-hidden="true" tabindex="-1"></a> <span class="ex">convert</span> <span class="st">&quot;</span><span class="va">$OUTPUT</span><span class="st">&quot;</span> png:<span class="st">&quot;</span><span class="va">$OUTPUT</span><span class="st">&quot;</span><span class="kw">;</span></span>
+<span id="cb564-7"><a href="#cb564-7" aria-hidden="true" tabindex="-1"></a> <span class="cf">fi</span><span class="kw">;</span></span>
+<span id="cb564-8"><a href="#cb564-8" aria-hidden="true" tabindex="-1"></a> <span class="bu">printf</span> <span class="st">&#39;%s%%&#39;</span> <span class="st">&quot;</span><span class="va">$OUTPUT</span><span class="st">&quot;</span> <span class="op">&gt;</span> <span class="dt">\j</span>obname.fetched<span class="kw">;</span></span>
+<span id="cb564-9"><a href="#cb564-9" aria-hidden="true" tabindex="-1"></a> <span class="cf">else</span></span>
+<span id="cb564-10"><a href="#cb564-10" aria-hidden="true" tabindex="-1"></a> <span class="bu">printf</span> <span class="st">&#39;%s%%&#39;</span> <span class="st">&quot;#3&quot;</span> <span class="op">&gt;</span> <span class="dt">\j</span>obname.fetched<span class="kw">;</span></span>
+<span id="cb564-11"><a href="#cb564-11" aria-hidden="true" tabindex="-1"></a> <span class="ex">fi^^A</span></span></code></pre></div>
+<div class="sourceCode" id="cb565"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb565-1"><a href="#cb565-1" aria-hidden="true" tabindex="-1"></a> }^^A</span>
+<span id="cb565-2"><a href="#cb565-2" aria-hidden="true" tabindex="-1"></a> {^^A</span>
+<span id="cb565-3"><a href="#cb565-3" aria-hidden="true" tabindex="-1"></a> <span class="fu">\everyeof</span>={<span class="fu">\noexpand</span>}^^A</span>
+<span id="cb565-4"><a href="#cb565-4" aria-hidden="true" tabindex="-1"></a> <span class="fu">\edef\filename</span>{<span class="fu">\@@input</span>&quot;<span class="fu">\jobname</span>.fetched&quot; }^^A</span>
+<span id="cb565-5"><a href="#cb565-5" aria-hidden="true" tabindex="-1"></a> <span class="bu">\includegraphics</span>[width=<span class="fu">\textwidth</span>]{<span class="fu">\filename</span>}^^A</span>
+<span id="cb565-6"><a href="#cb565-6" aria-hidden="true" tabindex="-1"></a> }^^A</span>
+<span id="cb565-7"><a href="#cb565-7" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb565-8"><a href="#cb565-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\endgroup</span></span>
+<span id="cb565-9"><a href="#cb565-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb565-10"><a href="#cb565-10" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb565-11"><a href="#cb565-11" aria-hidden="true" tabindex="-1"></a>![TUGboat](https://tug.org/tugboat/noword.jpg)</span>
+<span id="cb565-12"><a href="#cb565-12" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb565-13"><a href="#cb565-13" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<p>Next, invoke LuaTeX from the terminal:</p>
+<div class="sourceCode" id="cb566"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb566-1"><a href="#cb566-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> <span class="at">--shell-escape</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following content. This assumes that you use a Unix-like
operating system with Bourne or Bourne again shell as the default shell
@@ -10447,35 +10541,35 @@ title="The Communications of the TeX Users Group" alt="TUGboat" />
class="header-section-number">2.3.1.20</span> Image Attribute Context
Renderers</h4>
<p>The following macros are only produced, when the
-<strong><code>linkAttributes</code></strong> option is enabled.</p>
-<p>The <code>\markdownRendererImageAttributeContextBegin</code> and
-<code>\markdownRendererImageAttributeContextEnd</code> macros represent
+<code><strong>linkAttributes</strong></code> option is enabled.</p>
+<p>The <code>markdownRendererImageAttributeContextBegin</code> and
+<code>markdownRendererImageAttributeContextEnd</code> macros represent
the beginning and the end of a context in which the attributes of an
image apply. The macros receive no arguments.</p>
<h5 class="unnumbered" id="latex-example-76"><span
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb564"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb564-1"><a href="#cb564-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb564-2"><a href="#cb564-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[linkAttributes]{<span class="ex">markdown</span>}</span>
-<span id="cb564-3"><a href="#cb564-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb564-4"><a href="#cb564-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb564-5"><a href="#cb564-5" aria-hidden="true" tabindex="-1"></a> imageAttributeContextBegin = {(},</span>
-<span id="cb564-6"><a href="#cb564-6" aria-hidden="true" tabindex="-1"></a> image = {#1},</span>
-<span id="cb564-7"><a href="#cb564-7" aria-hidden="true" tabindex="-1"></a> imageAttributeContextEnd = {)},</span>
-<span id="cb564-8"><a href="#cb564-8" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb564-9"><a href="#cb564-9" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb564-10"><a href="#cb564-10" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb564-11"><a href="#cb564-11" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb564-12"><a href="#cb564-12" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb564-13"><a href="#cb564-13" aria-hidden="true" tabindex="-1"></a>foo ![bar](#bar){key=value} baz</span>
-<span id="cb564-14"><a href="#cb564-14" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb564-15"><a href="#cb564-15" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb564-16"><a href="#cb564-16" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb567"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb567-1"><a href="#cb567-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb567-2"><a href="#cb567-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[linkAttributes]{<span class="ex">markdown</span>}</span>
+<span id="cb567-3"><a href="#cb567-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb567-4"><a href="#cb567-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb567-5"><a href="#cb567-5" aria-hidden="true" tabindex="-1"></a> imageAttributeContextBegin = {(},</span>
+<span id="cb567-6"><a href="#cb567-6" aria-hidden="true" tabindex="-1"></a> image = {#1},</span>
+<span id="cb567-7"><a href="#cb567-7" aria-hidden="true" tabindex="-1"></a> imageAttributeContextEnd = {)},</span>
+<span id="cb567-8"><a href="#cb567-8" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb567-9"><a href="#cb567-9" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb567-10"><a href="#cb567-10" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb567-11"><a href="#cb567-11" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb567-12"><a href="#cb567-12" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb567-13"><a href="#cb567-13" aria-hidden="true" tabindex="-1"></a>foo ![bar](#bar){key=value} baz</span>
+<span id="cb567-14"><a href="#cb567-14" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb567-15"><a href="#cb567-15" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb567-16"><a href="#cb567-16" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb565"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb565-1"><a href="#cb565-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb568"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb568-1"><a href="#cb568-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -10484,29 +10578,29 @@ contain the following text:</p>
<h4 data-number="2.3.1.21" id="interblock-separator-renderers"><span
class="header-section-number">2.3.1.21</span> Interblock Separator
Renderers</h4>
-<p>The <code>\markdownRendererInterblockSeparator</code> macro
-represents an interblock separator between two markdown block elements.
-The macro receives no arguments.</p>
+<p>The <code>markdownRendererInterblockSeparator</code> macro represents
+an interblock separator between two markdown block elements. The macro
+receives no arguments.</p>
<h5 class="unnumbered" id="plain-tex-example-33">Plain <span
class="tex">T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb566"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb566-1"><a href="#cb566-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
-<span id="cb566-2"><a href="#cb566-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span>
-<span id="cb566-3"><a href="#cb566-3" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
-<span id="cb566-4"><a href="#cb566-4" aria-hidden="true" tabindex="-1"></a> {<span class="fu">\it</span>(The end of a block)}<span class="co">%</span></span>
-<span id="cb566-5"><a href="#cb566-5" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
-<span id="cb566-6"><a href="#cb566-6" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb566-7"><a href="#cb566-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
-<span id="cb566-8"><a href="#cb566-8" aria-hidden="true" tabindex="-1"></a>- Hello *world*!</span>
-<span id="cb566-9"><a href="#cb566-9" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb566-10"><a href="#cb566-10" aria-hidden="true" tabindex="-1"></a>_Foo_ bar!</span>
-<span id="cb566-11"><a href="#cb566-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
-<span id="cb566-12"><a href="#cb566-12" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb569"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb569-1"><a href="#cb569-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
+<span id="cb569-2"><a href="#cb569-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span>
+<span id="cb569-3"><a href="#cb569-3" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
+<span id="cb569-4"><a href="#cb569-4" aria-hidden="true" tabindex="-1"></a> {<span class="fu">\it</span>(The end of a block)}<span class="co">%</span></span>
+<span id="cb569-5"><a href="#cb569-5" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
+<span id="cb569-6"><a href="#cb569-6" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb569-7"><a href="#cb569-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
+<span id="cb569-8"><a href="#cb569-8" aria-hidden="true" tabindex="-1"></a>- Hello *world*!</span>
+<span id="cb569-9"><a href="#cb569-9" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb569-10"><a href="#cb569-10" aria-hidden="true" tabindex="-1"></a>_Foo_ bar!</span>
+<span id="cb569-11"><a href="#cb569-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
+<span id="cb569-12"><a href="#cb569-12" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb567"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb567-1"><a href="#cb567-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb570"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb570-1"><a href="#cb570-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -10520,28 +10614,28 @@ contain the following text:</p>
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb568"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb568-1"><a href="#cb568-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb568-2"><a href="#cb568-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span>
-<span id="cb568-3"><a href="#cb568-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb568-4"><a href="#cb568-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb568-5"><a href="#cb568-5" aria-hidden="true" tabindex="-1"></a> interblockSeparator = {<span class="co">%</span></span>
-<span id="cb568-6"><a href="#cb568-6" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
-<span id="cb568-7"><a href="#cb568-7" aria-hidden="true" tabindex="-1"></a> <span class="fu">\emph</span>{(The end of a block)}<span class="co">%</span></span>
-<span id="cb568-8"><a href="#cb568-8" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
-<span id="cb568-9"><a href="#cb568-9" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb568-10"><a href="#cb568-10" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb568-11"><a href="#cb568-11" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb568-12"><a href="#cb568-12" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb568-13"><a href="#cb568-13" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb568-14"><a href="#cb568-14" aria-hidden="true" tabindex="-1"></a>- Hello *world*!</span>
-<span id="cb568-15"><a href="#cb568-15" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb568-16"><a href="#cb568-16" aria-hidden="true" tabindex="-1"></a>_Foo_ bar!</span>
-<span id="cb568-17"><a href="#cb568-17" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb568-18"><a href="#cb568-18" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb571"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb571-1"><a href="#cb571-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb571-2"><a href="#cb571-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span>
+<span id="cb571-3"><a href="#cb571-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb571-4"><a href="#cb571-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb571-5"><a href="#cb571-5" aria-hidden="true" tabindex="-1"></a> interblockSeparator = {<span class="co">%</span></span>
+<span id="cb571-6"><a href="#cb571-6" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
+<span id="cb571-7"><a href="#cb571-7" aria-hidden="true" tabindex="-1"></a> <span class="fu">\emph</span>{(The end of a block)}<span class="co">%</span></span>
+<span id="cb571-8"><a href="#cb571-8" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
+<span id="cb571-9"><a href="#cb571-9" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb571-10"><a href="#cb571-10" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb571-11"><a href="#cb571-11" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb571-12"><a href="#cb571-12" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb571-13"><a href="#cb571-13" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb571-14"><a href="#cb571-14" aria-hidden="true" tabindex="-1"></a>- Hello *world*!</span>
+<span id="cb571-15"><a href="#cb571-15" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb571-16"><a href="#cb571-16" aria-hidden="true" tabindex="-1"></a>_Foo_ bar!</span>
+<span id="cb571-17"><a href="#cb571-17" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb571-18"><a href="#cb571-18" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb569"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb569-1"><a href="#cb569-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb572"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb572-1"><a href="#cb572-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -10555,23 +10649,23 @@ contain the following text:</p>
class="tex">T<sub>e</sub>X</span>t Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb570"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb570-1"><a href="#cb570-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
-<span id="cb570-2"><a href="#cb570-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span>
-<span id="cb570-3"><a href="#cb570-3" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
-<span id="cb570-4"><a href="#cb570-4" aria-hidden="true" tabindex="-1"></a> <span class="fu">\emph</span>{(The end of a block)}<span class="co">%</span></span>
-<span id="cb570-5"><a href="#cb570-5" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
-<span id="cb570-6"><a href="#cb570-6" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb570-7"><a href="#cb570-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
-<span id="cb570-8"><a href="#cb570-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb570-9"><a href="#cb570-9" aria-hidden="true" tabindex="-1"></a>- Hello *world*!</span>
-<span id="cb570-10"><a href="#cb570-10" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb570-11"><a href="#cb570-11" aria-hidden="true" tabindex="-1"></a>_Foo_ bar!</span>
-<span id="cb570-12"><a href="#cb570-12" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb570-13"><a href="#cb570-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
+<div class="sourceCode" id="cb573"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb573-1"><a href="#cb573-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
+<span id="cb573-2"><a href="#cb573-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span>
+<span id="cb573-3"><a href="#cb573-3" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
+<span id="cb573-4"><a href="#cb573-4" aria-hidden="true" tabindex="-1"></a> <span class="fu">\emph</span>{(The end of a block)}<span class="co">%</span></span>
+<span id="cb573-5"><a href="#cb573-5" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
+<span id="cb573-6"><a href="#cb573-6" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb573-7"><a href="#cb573-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
+<span id="cb573-8"><a href="#cb573-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb573-9"><a href="#cb573-9" aria-hidden="true" tabindex="-1"></a>- Hello *world*!</span>
+<span id="cb573-10"><a href="#cb573-10" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb573-11"><a href="#cb573-11" aria-hidden="true" tabindex="-1"></a>_Foo_ bar!</span>
+<span id="cb573-12"><a href="#cb573-12" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb573-13"><a href="#cb573-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb571"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb571-1"><a href="#cb571-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb574"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb574-1"><a href="#cb574-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -10586,34 +10680,34 @@ indicate the end of a series of blocks that make up a logical paragraph.
This produces a paragraph separator instead of an interblock separator.
Between some blocks, such as markdown paragraphs, a paragraph separator
is always produced.</p>
-<p>The <code>\markdownRendererParagraphSeparator</code> macro represents
+<p>The <code>markdownRendererParagraphSeparator</code> macro represents
a paragraph separator. The macro receives no arguments.</p>
<h5 class="unnumbered" id="latex-example-78"><span
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb572"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb572-1"><a href="#cb572-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb572-2"><a href="#cb572-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span>
-<span id="cb572-3"><a href="#cb572-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb572-4"><a href="#cb572-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb572-5"><a href="#cb572-5" aria-hidden="true" tabindex="-1"></a> paragraphSeparator = {<span class="co">%</span></span>
-<span id="cb572-6"><a href="#cb572-6" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
-<span id="cb572-7"><a href="#cb572-7" aria-hidden="true" tabindex="-1"></a> <span class="fu">\emph</span>{(The end of a paragraph)}<span class="co">%</span></span>
-<span id="cb572-8"><a href="#cb572-8" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
-<span id="cb572-9"><a href="#cb572-9" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb572-10"><a href="#cb572-10" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb572-11"><a href="#cb572-11" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb572-12"><a href="#cb572-12" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb572-13"><a href="#cb572-13" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb572-14"><a href="#cb572-14" aria-hidden="true" tabindex="-1"></a>Hello *world*!</span>
-<span id="cb572-15"><a href="#cb572-15" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb572-16"><a href="#cb572-16" aria-hidden="true" tabindex="-1"></a>_Foo_ bar!</span>
-<span id="cb572-17"><a href="#cb572-17" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb572-18"><a href="#cb572-18" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb575"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb575-1"><a href="#cb575-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb575-2"><a href="#cb575-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span>
+<span id="cb575-3"><a href="#cb575-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb575-4"><a href="#cb575-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb575-5"><a href="#cb575-5" aria-hidden="true" tabindex="-1"></a> paragraphSeparator = {<span class="co">%</span></span>
+<span id="cb575-6"><a href="#cb575-6" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
+<span id="cb575-7"><a href="#cb575-7" aria-hidden="true" tabindex="-1"></a> <span class="fu">\emph</span>{(The end of a paragraph)}<span class="co">%</span></span>
+<span id="cb575-8"><a href="#cb575-8" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
+<span id="cb575-9"><a href="#cb575-9" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb575-10"><a href="#cb575-10" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb575-11"><a href="#cb575-11" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb575-12"><a href="#cb575-12" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb575-13"><a href="#cb575-13" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb575-14"><a href="#cb575-14" aria-hidden="true" tabindex="-1"></a>Hello *world*!</span>
+<span id="cb575-15"><a href="#cb575-15" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb575-16"><a href="#cb575-16" aria-hidden="true" tabindex="-1"></a>_Foo_ bar!</span>
+<span id="cb575-17"><a href="#cb575-17" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb575-18"><a href="#cb575-18" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb573"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb573-1"><a href="#cb573-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb576"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb576-1"><a href="#cb576-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -10624,28 +10718,27 @@ contain the following text:</p>
<h4 data-number="2.3.1.22" id="line-block-renderers"><span
class="header-section-number">2.3.1.22</span> Line Block Renderers</h4>
<p>The following macros are only produced, when the
-<strong><code>lineBlocks</code></strong> option is enabled.</p>
-<p>The <code>\markdownRendererLineBlockBegin</code> and
-<code>\markdownRendererLineBlockEnd</code> macros represent the
-beginning and the end of a line block. The macros receive no
-arguments.</p>
+<code><strong>lineBlocks</strong></code> option is enabled.</p>
+<p>The <code>markdownRendererLineBlockBegin</code> and
+<code>markdownRendererLineBlockEnd</code> macros represent the beginning
+and the end of a line block. The macros receive no arguments.</p>
<h5 class="unnumbered" id="plain-tex-example-34">Plain <span
class="tex">T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb574"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb574-1"><a href="#cb574-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
-<span id="cb574-2"><a href="#cb574-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionLineBlocks</span>{true}</span>
-<span id="cb574-3"><a href="#cb574-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
-<span id="cb574-4"><a href="#cb574-4" aria-hidden="true" tabindex="-1"></a>| I would spread the cloths under your feet:</span>
-<span id="cb574-5"><a href="#cb574-5" aria-hidden="true" tabindex="-1"></a>| But I, being poor, have only my dreams;</span>
-<span id="cb574-6"><a href="#cb574-6" aria-hidden="true" tabindex="-1"></a>| I have spread my dreams under your feet;</span>
-<span id="cb574-7"><a href="#cb574-7" aria-hidden="true" tabindex="-1"></a>| Tread softly because you tread on my dreams.</span>
-<span id="cb574-8"><a href="#cb574-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
-<span id="cb574-9"><a href="#cb574-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb577"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb577-1"><a href="#cb577-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
+<span id="cb577-2"><a href="#cb577-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionLineBlocks</span>{true}</span>
+<span id="cb577-3"><a href="#cb577-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
+<span id="cb577-4"><a href="#cb577-4" aria-hidden="true" tabindex="-1"></a>| I would spread the cloths under your feet:</span>
+<span id="cb577-5"><a href="#cb577-5" aria-hidden="true" tabindex="-1"></a>| But I, being poor, have only my dreams;</span>
+<span id="cb577-6"><a href="#cb577-6" aria-hidden="true" tabindex="-1"></a>| I have spread my dreams under your feet;</span>
+<span id="cb577-7"><a href="#cb577-7" aria-hidden="true" tabindex="-1"></a>| Tread softly because you tread on my dreams.</span>
+<span id="cb577-8"><a href="#cb577-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
+<span id="cb577-9"><a href="#cb577-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb575"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb575-1"><a href="#cb575-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb578"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb578-1"><a href="#cb578-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -10658,20 +10751,20 @@ Tread softly because you tread on my dreams.</div>
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb576"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb576-1"><a href="#cb576-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb576-2"><a href="#cb576-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[lineBlocks]{<span class="ex">markdown</span>}</span>
-<span id="cb576-3"><a href="#cb576-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb576-4"><a href="#cb576-4" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb576-5"><a href="#cb576-5" aria-hidden="true" tabindex="-1"></a>| I would spread the cloths under your feet:</span>
-<span id="cb576-6"><a href="#cb576-6" aria-hidden="true" tabindex="-1"></a>| But I, being poor, have only my dreams;</span>
-<span id="cb576-7"><a href="#cb576-7" aria-hidden="true" tabindex="-1"></a>| I have spread my dreams under your feet;</span>
-<span id="cb576-8"><a href="#cb576-8" aria-hidden="true" tabindex="-1"></a>| Tread softly because you tread on my dreams.</span>
-<span id="cb576-9"><a href="#cb576-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb576-10"><a href="#cb576-10" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb579"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb579-1"><a href="#cb579-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb579-2"><a href="#cb579-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[lineBlocks]{<span class="ex">markdown</span>}</span>
+<span id="cb579-3"><a href="#cb579-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb579-4"><a href="#cb579-4" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb579-5"><a href="#cb579-5" aria-hidden="true" tabindex="-1"></a>| I would spread the cloths under your feet:</span>
+<span id="cb579-6"><a href="#cb579-6" aria-hidden="true" tabindex="-1"></a>| But I, being poor, have only my dreams;</span>
+<span id="cb579-7"><a href="#cb579-7" aria-hidden="true" tabindex="-1"></a>| I have spread my dreams under your feet;</span>
+<span id="cb579-8"><a href="#cb579-8" aria-hidden="true" tabindex="-1"></a>| Tread softly because you tread on my dreams.</span>
+<span id="cb579-9"><a href="#cb579-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb579-10"><a href="#cb579-10" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb577"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb577-1"><a href="#cb577-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb580"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb580-1"><a href="#cb580-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -10684,20 +10777,20 @@ Tread softly because you tread on my dreams.</div>
class="tex">T<sub>e</sub>X</span>t Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb578"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb578-1"><a href="#cb578-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
-<span id="cb578-2"><a href="#cb578-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[lineBlocks = yes]</span>
-<span id="cb578-3"><a href="#cb578-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
-<span id="cb578-4"><a href="#cb578-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb578-5"><a href="#cb578-5" aria-hidden="true" tabindex="-1"></a>| I would spread the cloths under your feet:</span>
-<span id="cb578-6"><a href="#cb578-6" aria-hidden="true" tabindex="-1"></a>| But I, being poor, have only my dreams;</span>
-<span id="cb578-7"><a href="#cb578-7" aria-hidden="true" tabindex="-1"></a>| I have spread my dreams under your feet;</span>
-<span id="cb578-8"><a href="#cb578-8" aria-hidden="true" tabindex="-1"></a>| Tread softly because you tread on my dreams.</span>
-<span id="cb578-9"><a href="#cb578-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb578-10"><a href="#cb578-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
+<div class="sourceCode" id="cb581"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb581-1"><a href="#cb581-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
+<span id="cb581-2"><a href="#cb581-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[lineBlocks = yes]</span>
+<span id="cb581-3"><a href="#cb581-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
+<span id="cb581-4"><a href="#cb581-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb581-5"><a href="#cb581-5" aria-hidden="true" tabindex="-1"></a>| I would spread the cloths under your feet:</span>
+<span id="cb581-6"><a href="#cb581-6" aria-hidden="true" tabindex="-1"></a>| But I, being poor, have only my dreams;</span>
+<span id="cb581-7"><a href="#cb581-7" aria-hidden="true" tabindex="-1"></a>| I have spread my dreams under your feet;</span>
+<span id="cb581-8"><a href="#cb581-8" aria-hidden="true" tabindex="-1"></a>| Tread softly because you tread on my dreams.</span>
+<span id="cb581-9"><a href="#cb581-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb581-10"><a href="#cb581-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb579"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb579-1"><a href="#cb579-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb582"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb582-1"><a href="#cb582-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -10708,29 +10801,29 @@ Tread softly because you tread on my dreams.</div>
</blockquote>
<h4 data-number="2.3.1.23" id="line-break-renderers"><span
class="header-section-number">2.3.1.23</span> Line Break Renderers</h4>
-<p>The <code>\markdownRendererSoftLineBreak</code> macro represents a
+<p>The <code>markdownRendererSoftLineBreak</code> macro represents a
soft line break. The macro receives no arguments.</p>
<h5 class="unnumbered" id="plain-tex-example-35">Plain <span
class="tex">T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb580"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb580-1"><a href="#cb580-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
-<span id="cb580-2"><a href="#cb580-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererSoftLineBreak</span>{<span class="co">%</span></span>
-<span id="cb580-3"><a href="#cb580-3" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
-<span id="cb580-4"><a href="#cb580-4" aria-hidden="true" tabindex="-1"></a> {<span class="fu">\it</span>(A soft line break)}<span class="co">%</span></span>
-<span id="cb580-5"><a href="#cb580-5" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
-<span id="cb580-6"><a href="#cb580-6" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb580-7"><a href="#cb580-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownInput</span>{example.md}</span>
-<span id="cb580-8"><a href="#cb580-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb583"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb583-1"><a href="#cb583-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
+<span id="cb583-2"><a href="#cb583-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererSoftLineBreak</span>{<span class="co">%</span></span>
+<span id="cb583-3"><a href="#cb583-3" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
+<span id="cb583-4"><a href="#cb583-4" aria-hidden="true" tabindex="-1"></a> {<span class="fu">\it</span>(A soft line break)}<span class="co">%</span></span>
+<span id="cb583-5"><a href="#cb583-5" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
+<span id="cb583-6"><a href="#cb583-6" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb583-7"><a href="#cb583-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownInput</span>{example.md}</span>
+<span id="cb583-8"><a href="#cb583-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Using a text editor, create a text document named
<code>example.md</code> with the following content:</p>
-<div class="sourceCode" id="cb581"><pre
-class="sourceCode md"><code class="sourceCode markdown"><span id="cb581-1"><a href="#cb581-1" aria-hidden="true" tabindex="-1"></a>Hello world!</span>
-<span id="cb581-2"><a href="#cb581-2" aria-hidden="true" tabindex="-1"></a>_Foo_ bar!</span></code></pre></div>
+<div class="sourceCode" id="cb584"><pre
+class="sourceCode md"><code class="sourceCode markdown"><span id="cb584-1"><a href="#cb584-1" aria-hidden="true" tabindex="-1"></a>Hello world!</span>
+<span id="cb584-2"><a href="#cb584-2" aria-hidden="true" tabindex="-1"></a>_Foo_ bar!</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb582"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb582-1"><a href="#cb582-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb585"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb585-1"><a href="#cb585-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -10742,29 +10835,29 @@ contain the following text:</p>
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb583"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb583-1"><a href="#cb583-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb583-2"><a href="#cb583-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span>
-<span id="cb583-3"><a href="#cb583-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb583-4"><a href="#cb583-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb583-5"><a href="#cb583-5" aria-hidden="true" tabindex="-1"></a> softLineBreak = {<span class="co">%</span></span>
-<span id="cb583-6"><a href="#cb583-6" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
-<span id="cb583-7"><a href="#cb583-7" aria-hidden="true" tabindex="-1"></a> <span class="fu">\emph</span>{(A soft line break)}<span class="co">%</span></span>
-<span id="cb583-8"><a href="#cb583-8" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
-<span id="cb583-9"><a href="#cb583-9" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb583-10"><a href="#cb583-10" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb583-11"><a href="#cb583-11" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb583-12"><a href="#cb583-12" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb583-13"><a href="#cb583-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownInput</span>{example.md}</span>
-<span id="cb583-14"><a href="#cb583-14" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb586"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb586-1"><a href="#cb586-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb586-2"><a href="#cb586-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span>
+<span id="cb586-3"><a href="#cb586-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb586-4"><a href="#cb586-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb586-5"><a href="#cb586-5" aria-hidden="true" tabindex="-1"></a> softLineBreak = {<span class="co">%</span></span>
+<span id="cb586-6"><a href="#cb586-6" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
+<span id="cb586-7"><a href="#cb586-7" aria-hidden="true" tabindex="-1"></a> <span class="fu">\emph</span>{(A soft line break)}<span class="co">%</span></span>
+<span id="cb586-8"><a href="#cb586-8" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
+<span id="cb586-9"><a href="#cb586-9" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb586-10"><a href="#cb586-10" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb586-11"><a href="#cb586-11" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb586-12"><a href="#cb586-12" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb586-13"><a href="#cb586-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownInput</span>{example.md}</span>
+<span id="cb586-14"><a href="#cb586-14" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Using a text editor, create a text document named
<code>example.md</code> with the following content:</p>
-<div class="sourceCode" id="cb584"><pre
-class="sourceCode md"><code class="sourceCode markdown"><span id="cb584-1"><a href="#cb584-1" aria-hidden="true" tabindex="-1"></a>Hello world!</span>
-<span id="cb584-2"><a href="#cb584-2" aria-hidden="true" tabindex="-1"></a>_Foo_ bar!</span></code></pre></div>
+<div class="sourceCode" id="cb587"><pre
+class="sourceCode md"><code class="sourceCode markdown"><span id="cb587-1"><a href="#cb587-1" aria-hidden="true" tabindex="-1"></a>Hello world!</span>
+<span id="cb587-2"><a href="#cb587-2" aria-hidden="true" tabindex="-1"></a>_Foo_ bar!</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb585"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb585-1"><a href="#cb585-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb588"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb588-1"><a href="#cb588-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -10772,21 +10865,21 @@ contain the following text:</p>
<p><em>(A soft line break)</em></p>
<p><em>Foo</em> bar!</p>
</blockquote>
-<p>The <code>\markdownRendererHardLineBreak</code> macro represents a
+<p>The <code>markdownRendererHardLineBreak</code> macro represents a
hard line break. The macro receives no arguments.</p>
<h5 class="unnumbered" id="plain-tex-example-36">Plain <span
class="tex">T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb586"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb586-1"><a href="#cb586-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
-<span id="cb586-2"><a href="#cb586-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererHardLineBreak</span>{<span class="co">%</span></span>
-<span id="cb586-3"><a href="#cb586-3" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
-<span id="cb586-4"><a href="#cb586-4" aria-hidden="true" tabindex="-1"></a> {<span class="fu">\it</span>(A hard line break)}<span class="co">%</span></span>
-<span id="cb586-5"><a href="#cb586-5" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
-<span id="cb586-6"><a href="#cb586-6" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb586-7"><a href="#cb586-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownInput</span>{example.md}</span>
-<span id="cb586-8"><a href="#cb586-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb589"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb589-1"><a href="#cb589-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
+<span id="cb589-2"><a href="#cb589-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererHardLineBreak</span>{<span class="co">%</span></span>
+<span id="cb589-3"><a href="#cb589-3" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
+<span id="cb589-4"><a href="#cb589-4" aria-hidden="true" tabindex="-1"></a> {<span class="fu">\it</span>(A hard line break)}<span class="co">%</span></span>
+<span id="cb589-5"><a href="#cb589-5" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
+<span id="cb589-6"><a href="#cb589-6" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb589-7"><a href="#cb589-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownInput</span>{example.md}</span>
+<span id="cb589-8"><a href="#cb589-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Using a text editor, create a text document named
<code>example.md</code> with the following content. Note the two spaces
at the end of the first line, which specify a hard line break. Due to
@@ -10795,8 +10888,8 @@ processor, hard line breaks would be ignored if we typed them directly
into the <code>document.tex</code> document.</p>
<pre><code>Hello world! <br/>_Foo_ bar!</code></pre>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb587"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb587-1"><a href="#cb587-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb590"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb590-1"><a href="#cb590-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -10808,21 +10901,21 @@ contain the following text:</p>
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb588"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb588-1"><a href="#cb588-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb588-2"><a href="#cb588-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span>
-<span id="cb588-3"><a href="#cb588-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb588-4"><a href="#cb588-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb588-5"><a href="#cb588-5" aria-hidden="true" tabindex="-1"></a> hardLineBreak = {<span class="co">%</span></span>
-<span id="cb588-6"><a href="#cb588-6" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
-<span id="cb588-7"><a href="#cb588-7" aria-hidden="true" tabindex="-1"></a> <span class="fu">\emph</span>{(A hard line break)}<span class="co">%</span></span>
-<span id="cb588-8"><a href="#cb588-8" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
-<span id="cb588-9"><a href="#cb588-9" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb588-10"><a href="#cb588-10" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb588-11"><a href="#cb588-11" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb588-12"><a href="#cb588-12" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb588-13"><a href="#cb588-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownInput</span>{example.md}</span>
-<span id="cb588-14"><a href="#cb588-14" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb591"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb591-1"><a href="#cb591-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb591-2"><a href="#cb591-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span>
+<span id="cb591-3"><a href="#cb591-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb591-4"><a href="#cb591-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb591-5"><a href="#cb591-5" aria-hidden="true" tabindex="-1"></a> hardLineBreak = {<span class="co">%</span></span>
+<span id="cb591-6"><a href="#cb591-6" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
+<span id="cb591-7"><a href="#cb591-7" aria-hidden="true" tabindex="-1"></a> <span class="fu">\emph</span>{(A hard line break)}<span class="co">%</span></span>
+<span id="cb591-8"><a href="#cb591-8" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
+<span id="cb591-9"><a href="#cb591-9" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb591-10"><a href="#cb591-10" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb591-11"><a href="#cb591-11" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb591-12"><a href="#cb591-12" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb591-13"><a href="#cb591-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownInput</span>{example.md}</span>
+<span id="cb591-14"><a href="#cb591-14" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Using a text editor, create a text document named
<code>example.md</code> with the following content. Note the two spaces
at the end of the first line, which specify a hard line break. Due to
@@ -10831,8 +10924,8 @@ processor, hard line breaks would be ignored if we typed them directly
into the <code>document.tex</code> document.</p>
<pre><code>Hello world! <br/>_Foo_ bar!</code></pre>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb589"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb589-1"><a href="#cb589-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb592"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb592-1"><a href="#cb592-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -10842,7 +10935,7 @@ contain the following text:</p>
</blockquote>
<h4 data-number="2.3.1.24" id="link-renderer"><span
class="header-section-number">2.3.1.24</span> Link Renderer</h4>
-<p>The <code>\markdownRendererLink</code> macro represents a hyperlink.
+<p>The <code>markdownRendererLink</code> macro represents a hyperlink.
It receives four arguments: the label, the fully escaped
<abbr>uri</abbr> that can be directly typeset, the raw <abbr>uri</abbr>
that can be used outside typesetting, and the title of the link.</p>
@@ -10850,21 +10943,21 @@ that can be used outside typesetting, and the title of the link.</p>
class="tex">T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb590"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb590-1"><a href="#cb590-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
-<span id="cb590-2"><a href="#cb590-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererLink</span>#1#2#3#4{<span class="co">%</span></span>
-<span id="cb590-3"><a href="#cb590-3" aria-hidden="true" tabindex="-1"></a> #1 {<span class="fu">\tt</span>#2} titled {<span class="fu">\it</span>#4}<span class="co">%</span></span>
-<span id="cb590-4"><a href="#cb590-4" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb590-5"><a href="#cb590-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
-<span id="cb590-6"><a href="#cb590-6" aria-hidden="true" tabindex="-1"></a>Please visit [the link][ctan].</span>
-<span id="cb590-7"><a href="#cb590-7" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb590-8"><a href="#cb590-8" aria-hidden="true" tabindex="-1"></a> [ctan]: https://ctan.org/</span>
-<span id="cb590-9"><a href="#cb590-9" aria-hidden="true" tabindex="-1"></a> (the Comprehensive TeX Archive Network)</span>
-<span id="cb590-10"><a href="#cb590-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
-<span id="cb590-11"><a href="#cb590-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb593"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb593-1"><a href="#cb593-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
+<span id="cb593-2"><a href="#cb593-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererLink</span>#1#2#3#4{<span class="co">%</span></span>
+<span id="cb593-3"><a href="#cb593-3" aria-hidden="true" tabindex="-1"></a> #1 {<span class="fu">\tt</span>#2} titled {<span class="fu">\it</span>#4}<span class="co">%</span></span>
+<span id="cb593-4"><a href="#cb593-4" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb593-5"><a href="#cb593-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
+<span id="cb593-6"><a href="#cb593-6" aria-hidden="true" tabindex="-1"></a>Please visit [the link][ctan].</span>
+<span id="cb593-7"><a href="#cb593-7" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb593-8"><a href="#cb593-8" aria-hidden="true" tabindex="-1"></a> [ctan]: https://ctan.org/</span>
+<span id="cb593-9"><a href="#cb593-9" aria-hidden="true" tabindex="-1"></a> (the Comprehensive TeX Archive Network)</span>
+<span id="cb593-10"><a href="#cb593-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
+<span id="cb593-11"><a href="#cb593-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb591"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb591-1"><a href="#cb591-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb594"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb594-1"><a href="#cb594-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -10876,27 +10969,27 @@ Archive Network</em>.</p>
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb592"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb592-1"><a href="#cb592-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb592-2"><a href="#cb592-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span>
-<span id="cb592-3"><a href="#cb592-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb592-4"><a href="#cb592-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb592-5"><a href="#cb592-5" aria-hidden="true" tabindex="-1"></a> link = {<span class="co">%</span></span>
-<span id="cb592-6"><a href="#cb592-6" aria-hidden="true" tabindex="-1"></a> #1 <span class="fu">\texttt</span>{#2} titled <span class="fu">\emph</span>{#4}<span class="co">%</span></span>
-<span id="cb592-7"><a href="#cb592-7" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb592-8"><a href="#cb592-8" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb592-9"><a href="#cb592-9" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb592-10"><a href="#cb592-10" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb592-11"><a href="#cb592-11" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb592-12"><a href="#cb592-12" aria-hidden="true" tabindex="-1"></a>Please visit [the link][ctan].</span>
-<span id="cb592-13"><a href="#cb592-13" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb592-14"><a href="#cb592-14" aria-hidden="true" tabindex="-1"></a> [ctan]: https://ctan.org/</span>
-<span id="cb592-15"><a href="#cb592-15" aria-hidden="true" tabindex="-1"></a> (the Comprehensive TeX Archive Network)</span>
-<span id="cb592-16"><a href="#cb592-16" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb592-17"><a href="#cb592-17" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb595"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb595-1"><a href="#cb595-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb595-2"><a href="#cb595-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span>
+<span id="cb595-3"><a href="#cb595-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb595-4"><a href="#cb595-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb595-5"><a href="#cb595-5" aria-hidden="true" tabindex="-1"></a> link = {<span class="co">%</span></span>
+<span id="cb595-6"><a href="#cb595-6" aria-hidden="true" tabindex="-1"></a> #1 <span class="fu">\texttt</span>{#2} titled <span class="fu">\emph</span>{#4}<span class="co">%</span></span>
+<span id="cb595-7"><a href="#cb595-7" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb595-8"><a href="#cb595-8" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb595-9"><a href="#cb595-9" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb595-10"><a href="#cb595-10" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb595-11"><a href="#cb595-11" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb595-12"><a href="#cb595-12" aria-hidden="true" tabindex="-1"></a>Please visit [the link][ctan].</span>
+<span id="cb595-13"><a href="#cb595-13" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb595-14"><a href="#cb595-14" aria-hidden="true" tabindex="-1"></a> [ctan]: https://ctan.org/</span>
+<span id="cb595-15"><a href="#cb595-15" aria-hidden="true" tabindex="-1"></a> (the Comprehensive TeX Archive Network)</span>
+<span id="cb595-16"><a href="#cb595-16" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb595-17"><a href="#cb595-17" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb593"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb593-1"><a href="#cb593-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb596"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb596-1"><a href="#cb596-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -10908,22 +11001,22 @@ Archive Network</em>.</p>
class="tex">T<sub>e</sub>X</span>t Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb594"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb594-1"><a href="#cb594-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
-<span id="cb594-2"><a href="#cb594-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererLink</span>#1#2#3#4{<span class="co">%</span></span>
-<span id="cb594-3"><a href="#cb594-3" aria-hidden="true" tabindex="-1"></a> #1 {<span class="fu">\tt</span>#2} titled <span class="fu">\emph</span>{#4}<span class="co">%</span></span>
-<span id="cb594-4"><a href="#cb594-4" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb594-5"><a href="#cb594-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
-<span id="cb594-6"><a href="#cb594-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb594-7"><a href="#cb594-7" aria-hidden="true" tabindex="-1"></a>Please visit [the link][ctan].</span>
-<span id="cb594-8"><a href="#cb594-8" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb594-9"><a href="#cb594-9" aria-hidden="true" tabindex="-1"></a> [ctan]: https://ctan.org/</span>
-<span id="cb594-10"><a href="#cb594-10" aria-hidden="true" tabindex="-1"></a> (the Comprehensive TeX Archive Network)</span>
-<span id="cb594-11"><a href="#cb594-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb594-12"><a href="#cb594-12" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
+<div class="sourceCode" id="cb597"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb597-1"><a href="#cb597-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
+<span id="cb597-2"><a href="#cb597-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererLink</span>#1#2#3#4{<span class="co">%</span></span>
+<span id="cb597-3"><a href="#cb597-3" aria-hidden="true" tabindex="-1"></a> #1 {<span class="fu">\tt</span>#2} titled <span class="fu">\emph</span>{#4}<span class="co">%</span></span>
+<span id="cb597-4"><a href="#cb597-4" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb597-5"><a href="#cb597-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
+<span id="cb597-6"><a href="#cb597-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb597-7"><a href="#cb597-7" aria-hidden="true" tabindex="-1"></a>Please visit [the link][ctan].</span>
+<span id="cb597-8"><a href="#cb597-8" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb597-9"><a href="#cb597-9" aria-hidden="true" tabindex="-1"></a> [ctan]: https://ctan.org/</span>
+<span id="cb597-10"><a href="#cb597-10" aria-hidden="true" tabindex="-1"></a> (the Comprehensive TeX Archive Network)</span>
+<span id="cb597-11"><a href="#cb597-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb597-12"><a href="#cb597-12" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb595"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb595-1"><a href="#cb595-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb598"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb598-1"><a href="#cb598-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -10935,35 +11028,35 @@ Archive Network</em>.</p>
class="header-section-number">2.3.1.25</span> Link Attribute Context
Renderers</h4>
<p>The following macros are only produced, when the
-<strong><code>linkAttributes</code></strong> option is enabled.</p>
-<p>The <code>\markdownRendererLinkAttributeContextBegin</code> and
-<code>\markdownRendererLinkAttributeContextEnd</code> macros represent
+<code><strong>linkAttributes</strong></code> option is enabled.</p>
+<p>The <code>markdownRendererLinkAttributeContextBegin</code> and
+<code>markdownRendererLinkAttributeContextEnd</code> macros represent
the beginning and the end of a context in which the attributes of a
hyperlink apply. The macros receive no arguments.</p>
<h5 class="unnumbered" id="latex-example-83"><span
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb596"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb596-1"><a href="#cb596-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb596-2"><a href="#cb596-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[linkAttributes]{<span class="ex">markdown</span>}</span>
-<span id="cb596-3"><a href="#cb596-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb596-4"><a href="#cb596-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb596-5"><a href="#cb596-5" aria-hidden="true" tabindex="-1"></a> linkAttributeContextBegin = {(},</span>
-<span id="cb596-6"><a href="#cb596-6" aria-hidden="true" tabindex="-1"></a> link = {#1},</span>
-<span id="cb596-7"><a href="#cb596-7" aria-hidden="true" tabindex="-1"></a> linkAttributeContextEnd = {)},</span>
-<span id="cb596-8"><a href="#cb596-8" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb596-9"><a href="#cb596-9" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb596-10"><a href="#cb596-10" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb596-11"><a href="#cb596-11" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb596-12"><a href="#cb596-12" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb596-13"><a href="#cb596-13" aria-hidden="true" tabindex="-1"></a>foo [bar](#bar){key=value} baz</span>
-<span id="cb596-14"><a href="#cb596-14" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb596-15"><a href="#cb596-15" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb596-16"><a href="#cb596-16" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb599"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb599-1"><a href="#cb599-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb599-2"><a href="#cb599-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[linkAttributes]{<span class="ex">markdown</span>}</span>
+<span id="cb599-3"><a href="#cb599-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb599-4"><a href="#cb599-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb599-5"><a href="#cb599-5" aria-hidden="true" tabindex="-1"></a> linkAttributeContextBegin = {(},</span>
+<span id="cb599-6"><a href="#cb599-6" aria-hidden="true" tabindex="-1"></a> link = {#1},</span>
+<span id="cb599-7"><a href="#cb599-7" aria-hidden="true" tabindex="-1"></a> linkAttributeContextEnd = {)},</span>
+<span id="cb599-8"><a href="#cb599-8" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb599-9"><a href="#cb599-9" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb599-10"><a href="#cb599-10" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb599-11"><a href="#cb599-11" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb599-12"><a href="#cb599-12" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb599-13"><a href="#cb599-13" aria-hidden="true" tabindex="-1"></a>foo [bar](#bar){key=value} baz</span>
+<span id="cb599-14"><a href="#cb599-14" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb599-15"><a href="#cb599-15" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb599-16"><a href="#cb599-16" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb597"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb597-1"><a href="#cb597-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb600"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb600-1"><a href="#cb600-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -10972,33 +11065,33 @@ contain the following text:</p>
<h4 data-number="2.3.1.26" id="marked-text-renderer"><span
class="header-section-number">2.3.1.26</span> Marked Text Renderer</h4>
<p>The following macro is only produced, when the
-<strong><code>mark</code></strong> option is enabled.</p>
-<p>The <code>\markdownRendererMark</code> macro represents a span of
+<code><strong>mark</strong></code> option is enabled.</p>
+<p>The <code>markdownRendererMark</code> macro represents a span of
marked or highlighted text. The macro receives a single argument that
corresponds to the marked text.</p>
<h5 class="unnumbered" id="latex-example-84"><span
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb598"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb598-1"><a href="#cb598-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb598-2"><a href="#cb598-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[mark]{<span class="ex">markdown</span>}</span>
-<span id="cb598-3"><a href="#cb598-3" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">soul</span>}</span>
-<span id="cb598-4"><a href="#cb598-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb598-5"><a href="#cb598-5" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb598-6"><a href="#cb598-6" aria-hidden="true" tabindex="-1"></a> mark = {<span class="fu">\hl</span>{#1}},</span>
-<span id="cb598-7"><a href="#cb598-7" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb598-8"><a href="#cb598-8" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb598-9"><a href="#cb598-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb598-10"><a href="#cb598-10" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb598-11"><a href="#cb598-11" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb598-12"><a href="#cb598-12" aria-hidden="true" tabindex="-1"></a>This ==is highlighted text.==</span>
-<span id="cb598-13"><a href="#cb598-13" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb598-14"><a href="#cb598-14" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb598-15"><a href="#cb598-15" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb601"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb601-1"><a href="#cb601-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb601-2"><a href="#cb601-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[mark]{<span class="ex">markdown</span>}</span>
+<span id="cb601-3"><a href="#cb601-3" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">soul</span>}</span>
+<span id="cb601-4"><a href="#cb601-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb601-5"><a href="#cb601-5" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb601-6"><a href="#cb601-6" aria-hidden="true" tabindex="-1"></a> mark = {<span class="fu">\hl</span>{#1}},</span>
+<span id="cb601-7"><a href="#cb601-7" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb601-8"><a href="#cb601-8" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb601-9"><a href="#cb601-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb601-10"><a href="#cb601-10" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb601-11"><a href="#cb601-11" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb601-12"><a href="#cb601-12" aria-hidden="true" tabindex="-1"></a>This ==is highlighted text.==</span>
+<span id="cb601-13"><a href="#cb601-13" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb601-14"><a href="#cb601-14" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb601-15"><a href="#cb601-15" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb599"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb599-1"><a href="#cb599-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb602"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb602-1"><a href="#cb602-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -11007,8 +11100,8 @@ contain the following text:</p>
<h4 data-number="2.3.1.27" id="markdown-document-renderers"><span
class="header-section-number">2.3.1.27</span> Markdown Document
Renderers</h4>
-<p>The <code>\markdownRendererDocumentBegin</code> and
-<code>\markdownRendererDocumentEnd</code> macros represent the beginning
+<p>The <code>markdownRendererDocumentBegin</code> and
+<code>markdownRendererDocumentEnd</code> macros represent the beginning
and the end of a <em>markdown</em> document. The macros receive no
arguments.</p>
<p>A <span class="tex">T<sub>e</sub>X</span> document may contain any
@@ -11020,77 +11113,77 @@ account.</p>
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>nested.md</code> with the following content:</p>
-<div class="sourceCode" id="cb600"><pre
-class="sourceCode md"><code class="sourceCode markdown"><span id="cb600-1"><a href="#cb600-1" aria-hidden="true" tabindex="-1"></a>This is a *nested* markdown document.</span></code></pre></div>
+<div class="sourceCode" id="cb603"><pre
+class="sourceCode md"><code class="sourceCode markdown"><span id="cb603-1"><a href="#cb603-1" aria-hidden="true" tabindex="-1"></a>This is a *nested* markdown document.</span></code></pre></div>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb601"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb601-1"><a href="#cb601-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb601-2"><a href="#cb601-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[contentBlocks]{<span class="ex">markdown</span>}</span>
-<span id="cb601-3"><a href="#cb601-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb601-4"><a href="#cb601-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb601-5"><a href="#cb601-5" aria-hidden="true" tabindex="-1"></a> contentBlock = {<span class="co">%</span></span>
-<span id="cb601-6"><a href="#cb601-6" aria-hidden="true" tabindex="-1"></a> <span class="fu">\markdownInput</span>{#3}<span class="co">%</span></span>
-<span id="cb601-7"><a href="#cb601-7" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb601-8"><a href="#cb601-8" aria-hidden="true" tabindex="-1"></a> documentBegin = {<span class="co">%</span></span>
-<span id="cb601-9"><a href="#cb601-9" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
-<span id="cb601-10"><a href="#cb601-10" aria-hidden="true" tabindex="-1"></a> <span class="fu">\emph</span>{(The beginning of a document)}</span>
-<span id="cb601-11"><a href="#cb601-11" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
-<span id="cb601-12"><a href="#cb601-12" aria-hidden="true" tabindex="-1"></a> <span class="fu">\begingroup</span></span>
-<span id="cb601-13"><a href="#cb601-13" aria-hidden="true" tabindex="-1"></a> <span class="fu">\markdownSetup</span>{snippet=first-nesting-level}<span class="co">%</span></span>
-<span id="cb601-14"><a href="#cb601-14" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb601-15"><a href="#cb601-15" aria-hidden="true" tabindex="-1"></a> documentEnd = {<span class="co">%</span></span>
-<span id="cb601-16"><a href="#cb601-16" aria-hidden="true" tabindex="-1"></a> <span class="fu">\endgroup</span></span>
-<span id="cb601-17"><a href="#cb601-17" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
-<span id="cb601-18"><a href="#cb601-18" aria-hidden="true" tabindex="-1"></a> <span class="fu">\emph</span>{(The end of a document)}</span>
-<span id="cb601-19"><a href="#cb601-19" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
-<span id="cb601-20"><a href="#cb601-20" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb601-21"><a href="#cb601-21" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb601-22"><a href="#cb601-22" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb601-23"><a href="#cb601-23" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetupSnippet</span>{first-nesting-level}{</span>
-<span id="cb601-24"><a href="#cb601-24" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb601-25"><a href="#cb601-25" aria-hidden="true" tabindex="-1"></a> documentBegin = {</span>
-<span id="cb601-26"><a href="#cb601-26" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
-<span id="cb601-27"><a href="#cb601-27" aria-hidden="true" tabindex="-1"></a> <span class="fu">\emph</span>{(The beginning of a nested document)}</span>
-<span id="cb601-28"><a href="#cb601-28" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
-<span id="cb601-29"><a href="#cb601-29" aria-hidden="true" tabindex="-1"></a> <span class="fu">\begingroup</span></span>
-<span id="cb601-30"><a href="#cb601-30" aria-hidden="true" tabindex="-1"></a> <span class="fu">\markdownSetup</span>{snippet=second-nesting-level-and-below}</span>
-<span id="cb601-31"><a href="#cb601-31" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb601-32"><a href="#cb601-32" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb601-33"><a href="#cb601-33" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb601-34"><a href="#cb601-34" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetupSnippet</span>{second-nesting-level-and-below}{</span>
-<span id="cb601-35"><a href="#cb601-35" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb601-36"><a href="#cb601-36" aria-hidden="true" tabindex="-1"></a> documentBegin = {</span>
-<span id="cb601-37"><a href="#cb601-37" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
-<span id="cb601-38"><a href="#cb601-38" aria-hidden="true" tabindex="-1"></a> <span class="fu">\emph</span>{(The beginning of a nested document)}</span>
-<span id="cb601-39"><a href="#cb601-39" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
-<span id="cb601-40"><a href="#cb601-40" aria-hidden="true" tabindex="-1"></a> <span class="fu">\begingroup</span></span>
-<span id="cb601-41"><a href="#cb601-41" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb601-42"><a href="#cb601-42" aria-hidden="true" tabindex="-1"></a> documentEnd = {</span>
-<span id="cb601-43"><a href="#cb601-43" aria-hidden="true" tabindex="-1"></a> <span class="fu">\endgroup</span></span>
-<span id="cb601-44"><a href="#cb601-44" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
-<span id="cb601-45"><a href="#cb601-45" aria-hidden="true" tabindex="-1"></a> <span class="fu">\emph</span>{(The end of a nested document)}</span>
-<span id="cb601-46"><a href="#cb601-46" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
-<span id="cb601-47"><a href="#cb601-47" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb601-48"><a href="#cb601-48" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb601-49"><a href="#cb601-49" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb601-50"><a href="#cb601-50" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb601-51"><a href="#cb601-51" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb601-52"><a href="#cb601-52" aria-hidden="true" tabindex="-1"></a>Hello *world*!</span>
-<span id="cb601-53"><a href="#cb601-53" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb601-54"><a href="#cb601-54" aria-hidden="true" tabindex="-1"></a>/nested.md</span>
-<span id="cb601-55"><a href="#cb601-55" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb601-56"><a href="#cb601-56" aria-hidden="true" tabindex="-1"></a>_Foo_ bar!</span>
-<span id="cb601-57"><a href="#cb601-57" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb601-58"><a href="#cb601-58" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb601-59"><a href="#cb601-59" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb601-60"><a href="#cb601-60" aria-hidden="true" tabindex="-1"></a>Bar baz!</span>
-<span id="cb601-61"><a href="#cb601-61" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb601-62"><a href="#cb601-62" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb601-63"><a href="#cb601-63" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb604"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb604-1"><a href="#cb604-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb604-2"><a href="#cb604-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[contentBlocks]{<span class="ex">markdown</span>}</span>
+<span id="cb604-3"><a href="#cb604-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb604-4"><a href="#cb604-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb604-5"><a href="#cb604-5" aria-hidden="true" tabindex="-1"></a> contentBlock = {<span class="co">%</span></span>
+<span id="cb604-6"><a href="#cb604-6" aria-hidden="true" tabindex="-1"></a> <span class="fu">\markdownInput</span>{#3}<span class="co">%</span></span>
+<span id="cb604-7"><a href="#cb604-7" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb604-8"><a href="#cb604-8" aria-hidden="true" tabindex="-1"></a> documentBegin = {<span class="co">%</span></span>
+<span id="cb604-9"><a href="#cb604-9" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
+<span id="cb604-10"><a href="#cb604-10" aria-hidden="true" tabindex="-1"></a> <span class="fu">\emph</span>{(The beginning of a document)}</span>
+<span id="cb604-11"><a href="#cb604-11" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
+<span id="cb604-12"><a href="#cb604-12" aria-hidden="true" tabindex="-1"></a> <span class="fu">\begingroup</span></span>
+<span id="cb604-13"><a href="#cb604-13" aria-hidden="true" tabindex="-1"></a> <span class="fu">\markdownSetup</span>{snippet=first-nesting-level}<span class="co">%</span></span>
+<span id="cb604-14"><a href="#cb604-14" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb604-15"><a href="#cb604-15" aria-hidden="true" tabindex="-1"></a> documentEnd = {<span class="co">%</span></span>
+<span id="cb604-16"><a href="#cb604-16" aria-hidden="true" tabindex="-1"></a> <span class="fu">\endgroup</span></span>
+<span id="cb604-17"><a href="#cb604-17" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
+<span id="cb604-18"><a href="#cb604-18" aria-hidden="true" tabindex="-1"></a> <span class="fu">\emph</span>{(The end of a document)}</span>
+<span id="cb604-19"><a href="#cb604-19" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
+<span id="cb604-20"><a href="#cb604-20" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb604-21"><a href="#cb604-21" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb604-22"><a href="#cb604-22" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb604-23"><a href="#cb604-23" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetupSnippet</span>{first-nesting-level}{</span>
+<span id="cb604-24"><a href="#cb604-24" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb604-25"><a href="#cb604-25" aria-hidden="true" tabindex="-1"></a> documentBegin = {</span>
+<span id="cb604-26"><a href="#cb604-26" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
+<span id="cb604-27"><a href="#cb604-27" aria-hidden="true" tabindex="-1"></a> <span class="fu">\emph</span>{(The beginning of a nested document)}</span>
+<span id="cb604-28"><a href="#cb604-28" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
+<span id="cb604-29"><a href="#cb604-29" aria-hidden="true" tabindex="-1"></a> <span class="fu">\begingroup</span></span>
+<span id="cb604-30"><a href="#cb604-30" aria-hidden="true" tabindex="-1"></a> <span class="fu">\markdownSetup</span>{snippet=second-nesting-level-and-below}</span>
+<span id="cb604-31"><a href="#cb604-31" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb604-32"><a href="#cb604-32" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb604-33"><a href="#cb604-33" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb604-34"><a href="#cb604-34" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetupSnippet</span>{second-nesting-level-and-below}{</span>
+<span id="cb604-35"><a href="#cb604-35" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb604-36"><a href="#cb604-36" aria-hidden="true" tabindex="-1"></a> documentBegin = {</span>
+<span id="cb604-37"><a href="#cb604-37" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
+<span id="cb604-38"><a href="#cb604-38" aria-hidden="true" tabindex="-1"></a> <span class="fu">\emph</span>{(The beginning of a nested document)}</span>
+<span id="cb604-39"><a href="#cb604-39" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
+<span id="cb604-40"><a href="#cb604-40" aria-hidden="true" tabindex="-1"></a> <span class="fu">\begingroup</span></span>
+<span id="cb604-41"><a href="#cb604-41" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb604-42"><a href="#cb604-42" aria-hidden="true" tabindex="-1"></a> documentEnd = {</span>
+<span id="cb604-43"><a href="#cb604-43" aria-hidden="true" tabindex="-1"></a> <span class="fu">\endgroup</span></span>
+<span id="cb604-44"><a href="#cb604-44" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
+<span id="cb604-45"><a href="#cb604-45" aria-hidden="true" tabindex="-1"></a> <span class="fu">\emph</span>{(The end of a nested document)}</span>
+<span id="cb604-46"><a href="#cb604-46" aria-hidden="true" tabindex="-1"></a> <span class="fu">\par</span></span>
+<span id="cb604-47"><a href="#cb604-47" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb604-48"><a href="#cb604-48" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb604-49"><a href="#cb604-49" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb604-50"><a href="#cb604-50" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb604-51"><a href="#cb604-51" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb604-52"><a href="#cb604-52" aria-hidden="true" tabindex="-1"></a>Hello *world*!</span>
+<span id="cb604-53"><a href="#cb604-53" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb604-54"><a href="#cb604-54" aria-hidden="true" tabindex="-1"></a>/nested.md</span>
+<span id="cb604-55"><a href="#cb604-55" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb604-56"><a href="#cb604-56" aria-hidden="true" tabindex="-1"></a>_Foo_ bar!</span>
+<span id="cb604-57"><a href="#cb604-57" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb604-58"><a href="#cb604-58" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb604-59"><a href="#cb604-59" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb604-60"><a href="#cb604-60" aria-hidden="true" tabindex="-1"></a>Bar baz!</span>
+<span id="cb604-61"><a href="#cb604-61" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb604-62"><a href="#cb604-62" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb604-63"><a href="#cb604-63" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb602"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb602-1"><a href="#cb602-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb605"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb605-1"><a href="#cb605-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -11108,48 +11201,48 @@ contain the following text:</p>
<h4 data-number="2.3.1.28" id="non-breaking-space-renderer"><span
class="header-section-number">2.3.1.28</span> Non-Breaking Space
Renderer</h4>
-<p>The <code>\markdownRendererNbsp</code> macro represents a
-non-breaking space.</p>
+<p>The <code>markdownRendererNbsp</code> macro represents a non-breaking
+space.</p>
<h5 class="unnumbered" id="latex-example-86"><span
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.bib</code> with the following content:</p>
-<div class="sourceCode" id="cb603"><pre
-class="sourceCode bib"><code class="sourceCode bibtex"><span id="cb603-1"><a href="#cb603-1" aria-hidden="true" tabindex="-1"></a><span class="va">@book</span>{<span class="ot">knuth:tex</span>,</span>
-<span id="cb603-2"><a href="#cb603-2" aria-hidden="true" tabindex="-1"></a> <span class="dt">author</span> = &quot;<span class="st">Knuth, Donald Ervin</span>&quot;,</span>
-<span id="cb603-3"><a href="#cb603-3" aria-hidden="true" tabindex="-1"></a> <span class="dt">title</span> = &quot;<span class="st">The </span><span class="ch">\TeX</span><span class="st"> book, volume A of Computers and typesetting</span>&quot;,</span>
-<span id="cb603-4"><a href="#cb603-4" aria-hidden="true" tabindex="-1"></a> <span class="dt">publisher</span> = &quot;<span class="st">Addison-Wesley</span>&quot;,</span>
-<span id="cb603-5"><a href="#cb603-5" aria-hidden="true" tabindex="-1"></a> <span class="dt">year</span> = &quot;<span class="st">1984</span>&quot;</span>
-<span id="cb603-6"><a href="#cb603-6" aria-hidden="true" tabindex="-1"></a>}</span></code></pre></div>
+<div class="sourceCode" id="cb606"><pre
+class="sourceCode bib"><code class="sourceCode bibtex"><span id="cb606-1"><a href="#cb606-1" aria-hidden="true" tabindex="-1"></a><span class="va">@book</span>{<span class="ot">knuth:tex</span>,</span>
+<span id="cb606-2"><a href="#cb606-2" aria-hidden="true" tabindex="-1"></a> <span class="dt">author</span> = &quot;<span class="st">Knuth, Donald Ervin</span>&quot;,</span>
+<span id="cb606-3"><a href="#cb606-3" aria-hidden="true" tabindex="-1"></a> <span class="dt">title</span> = &quot;<span class="st">The </span><span class="ch">\TeX</span><span class="st"> book, volume A of Computers and typesetting</span>&quot;,</span>
+<span id="cb606-4"><a href="#cb606-4" aria-hidden="true" tabindex="-1"></a> <span class="dt">publisher</span> = &quot;<span class="st">Addison-Wesley</span>&quot;,</span>
+<span id="cb606-5"><a href="#cb606-5" aria-hidden="true" tabindex="-1"></a> <span class="dt">year</span> = &quot;<span class="st">1984</span>&quot;</span>
+<span id="cb606-6"><a href="#cb606-6" aria-hidden="true" tabindex="-1"></a>}</span></code></pre></div>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb604"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb604-1"><a href="#cb604-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb604-2"><a href="#cb604-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[</span>
-<span id="cb604-3"><a href="#cb604-3" aria-hidden="true" tabindex="-1"></a> citations,</span>
-<span id="cb604-4"><a href="#cb604-4" aria-hidden="true" tabindex="-1"></a> citationNbsps,</span>
-<span id="cb604-5"><a href="#cb604-5" aria-hidden="true" tabindex="-1"></a>]{<span class="ex">markdown</span>}</span>
-<span id="cb604-6"><a href="#cb604-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb604-7"><a href="#cb604-7" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb604-8"><a href="#cb604-8" aria-hidden="true" tabindex="-1"></a> nbsp = {<span class="ss">$</span><span class="sc">\cdot</span><span class="ss">$</span>},</span>
-<span id="cb604-9"><a href="#cb604-9" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb604-10"><a href="#cb604-10" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb604-11"><a href="#cb604-11" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb604-12"><a href="#cb604-12" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb604-13"><a href="#cb604-13" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb604-14"><a href="#cb604-14" aria-hidden="true" tabindex="-1"></a>The TeXbook [@knuth:tex, p. 123 and 130] is good.</span>
-<span id="cb604-15"><a href="#cb604-15" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb604-16"><a href="#cb604-16" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb604-17"><a href="#cb604-17" aria-hidden="true" tabindex="-1"></a><span class="bu">\bibliographystyle</span>{<span class="ex">plain</span>}</span>
-<span id="cb604-18"><a href="#cb604-18" aria-hidden="true" tabindex="-1"></a><span class="bu">\bibliography</span>{<span class="ex">document.bib</span>}</span>
-<span id="cb604-19"><a href="#cb604-19" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb604-20"><a href="#cb604-20" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb607"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb607-1"><a href="#cb607-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb607-2"><a href="#cb607-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[</span>
+<span id="cb607-3"><a href="#cb607-3" aria-hidden="true" tabindex="-1"></a> citations,</span>
+<span id="cb607-4"><a href="#cb607-4" aria-hidden="true" tabindex="-1"></a> citationNbsps,</span>
+<span id="cb607-5"><a href="#cb607-5" aria-hidden="true" tabindex="-1"></a>]{<span class="ex">markdown</span>}</span>
+<span id="cb607-6"><a href="#cb607-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb607-7"><a href="#cb607-7" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb607-8"><a href="#cb607-8" aria-hidden="true" tabindex="-1"></a> nbsp = {<span class="ss">$</span><span class="sc">\cdot</span><span class="ss">$</span>},</span>
+<span id="cb607-9"><a href="#cb607-9" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb607-10"><a href="#cb607-10" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb607-11"><a href="#cb607-11" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb607-12"><a href="#cb607-12" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb607-13"><a href="#cb607-13" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb607-14"><a href="#cb607-14" aria-hidden="true" tabindex="-1"></a>The TeXbook [@knuth:tex, p. 123 and 130] is good.</span>
+<span id="cb607-15"><a href="#cb607-15" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb607-16"><a href="#cb607-16" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb607-17"><a href="#cb607-17" aria-hidden="true" tabindex="-1"></a><span class="bu">\bibliographystyle</span>{<span class="ex">plain</span>}</span>
+<span id="cb607-18"><a href="#cb607-18" aria-hidden="true" tabindex="-1"></a><span class="bu">\bibliography</span>{<span class="ex">document.bib</span>}</span>
+<span id="cb607-19"><a href="#cb607-19" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb607-20"><a href="#cb607-20" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX and BibTeX from the terminal:</p>
-<div class="sourceCode" id="cb605"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb605-1"><a href="#cb605-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span>
-<span id="cb605-2"><a href="#cb605-2" aria-hidden="true" tabindex="-1"></a><span class="ex">bibtex</span> document.aux</span>
-<span id="cb605-3"><a href="#cb605-3" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span>
-<span id="cb605-4"><a href="#cb605-4" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb608"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb608-1"><a href="#cb608-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span>
+<span id="cb608-2"><a href="#cb608-2" aria-hidden="true" tabindex="-1"></a><span class="ex">bibtex</span> document.aux</span>
+<span id="cb608-3"><a href="#cb608-3" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span>
+<span id="cb608-4"><a href="#cb608-4" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -11160,29 +11253,29 @@ typesetting.</em> Addison-Wesley, 1984.</p>
</blockquote>
<h4 data-number="2.3.1.29" id="note-renderer"><span
class="header-section-number">2.3.1.29</span> Note Renderer</h4>
-<p>The <code>\markdownRendererNote</code> macro represents a note. This
+<p>The <code>markdownRendererNote</code> macro represents a note. This
macro will only be produced, when the
-<strong><code>notes</code></strong> option is enabled. The macro
+<code><strong>notes</strong></code> option is enabled. The macro
receives a single argument that corresponds to the note text.</p>
<h5 class="unnumbered" id="plain-tex-example-38">Plain <span
class="tex">T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb606"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb606-1"><a href="#cb606-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
-<span id="cb606-2"><a href="#cb606-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionNotes</span>{true}</span>
-<span id="cb606-3"><a href="#cb606-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererNote</span>#1{ (and <span class="fu">\lowercase</span>{#1})}</span>
-<span id="cb606-4"><a href="#cb606-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
-<span id="cb606-5"><a href="#cb606-5" aria-hidden="true" tabindex="-1"></a>This is some text[^1] and this is some other text[^2].</span>
-<span id="cb606-6"><a href="#cb606-6" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb606-7"><a href="#cb606-7" aria-hidden="true" tabindex="-1"></a> [^1]: this is a note</span>
-<span id="cb606-8"><a href="#cb606-8" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb606-9"><a href="#cb606-9" aria-hidden="true" tabindex="-1"></a> [^2]: this is some other note</span>
-<span id="cb606-10"><a href="#cb606-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
-<span id="cb606-11"><a href="#cb606-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb609"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb609-1"><a href="#cb609-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
+<span id="cb609-2"><a href="#cb609-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionNotes</span>{true}</span>
+<span id="cb609-3"><a href="#cb609-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererNote</span>#1{ (and <span class="fu">\lowercase</span>{#1})}</span>
+<span id="cb609-4"><a href="#cb609-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
+<span id="cb609-5"><a href="#cb609-5" aria-hidden="true" tabindex="-1"></a>This is some text[^1] and this is some other text[^2].</span>
+<span id="cb609-6"><a href="#cb609-6" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb609-7"><a href="#cb609-7" aria-hidden="true" tabindex="-1"></a> [^1]: this is a note</span>
+<span id="cb609-8"><a href="#cb609-8" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb609-9"><a href="#cb609-9" aria-hidden="true" tabindex="-1"></a> [^2]: this is some other note</span>
+<span id="cb609-10"><a href="#cb609-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
+<span id="cb609-11"><a href="#cb609-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb607"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb607-1"><a href="#cb607-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb610"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb610-1"><a href="#cb610-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -11193,26 +11286,26 @@ contain the following text:</p>
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb608"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb608-1"><a href="#cb608-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb608-2"><a href="#cb608-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[notes]{<span class="ex">markdown</span>}</span>
-<span id="cb608-3"><a href="#cb608-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb608-4"><a href="#cb608-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb608-5"><a href="#cb608-5" aria-hidden="true" tabindex="-1"></a> note = { (and <span class="fu">\MakeLowercase</span>{#1})},</span>
-<span id="cb608-6"><a href="#cb608-6" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb608-7"><a href="#cb608-7" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb608-8"><a href="#cb608-8" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb608-9"><a href="#cb608-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb608-10"><a href="#cb608-10" aria-hidden="true" tabindex="-1"></a>This is some text[^1] and this is some other text[^2].</span>
-<span id="cb608-11"><a href="#cb608-11" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb608-12"><a href="#cb608-12" aria-hidden="true" tabindex="-1"></a> [^1]: this is a note</span>
-<span id="cb608-13"><a href="#cb608-13" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb608-14"><a href="#cb608-14" aria-hidden="true" tabindex="-1"></a> [^2]: this is some other note</span>
-<span id="cb608-15"><a href="#cb608-15" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb608-16"><a href="#cb608-16" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb611"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb611-1"><a href="#cb611-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb611-2"><a href="#cb611-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[notes]{<span class="ex">markdown</span>}</span>
+<span id="cb611-3"><a href="#cb611-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb611-4"><a href="#cb611-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb611-5"><a href="#cb611-5" aria-hidden="true" tabindex="-1"></a> note = { (and <span class="fu">\MakeLowercase</span>{#1})},</span>
+<span id="cb611-6"><a href="#cb611-6" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb611-7"><a href="#cb611-7" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb611-8"><a href="#cb611-8" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb611-9"><a href="#cb611-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb611-10"><a href="#cb611-10" aria-hidden="true" tabindex="-1"></a>This is some text[^1] and this is some other text[^2].</span>
+<span id="cb611-11"><a href="#cb611-11" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb611-12"><a href="#cb611-12" aria-hidden="true" tabindex="-1"></a> [^1]: this is a note</span>
+<span id="cb611-13"><a href="#cb611-13" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb611-14"><a href="#cb611-14" aria-hidden="true" tabindex="-1"></a> [^2]: this is some other note</span>
+<span id="cb611-15"><a href="#cb611-15" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb611-16"><a href="#cb611-16" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb609"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb609-1"><a href="#cb609-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb612"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb612-1"><a href="#cb612-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -11223,22 +11316,22 @@ contain the following text:</p>
class="tex">T<sub>e</sub>X</span>t Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb610"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb610-1"><a href="#cb610-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
-<span id="cb610-2"><a href="#cb610-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[notes = yes]</span>
-<span id="cb610-3"><a href="#cb610-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererNote</span>#1{ (and <span class="fu">\lowercase</span>{#1})}</span>
-<span id="cb610-4"><a href="#cb610-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
-<span id="cb610-5"><a href="#cb610-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb610-6"><a href="#cb610-6" aria-hidden="true" tabindex="-1"></a>This is some text[^1] and this is some other text[^2].</span>
-<span id="cb610-7"><a href="#cb610-7" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb610-8"><a href="#cb610-8" aria-hidden="true" tabindex="-1"></a> [^1]: this is a note</span>
-<span id="cb610-9"><a href="#cb610-9" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb610-10"><a href="#cb610-10" aria-hidden="true" tabindex="-1"></a> [^2]: this is some other note</span>
-<span id="cb610-11"><a href="#cb610-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb610-12"><a href="#cb610-12" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
+<div class="sourceCode" id="cb613"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb613-1"><a href="#cb613-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
+<span id="cb613-2"><a href="#cb613-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[notes = yes]</span>
+<span id="cb613-3"><a href="#cb613-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererNote</span>#1{ (and <span class="fu">\lowercase</span>{#1})}</span>
+<span id="cb613-4"><a href="#cb613-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
+<span id="cb613-5"><a href="#cb613-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb613-6"><a href="#cb613-6" aria-hidden="true" tabindex="-1"></a>This is some text[^1] and this is some other text[^2].</span>
+<span id="cb613-7"><a href="#cb613-7" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb613-8"><a href="#cb613-8" aria-hidden="true" tabindex="-1"></a> [^1]: this is a note</span>
+<span id="cb613-9"><a href="#cb613-9" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb613-10"><a href="#cb613-10" aria-hidden="true" tabindex="-1"></a> [^2]: this is some other note</span>
+<span id="cb613-11"><a href="#cb613-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb613-12"><a href="#cb613-12" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb611"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb611-1"><a href="#cb611-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb614"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb614-1"><a href="#cb614-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -11248,156 +11341,156 @@ contain the following text:</p>
<h4 data-number="2.3.1.30" id="ordered-list-renderers"><span
class="header-section-number">2.3.1.30</span> Ordered List
Renderers</h4>
-<p>The <code>\markdownRendererOlBegin</code> macro represents the
+<p>The <code>markdownRendererOlBegin</code> macro represents the
beginning of an ordered list that contains an item with several
paragraphs of text (the list is not tight). This macro will only be
-produced, when the <strong><code>fancyLists</code></strong> option is
+produced, when the <code><strong>fancyLists</strong></code> option is
disabled. The macro receives no arguments.</p>
-<p>The <code>\markdownRendererOlBeginTight</code> macro represents the
+<p>The <code>markdownRendererOlBeginTight</code> macro represents the
beginning of an ordered list that contains no item with several
paragraphs of text (the list is tight). This macro will only be
-produced, when the <strong><code>tightLists</code></strong> option is
-enabled and the <strong><code>fancyLists</code></strong> option is
+produced, when the <code><strong>tightLists</strong></code> option is
+enabled and the <code><strong>fancyLists</strong></code> option is
disabled. The macro receives no arguments.</p>
-<p>The <code>\markdownRendererFancyOlBegin</code> macro represents the
+<p>The <code>markdownRendererFancyOlBegin</code> macro represents the
beginning of a fancy ordered list that contains an item with several
paragraphs of text (the list is not tight). This macro will only be
-produced, when the <strong><code>fancyLists</code></strong> option is
+produced, when the <code><strong>fancyLists</strong></code> option is
enabled. The macro receives two arguments: the style of the list item
labels (<code>Decimal</code>, <code>LowerRoman</code>,
<code>UpperRoman</code>, <code>LowerAlpha</code>, and
<code>UpperAlpha</code>), and the style of delimiters between list item
labels and texts (<code>Default</code>, <code>OneParen</code>, and
<code>Period</code>).</p>
-<p>The <code>\markdownRendererFancyOlBeginTight</code> macro represents
+<p>The <code>markdownRendererFancyOlBeginTight</code> macro represents
the beginning of a fancy ordered list that contains no item with several
paragraphs of text (the list is tight). This macro will only be
-produced, when the <strong><code>fancyLists</code></strong> and
-<strong><code>tightLists</code></strong> options are enabled. The macro
+produced, when the <code><strong>fancyLists</strong></code> and
+<code><strong>tightLists</strong></code> options are enabled. The macro
receives two arguments: the style of the list item labels, and the style
of delimiters between list item labels and texts. See the
-<code>\markdownRendererFancyOlBegin</code> macro for the valid style
+<code>markdownRendererFancyOlBegin</code> macro for the valid style
values.</p>
-<p>The <code>\markdownRendererOlItem</code> macro represents an item in
+<p>The <code>markdownRendererOlItem</code> macro represents an item in
an ordered list. This macro will only be produced, when the
-<strong><code>startNumber</code></strong> option is disabled and the
-<strong><code>fancyLists</code></strong> option is disabled. The macro
+<code><strong>startNumber</strong></code> option is disabled and the
+<code><strong>fancyLists</strong></code> option is disabled. The macro
receives no arguments.</p>
-<p>The <code>\markdownRendererOlItemEnd</code> macro represents the end
+<p>The <code>markdownRendererOlItemEnd</code> macro represents the end
of an item in an ordered list. This macro will only be produced, when
-the <strong><code>fancyLists</code></strong> option is disabled. The
+the <code><strong>fancyLists</strong></code> option is disabled. The
macro receives no arguments.</p>
-<p>The <code>\markdownRendererOlItemWithNumber</code> macro represents
-an item in an ordered list. This macro will only be produced, when the
-<strong><code>startNumber</code></strong> option is enabled and the
-<strong><code>fancyLists</code></strong> option is disabled. The macro
+<p>The <code>markdownRendererOlItemWithNumber</code> macro represents an
+item in an ordered list. This macro will only be produced, when the
+<code><strong>startNumber</strong></code> option is enabled and the
+<code><strong>fancyLists</strong></code> option is disabled. The macro
receives a single numeric argument that corresponds to the item
number.</p>
-<p>The <code>\markdownRendererFancyOlItem</code> macro represents an
-item in a fancy ordered list. This macro will only be produced, when the
-<strong><code>startNumber</code></strong> option is disabled and the
-<strong><code>fancyLists</code></strong> option is enabled. The macro
+<p>The <code>markdownRendererFancyOlItem</code> macro represents an item
+in a fancy ordered list. This macro will only be produced, when the
+<code><strong>startNumber</strong></code> option is disabled and the
+<code><strong>fancyLists</strong></code> option is enabled. The macro
receives no arguments.</p>
-<p>The <code>\markdownRendererFancyOlItemEnd</code> macro represents the
+<p>The <code>markdownRendererFancyOlItemEnd</code> macro represents the
end of an item in a fancy ordered list. This macro will only be
-produced, when the <strong><code>fancyLists</code></strong> option is
+produced, when the <code><strong>fancyLists</strong></code> option is
enabled. The macro receives no arguments.</p>
-<p>The <code>\markdownRendererFancyOlItemWithNumber</code> macro
+<p>The <code>markdownRendererFancyOlItemWithNumber</code> macro
represents an item in a fancy ordered list. This macro will only be
-produced, when the <strong><code>startNumber</code></strong> and
-<strong><code>fancyLists</code></strong> options are enabled. The macro
+produced, when the <code><strong>startNumber</strong></code> and
+<code><strong>fancyLists</strong></code> options are enabled. The macro
receives a single numeric argument that corresponds to the item
number.</p>
-<p>The <code>\markdownRendererOlEnd</code> macro represents the end of
-an ordered list that contains an item with several paragraphs of text
-(the list is not tight). This macro will only be produced, when the
-<strong><code>fancyLists</code></strong> option is disabled. The macro
+<p>The <code>markdownRendererOlEnd</code> macro represents the end of an
+ordered list that contains an item with several paragraphs of text (the
+list is not tight). This macro will only be produced, when the
+<code><strong>fancyLists</strong></code> option is disabled. The macro
receives no arguments.</p>
-<p>The <code>\markdownRendererOlEndTight</code> macro represents the end
+<p>The <code>markdownRendererOlEndTight</code> macro represents the end
of an ordered list that contains no item with several paragraphs of text
(the list is tight). This macro will only be produced, when the
-<strong><code>tightLists</code></strong> option is enabled and the
-<strong><code>fancyLists</code></strong> option is disabled. The macro
+<code><strong>tightLists</strong></code> option is enabled and the
+<code><strong>fancyLists</strong></code> option is disabled. The macro
receives no arguments.</p>
-<p>The <code>\markdownRendererFancyOlEnd</code> macro represents the end
+<p>The <code>markdownRendererFancyOlEnd</code> macro represents the end
of a fancy ordered list that contains an item with several paragraphs of
text (the list is not tight). This macro will only be produced, when the
-<strong><code>fancyLists</code></strong> option is enabled. The macro
+<code><strong>fancyLists</strong></code> option is enabled. The macro
receives no arguments.</p>
-<p>The <code>\markdownRendererFancyOlEndTight</code> macro represents
-the end of a fancy ordered list that contains no item with several
+<p>The <code>markdownRendererFancyOlEndTight</code> macro represents the
+end of a fancy ordered list that contains no item with several
paragraphs of text (the list is tight). This macro will only be
-produced, when the <strong><code>fancyLists</code></strong> and
-<strong><code>tightLists</code></strong> options are enabled. The macro
+produced, when the <code><strong>fancyLists</strong></code> and
+<code><strong>tightLists</strong></code> options are enabled. The macro
receives no arguments.</p>
<h5 class="unnumbered" id="plain-tex-example-39">Plain <span
class="tex">T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb612"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb612-1"><a href="#cb612-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
-<span id="cb612-2"><a href="#cb612-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionTightLists</span>{true}</span>
-<span id="cb612-3"><a href="#cb612-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionStartNumber</span>{true}</span>
-<span id="cb612-4"><a href="#cb612-4" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb612-5"><a href="#cb612-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{}</span>
-<span id="cb612-6"><a href="#cb612-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererOlBeginTight</span>{ (}</span>
-<span id="cb612-7"><a href="#cb612-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererOlItemWithNumber</span>#1{<span class="co">%</span></span>
-<span id="cb612-8"><a href="#cb612-8" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifnum</span> #1=1<span class="fu">\relax</span></span>
-<span id="cb612-9"><a href="#cb612-9" aria-hidden="true" tabindex="-1"></a> the first</span>
-<span id="cb612-10"><a href="#cb612-10" aria-hidden="true" tabindex="-1"></a> <span class="fu">\else</span></span>
-<span id="cb612-11"><a href="#cb612-11" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifnum</span> #1=2<span class="fu">\relax</span></span>
-<span id="cb612-12"><a href="#cb612-12" aria-hidden="true" tabindex="-1"></a> , the second</span>
-<span id="cb612-13"><a href="#cb612-13" aria-hidden="true" tabindex="-1"></a> <span class="fu">\else</span></span>
-<span id="cb612-14"><a href="#cb612-14" aria-hidden="true" tabindex="-1"></a> , and the third</span>
-<span id="cb612-15"><a href="#cb612-15" aria-hidden="true" tabindex="-1"></a> <span class="fu">\fi</span></span>
-<span id="cb612-16"><a href="#cb612-16" aria-hidden="true" tabindex="-1"></a> <span class="fu">\fi</span></span>
-<span id="cb612-17"><a href="#cb612-17" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb612-18"><a href="#cb612-18" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererOlItemEnd</span>{}</span>
-<span id="cb612-19"><a href="#cb612-19" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererOlEndTight</span>{).}</span>
-<span id="cb612-20"><a href="#cb612-20" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb612-21"><a href="#cb612-21" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
-<span id="cb612-22"><a href="#cb612-22" aria-hidden="true" tabindex="-1"></a>This is a tight list</span>
-<span id="cb612-23"><a href="#cb612-23" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb612-24"><a href="#cb612-24" aria-hidden="true" tabindex="-1"></a>1. item</span>
-<span id="cb612-25"><a href="#cb612-25" aria-hidden="true" tabindex="-1"></a>2. item</span>
-<span id="cb612-26"><a href="#cb612-26" aria-hidden="true" tabindex="-1"></a>3. item</span>
-<span id="cb612-27"><a href="#cb612-27" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
-<span id="cb612-28"><a href="#cb612-28" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb612-29"><a href="#cb612-29" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span>
-<span id="cb612-30"><a href="#cb612-30" aria-hidden="true" tabindex="-1"></a> :<span class="fu">\par</span></span>
-<span id="cb612-31"><a href="#cb612-31" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="fu">\par</span>}<span class="co">%</span></span>
-<span id="cb612-32"><a href="#cb612-32" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb612-33"><a href="#cb612-33" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererOlBegin</span>{}</span>
-<span id="cb612-34"><a href="#cb612-34" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererOlItemWithNumber</span>#1{<span class="co">%</span></span>
-<span id="cb612-35"><a href="#cb612-35" aria-hidden="true" tabindex="-1"></a> #1.<span class="fu">\kern</span> 0.5em<span class="co">%</span></span>
-<span id="cb612-36"><a href="#cb612-36" aria-hidden="true" tabindex="-1"></a> This is the</span>
-<span id="cb612-37"><a href="#cb612-37" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifnum</span> #1=1<span class="fu">\relax</span></span>
-<span id="cb612-38"><a href="#cb612-38" aria-hidden="true" tabindex="-1"></a> first</span>
-<span id="cb612-39"><a href="#cb612-39" aria-hidden="true" tabindex="-1"></a> <span class="fu">\else</span></span>
-<span id="cb612-40"><a href="#cb612-40" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifnum</span> #1=2<span class="fu">\relax</span></span>
-<span id="cb612-41"><a href="#cb612-41" aria-hidden="true" tabindex="-1"></a> second</span>
-<span id="cb612-42"><a href="#cb612-42" aria-hidden="true" tabindex="-1"></a> <span class="fu">\else</span></span>
-<span id="cb612-43"><a href="#cb612-43" aria-hidden="true" tabindex="-1"></a> third</span>
-<span id="cb612-44"><a href="#cb612-44" aria-hidden="true" tabindex="-1"></a> <span class="fu">\fi</span></span>
-<span id="cb612-45"><a href="#cb612-45" aria-hidden="true" tabindex="-1"></a> <span class="fu">\fi</span></span>
-<span id="cb612-46"><a href="#cb612-46" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb612-47"><a href="#cb612-47" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererOlItemEnd</span>{.<span class="fu">\par</span>}</span>
-<span id="cb612-48"><a href="#cb612-48" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererOlEnd</span>{}</span>
-<span id="cb612-49"><a href="#cb612-49" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb612-50"><a href="#cb612-50" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
-<span id="cb612-51"><a href="#cb612-51" aria-hidden="true" tabindex="-1"></a>This is a loose list</span>
-<span id="cb612-52"><a href="#cb612-52" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb612-53"><a href="#cb612-53" aria-hidden="true" tabindex="-1"></a>1. item</span>
-<span id="cb612-54"><a href="#cb612-54" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb612-55"><a href="#cb612-55" aria-hidden="true" tabindex="-1"></a>2. item</span>
-<span id="cb612-56"><a href="#cb612-56" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb612-57"><a href="#cb612-57" aria-hidden="true" tabindex="-1"></a>3. item</span>
-<span id="cb612-58"><a href="#cb612-58" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
-<span id="cb612-59"><a href="#cb612-59" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb612-60"><a href="#cb612-60" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb615"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb615-1"><a href="#cb615-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
+<span id="cb615-2"><a href="#cb615-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionTightLists</span>{true}</span>
+<span id="cb615-3"><a href="#cb615-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionStartNumber</span>{true}</span>
+<span id="cb615-4"><a href="#cb615-4" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb615-5"><a href="#cb615-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{}</span>
+<span id="cb615-6"><a href="#cb615-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererOlBeginTight</span>{ (}</span>
+<span id="cb615-7"><a href="#cb615-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererOlItemWithNumber</span>#1{<span class="co">%</span></span>
+<span id="cb615-8"><a href="#cb615-8" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifnum</span> #1=1<span class="fu">\relax</span></span>
+<span id="cb615-9"><a href="#cb615-9" aria-hidden="true" tabindex="-1"></a> the first</span>
+<span id="cb615-10"><a href="#cb615-10" aria-hidden="true" tabindex="-1"></a> <span class="fu">\else</span></span>
+<span id="cb615-11"><a href="#cb615-11" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifnum</span> #1=2<span class="fu">\relax</span></span>
+<span id="cb615-12"><a href="#cb615-12" aria-hidden="true" tabindex="-1"></a> , the second</span>
+<span id="cb615-13"><a href="#cb615-13" aria-hidden="true" tabindex="-1"></a> <span class="fu">\else</span></span>
+<span id="cb615-14"><a href="#cb615-14" aria-hidden="true" tabindex="-1"></a> , and the third</span>
+<span id="cb615-15"><a href="#cb615-15" aria-hidden="true" tabindex="-1"></a> <span class="fu">\fi</span></span>
+<span id="cb615-16"><a href="#cb615-16" aria-hidden="true" tabindex="-1"></a> <span class="fu">\fi</span></span>
+<span id="cb615-17"><a href="#cb615-17" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb615-18"><a href="#cb615-18" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererOlItemEnd</span>{}</span>
+<span id="cb615-19"><a href="#cb615-19" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererOlEndTight</span>{).}</span>
+<span id="cb615-20"><a href="#cb615-20" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb615-21"><a href="#cb615-21" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
+<span id="cb615-22"><a href="#cb615-22" aria-hidden="true" tabindex="-1"></a>This is a tight list</span>
+<span id="cb615-23"><a href="#cb615-23" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb615-24"><a href="#cb615-24" aria-hidden="true" tabindex="-1"></a>1. item</span>
+<span id="cb615-25"><a href="#cb615-25" aria-hidden="true" tabindex="-1"></a>2. item</span>
+<span id="cb615-26"><a href="#cb615-26" aria-hidden="true" tabindex="-1"></a>3. item</span>
+<span id="cb615-27"><a href="#cb615-27" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
+<span id="cb615-28"><a href="#cb615-28" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb615-29"><a href="#cb615-29" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span>
+<span id="cb615-30"><a href="#cb615-30" aria-hidden="true" tabindex="-1"></a> :<span class="fu">\par</span></span>
+<span id="cb615-31"><a href="#cb615-31" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="fu">\par</span>}<span class="co">%</span></span>
+<span id="cb615-32"><a href="#cb615-32" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb615-33"><a href="#cb615-33" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererOlBegin</span>{}</span>
+<span id="cb615-34"><a href="#cb615-34" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererOlItemWithNumber</span>#1{<span class="co">%</span></span>
+<span id="cb615-35"><a href="#cb615-35" aria-hidden="true" tabindex="-1"></a> #1.<span class="fu">\kern</span> 0.5em<span class="co">%</span></span>
+<span id="cb615-36"><a href="#cb615-36" aria-hidden="true" tabindex="-1"></a> This is the</span>
+<span id="cb615-37"><a href="#cb615-37" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifnum</span> #1=1<span class="fu">\relax</span></span>
+<span id="cb615-38"><a href="#cb615-38" aria-hidden="true" tabindex="-1"></a> first</span>
+<span id="cb615-39"><a href="#cb615-39" aria-hidden="true" tabindex="-1"></a> <span class="fu">\else</span></span>
+<span id="cb615-40"><a href="#cb615-40" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifnum</span> #1=2<span class="fu">\relax</span></span>
+<span id="cb615-41"><a href="#cb615-41" aria-hidden="true" tabindex="-1"></a> second</span>
+<span id="cb615-42"><a href="#cb615-42" aria-hidden="true" tabindex="-1"></a> <span class="fu">\else</span></span>
+<span id="cb615-43"><a href="#cb615-43" aria-hidden="true" tabindex="-1"></a> third</span>
+<span id="cb615-44"><a href="#cb615-44" aria-hidden="true" tabindex="-1"></a> <span class="fu">\fi</span></span>
+<span id="cb615-45"><a href="#cb615-45" aria-hidden="true" tabindex="-1"></a> <span class="fu">\fi</span></span>
+<span id="cb615-46"><a href="#cb615-46" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb615-47"><a href="#cb615-47" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererOlItemEnd</span>{.<span class="fu">\par</span>}</span>
+<span id="cb615-48"><a href="#cb615-48" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererOlEnd</span>{}</span>
+<span id="cb615-49"><a href="#cb615-49" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb615-50"><a href="#cb615-50" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
+<span id="cb615-51"><a href="#cb615-51" aria-hidden="true" tabindex="-1"></a>This is a loose list</span>
+<span id="cb615-52"><a href="#cb615-52" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb615-53"><a href="#cb615-53" aria-hidden="true" tabindex="-1"></a>1. item</span>
+<span id="cb615-54"><a href="#cb615-54" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb615-55"><a href="#cb615-55" aria-hidden="true" tabindex="-1"></a>2. item</span>
+<span id="cb615-56"><a href="#cb615-56" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb615-57"><a href="#cb615-57" aria-hidden="true" tabindex="-1"></a>3. item</span>
+<span id="cb615-58"><a href="#cb615-58" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
+<span id="cb615-59"><a href="#cb615-59" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb615-60"><a href="#cb615-60" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb613"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb613-1"><a href="#cb613-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb616"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb616-1"><a href="#cb616-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -11414,73 +11507,73 @@ item).</p>
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb614"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb614-1"><a href="#cb614-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb614-2"><a href="#cb614-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[tightLists, startNumber]{<span class="ex">markdown</span>}</span>
-<span id="cb614-3"><a href="#cb614-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb614-4"><a href="#cb614-4" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb614-5"><a href="#cb614-5" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}[</span>
-<span id="cb614-6"><a href="#cb614-6" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb614-7"><a href="#cb614-7" aria-hidden="true" tabindex="-1"></a> interblockSeparator = {},</span>
-<span id="cb614-8"><a href="#cb614-8" aria-hidden="true" tabindex="-1"></a> olBeginTight = { (},</span>
-<span id="cb614-9"><a href="#cb614-9" aria-hidden="true" tabindex="-1"></a> olItemWithNumber = {<span class="co">%</span></span>
-<span id="cb614-10"><a href="#cb614-10" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifnum</span> #1=1<span class="fu">\relax</span></span>
-<span id="cb614-11"><a href="#cb614-11" aria-hidden="true" tabindex="-1"></a> the first</span>
-<span id="cb614-12"><a href="#cb614-12" aria-hidden="true" tabindex="-1"></a> <span class="fu">\else</span></span>
-<span id="cb614-13"><a href="#cb614-13" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifnum</span> #1=2<span class="fu">\relax</span></span>
-<span id="cb614-14"><a href="#cb614-14" aria-hidden="true" tabindex="-1"></a> , the second</span>
-<span id="cb614-15"><a href="#cb614-15" aria-hidden="true" tabindex="-1"></a> <span class="fu">\else</span></span>
-<span id="cb614-16"><a href="#cb614-16" aria-hidden="true" tabindex="-1"></a> , and the third</span>
-<span id="cb614-17"><a href="#cb614-17" aria-hidden="true" tabindex="-1"></a> <span class="fu">\fi</span></span>
-<span id="cb614-18"><a href="#cb614-18" aria-hidden="true" tabindex="-1"></a> <span class="fu">\fi</span></span>
-<span id="cb614-19"><a href="#cb614-19" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb614-20"><a href="#cb614-20" aria-hidden="true" tabindex="-1"></a> olItemEnd = {},</span>
-<span id="cb614-21"><a href="#cb614-21" aria-hidden="true" tabindex="-1"></a> olEndTight = {).},</span>
-<span id="cb614-22"><a href="#cb614-22" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb614-23"><a href="#cb614-23" aria-hidden="true" tabindex="-1"></a>]</span>
-<span id="cb614-24"><a href="#cb614-24" aria-hidden="true" tabindex="-1"></a>This is a tight list</span>
-<span id="cb614-25"><a href="#cb614-25" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb614-26"><a href="#cb614-26" aria-hidden="true" tabindex="-1"></a>1. item</span>
-<span id="cb614-27"><a href="#cb614-27" aria-hidden="true" tabindex="-1"></a>2. item</span>
-<span id="cb614-28"><a href="#cb614-28" aria-hidden="true" tabindex="-1"></a>3. item</span>
-<span id="cb614-29"><a href="#cb614-29" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb614-30"><a href="#cb614-30" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb614-31"><a href="#cb614-31" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}[</span>
-<span id="cb614-32"><a href="#cb614-32" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb614-33"><a href="#cb614-33" aria-hidden="true" tabindex="-1"></a> interblockSeparator = {<span class="co">%</span></span>
-<span id="cb614-34"><a href="#cb614-34" aria-hidden="true" tabindex="-1"></a> :<span class="fu">\par</span></span>
-<span id="cb614-35"><a href="#cb614-35" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="fu">\par</span>}<span class="co">%</span></span>
-<span id="cb614-36"><a href="#cb614-36" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb614-37"><a href="#cb614-37" aria-hidden="true" tabindex="-1"></a> olBeginTight = {<span class="kw">\begin</span>{<span class="ex">enumerate</span>}},</span>
-<span id="cb614-38"><a href="#cb614-38" aria-hidden="true" tabindex="-1"></a> olItemWithNumber = {<span class="co">%</span></span>
-<span id="cb614-39"><a href="#cb614-39" aria-hidden="true" tabindex="-1"></a> <span class="fu">\item</span> This is the</span>
-<span id="cb614-40"><a href="#cb614-40" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifnum</span> #1=1<span class="fu">\relax</span></span>
-<span id="cb614-41"><a href="#cb614-41" aria-hidden="true" tabindex="-1"></a> first</span>
-<span id="cb614-42"><a href="#cb614-42" aria-hidden="true" tabindex="-1"></a> <span class="fu">\else</span></span>
-<span id="cb614-43"><a href="#cb614-43" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifnum</span> #1=2<span class="fu">\relax</span></span>
-<span id="cb614-44"><a href="#cb614-44" aria-hidden="true" tabindex="-1"></a> second</span>
-<span id="cb614-45"><a href="#cb614-45" aria-hidden="true" tabindex="-1"></a> <span class="fu">\else</span></span>
-<span id="cb614-46"><a href="#cb614-46" aria-hidden="true" tabindex="-1"></a> third</span>
-<span id="cb614-47"><a href="#cb614-47" aria-hidden="true" tabindex="-1"></a> <span class="fu">\fi</span></span>
-<span id="cb614-48"><a href="#cb614-48" aria-hidden="true" tabindex="-1"></a> <span class="fu">\fi</span></span>
-<span id="cb614-49"><a href="#cb614-49" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb614-50"><a href="#cb614-50" aria-hidden="true" tabindex="-1"></a> olItemEnd = {.},</span>
-<span id="cb614-51"><a href="#cb614-51" aria-hidden="true" tabindex="-1"></a> olEnd = {<span class="kw">\end</span>{<span class="ex">enumerate</span>}},</span>
-<span id="cb614-52"><a href="#cb614-52" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb614-53"><a href="#cb614-53" aria-hidden="true" tabindex="-1"></a>]</span>
-<span id="cb614-54"><a href="#cb614-54" aria-hidden="true" tabindex="-1"></a>This is a loose list</span>
-<span id="cb614-55"><a href="#cb614-55" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb614-56"><a href="#cb614-56" aria-hidden="true" tabindex="-1"></a>1. item</span>
-<span id="cb614-57"><a href="#cb614-57" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb614-58"><a href="#cb614-58" aria-hidden="true" tabindex="-1"></a>2. item</span>
-<span id="cb614-59"><a href="#cb614-59" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb614-60"><a href="#cb614-60" aria-hidden="true" tabindex="-1"></a>3. item</span>
-<span id="cb614-61"><a href="#cb614-61" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb614-62"><a href="#cb614-62" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb614-63"><a href="#cb614-63" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb617"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb617-1"><a href="#cb617-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb617-2"><a href="#cb617-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[tightLists, startNumber]{<span class="ex">markdown</span>}</span>
+<span id="cb617-3"><a href="#cb617-3" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb617-4"><a href="#cb617-4" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb617-5"><a href="#cb617-5" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}[</span>
+<span id="cb617-6"><a href="#cb617-6" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb617-7"><a href="#cb617-7" aria-hidden="true" tabindex="-1"></a> interblockSeparator = {},</span>
+<span id="cb617-8"><a href="#cb617-8" aria-hidden="true" tabindex="-1"></a> olBeginTight = { (},</span>
+<span id="cb617-9"><a href="#cb617-9" aria-hidden="true" tabindex="-1"></a> olItemWithNumber = {<span class="co">%</span></span>
+<span id="cb617-10"><a href="#cb617-10" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifnum</span> #1=1<span class="fu">\relax</span></span>
+<span id="cb617-11"><a href="#cb617-11" aria-hidden="true" tabindex="-1"></a> the first</span>
+<span id="cb617-12"><a href="#cb617-12" aria-hidden="true" tabindex="-1"></a> <span class="fu">\else</span></span>
+<span id="cb617-13"><a href="#cb617-13" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifnum</span> #1=2<span class="fu">\relax</span></span>
+<span id="cb617-14"><a href="#cb617-14" aria-hidden="true" tabindex="-1"></a> , the second</span>
+<span id="cb617-15"><a href="#cb617-15" aria-hidden="true" tabindex="-1"></a> <span class="fu">\else</span></span>
+<span id="cb617-16"><a href="#cb617-16" aria-hidden="true" tabindex="-1"></a> , and the third</span>
+<span id="cb617-17"><a href="#cb617-17" aria-hidden="true" tabindex="-1"></a> <span class="fu">\fi</span></span>
+<span id="cb617-18"><a href="#cb617-18" aria-hidden="true" tabindex="-1"></a> <span class="fu">\fi</span></span>
+<span id="cb617-19"><a href="#cb617-19" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb617-20"><a href="#cb617-20" aria-hidden="true" tabindex="-1"></a> olItemEnd = {},</span>
+<span id="cb617-21"><a href="#cb617-21" aria-hidden="true" tabindex="-1"></a> olEndTight = {).},</span>
+<span id="cb617-22"><a href="#cb617-22" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb617-23"><a href="#cb617-23" aria-hidden="true" tabindex="-1"></a>]</span>
+<span id="cb617-24"><a href="#cb617-24" aria-hidden="true" tabindex="-1"></a>This is a tight list</span>
+<span id="cb617-25"><a href="#cb617-25" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb617-26"><a href="#cb617-26" aria-hidden="true" tabindex="-1"></a>1. item</span>
+<span id="cb617-27"><a href="#cb617-27" aria-hidden="true" tabindex="-1"></a>2. item</span>
+<span id="cb617-28"><a href="#cb617-28" aria-hidden="true" tabindex="-1"></a>3. item</span>
+<span id="cb617-29"><a href="#cb617-29" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb617-30"><a href="#cb617-30" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb617-31"><a href="#cb617-31" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}[</span>
+<span id="cb617-32"><a href="#cb617-32" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb617-33"><a href="#cb617-33" aria-hidden="true" tabindex="-1"></a> interblockSeparator = {<span class="co">%</span></span>
+<span id="cb617-34"><a href="#cb617-34" aria-hidden="true" tabindex="-1"></a> :<span class="fu">\par</span></span>
+<span id="cb617-35"><a href="#cb617-35" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="fu">\par</span>}<span class="co">%</span></span>
+<span id="cb617-36"><a href="#cb617-36" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb617-37"><a href="#cb617-37" aria-hidden="true" tabindex="-1"></a> olBeginTight = {<span class="kw">\begin</span>{<span class="ex">enumerate</span>}},</span>
+<span id="cb617-38"><a href="#cb617-38" aria-hidden="true" tabindex="-1"></a> olItemWithNumber = {<span class="co">%</span></span>
+<span id="cb617-39"><a href="#cb617-39" aria-hidden="true" tabindex="-1"></a> <span class="fu">\item</span> This is the</span>
+<span id="cb617-40"><a href="#cb617-40" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifnum</span> #1=1<span class="fu">\relax</span></span>
+<span id="cb617-41"><a href="#cb617-41" aria-hidden="true" tabindex="-1"></a> first</span>
+<span id="cb617-42"><a href="#cb617-42" aria-hidden="true" tabindex="-1"></a> <span class="fu">\else</span></span>
+<span id="cb617-43"><a href="#cb617-43" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifnum</span> #1=2<span class="fu">\relax</span></span>
+<span id="cb617-44"><a href="#cb617-44" aria-hidden="true" tabindex="-1"></a> second</span>
+<span id="cb617-45"><a href="#cb617-45" aria-hidden="true" tabindex="-1"></a> <span class="fu">\else</span></span>
+<span id="cb617-46"><a href="#cb617-46" aria-hidden="true" tabindex="-1"></a> third</span>
+<span id="cb617-47"><a href="#cb617-47" aria-hidden="true" tabindex="-1"></a> <span class="fu">\fi</span></span>
+<span id="cb617-48"><a href="#cb617-48" aria-hidden="true" tabindex="-1"></a> <span class="fu">\fi</span></span>
+<span id="cb617-49"><a href="#cb617-49" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb617-50"><a href="#cb617-50" aria-hidden="true" tabindex="-1"></a> olItemEnd = {.},</span>
+<span id="cb617-51"><a href="#cb617-51" aria-hidden="true" tabindex="-1"></a> olEnd = {<span class="kw">\end</span>{<span class="ex">enumerate</span>}},</span>
+<span id="cb617-52"><a href="#cb617-52" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb617-53"><a href="#cb617-53" aria-hidden="true" tabindex="-1"></a>]</span>
+<span id="cb617-54"><a href="#cb617-54" aria-hidden="true" tabindex="-1"></a>This is a loose list</span>
+<span id="cb617-55"><a href="#cb617-55" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb617-56"><a href="#cb617-56" aria-hidden="true" tabindex="-1"></a>1. item</span>
+<span id="cb617-57"><a href="#cb617-57" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb617-58"><a href="#cb617-58" aria-hidden="true" tabindex="-1"></a>2. item</span>
+<span id="cb617-59"><a href="#cb617-59" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb617-60"><a href="#cb617-60" aria-hidden="true" tabindex="-1"></a>3. item</span>
+<span id="cb617-61"><a href="#cb617-61" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb617-62"><a href="#cb617-62" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb617-63"><a href="#cb617-63" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb615"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb615-1"><a href="#cb615-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb618"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb618-1"><a href="#cb618-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -11497,74 +11590,74 @@ item).</p>
class="tex">T<sub>e</sub>X</span>t Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb616"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb616-1"><a href="#cb616-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
-<span id="cb616-2"><a href="#cb616-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span></span>
-<span id="cb616-3"><a href="#cb616-3" aria-hidden="true" tabindex="-1"></a> [</span>
-<span id="cb616-4"><a href="#cb616-4" aria-hidden="true" tabindex="-1"></a> tightLists = yes,</span>
-<span id="cb616-5"><a href="#cb616-5" aria-hidden="true" tabindex="-1"></a> startNumber = yes,</span>
-<span id="cb616-6"><a href="#cb616-6" aria-hidden="true" tabindex="-1"></a> ]</span>
-<span id="cb616-7"><a href="#cb616-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
-<span id="cb616-8"><a href="#cb616-8" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb616-9"><a href="#cb616-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{}</span>
-<span id="cb616-10"><a href="#cb616-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererOlBeginTight</span>{ (}</span>
-<span id="cb616-11"><a href="#cb616-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererOlItemWithNumber</span>#1{<span class="co">%</span></span>
-<span id="cb616-12"><a href="#cb616-12" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifnum</span> #1=1<span class="fu">\relax</span></span>
-<span id="cb616-13"><a href="#cb616-13" aria-hidden="true" tabindex="-1"></a> the first</span>
-<span id="cb616-14"><a href="#cb616-14" aria-hidden="true" tabindex="-1"></a> <span class="fu">\else</span></span>
-<span id="cb616-15"><a href="#cb616-15" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifnum</span> #1=2<span class="fu">\relax</span></span>
-<span id="cb616-16"><a href="#cb616-16" aria-hidden="true" tabindex="-1"></a> , the second</span>
-<span id="cb616-17"><a href="#cb616-17" aria-hidden="true" tabindex="-1"></a> <span class="fu">\else</span></span>
-<span id="cb616-18"><a href="#cb616-18" aria-hidden="true" tabindex="-1"></a> , and the third</span>
-<span id="cb616-19"><a href="#cb616-19" aria-hidden="true" tabindex="-1"></a> <span class="fu">\fi</span></span>
-<span id="cb616-20"><a href="#cb616-20" aria-hidden="true" tabindex="-1"></a> <span class="fu">\fi</span></span>
-<span id="cb616-21"><a href="#cb616-21" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb616-22"><a href="#cb616-22" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererOlItemEnd</span>{}</span>
-<span id="cb616-23"><a href="#cb616-23" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererOlEndTight</span>{).}</span>
-<span id="cb616-24"><a href="#cb616-24" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb616-25"><a href="#cb616-25" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb616-26"><a href="#cb616-26" aria-hidden="true" tabindex="-1"></a>This is a tight list</span>
-<span id="cb616-27"><a href="#cb616-27" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb616-28"><a href="#cb616-28" aria-hidden="true" tabindex="-1"></a>1. item</span>
-<span id="cb616-29"><a href="#cb616-29" aria-hidden="true" tabindex="-1"></a>2. item</span>
-<span id="cb616-30"><a href="#cb616-30" aria-hidden="true" tabindex="-1"></a>3. item</span>
-<span id="cb616-31"><a href="#cb616-31" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb616-32"><a href="#cb616-32" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb616-33"><a href="#cb616-33" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span>
-<span id="cb616-34"><a href="#cb616-34" aria-hidden="true" tabindex="-1"></a> :<span class="fu">\par</span></span>
-<span id="cb616-35"><a href="#cb616-35" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="fu">\par</span>}<span class="co">%</span></span>
-<span id="cb616-36"><a href="#cb616-36" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb616-37"><a href="#cb616-37" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererOlBegin</span>{<span class="fu">\startitemize</span>}</span>
-<span id="cb616-38"><a href="#cb616-38" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererOlItemWithNumber</span>#1{<span class="co">%</span></span>
-<span id="cb616-39"><a href="#cb616-39" aria-hidden="true" tabindex="-1"></a> <span class="fu">\sym</span>{#1.}</span>
-<span id="cb616-40"><a href="#cb616-40" aria-hidden="true" tabindex="-1"></a> This is the</span>
-<span id="cb616-41"><a href="#cb616-41" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifnum</span> #1=1<span class="fu">\relax</span></span>
-<span id="cb616-42"><a href="#cb616-42" aria-hidden="true" tabindex="-1"></a> first</span>
-<span id="cb616-43"><a href="#cb616-43" aria-hidden="true" tabindex="-1"></a> <span class="fu">\else</span></span>
-<span id="cb616-44"><a href="#cb616-44" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifnum</span> #1=2<span class="fu">\relax</span></span>
-<span id="cb616-45"><a href="#cb616-45" aria-hidden="true" tabindex="-1"></a> second</span>
-<span id="cb616-46"><a href="#cb616-46" aria-hidden="true" tabindex="-1"></a> <span class="fu">\else</span></span>
-<span id="cb616-47"><a href="#cb616-47" aria-hidden="true" tabindex="-1"></a> third</span>
-<span id="cb616-48"><a href="#cb616-48" aria-hidden="true" tabindex="-1"></a> <span class="fu">\fi</span></span>
-<span id="cb616-49"><a href="#cb616-49" aria-hidden="true" tabindex="-1"></a> <span class="fu">\fi</span></span>
-<span id="cb616-50"><a href="#cb616-50" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb616-51"><a href="#cb616-51" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererOlItemEnd</span>{.<span class="fu">\par</span>}</span>
-<span id="cb616-52"><a href="#cb616-52" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererOlEnd</span>{<span class="fu">\stopitemize</span>}</span>
-<span id="cb616-53"><a href="#cb616-53" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb616-54"><a href="#cb616-54" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb616-55"><a href="#cb616-55" aria-hidden="true" tabindex="-1"></a>This is a loose list</span>
-<span id="cb616-56"><a href="#cb616-56" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb616-57"><a href="#cb616-57" aria-hidden="true" tabindex="-1"></a>1. item</span>
-<span id="cb616-58"><a href="#cb616-58" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb616-59"><a href="#cb616-59" aria-hidden="true" tabindex="-1"></a>2. item</span>
-<span id="cb616-60"><a href="#cb616-60" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb616-61"><a href="#cb616-61" aria-hidden="true" tabindex="-1"></a>3. item</span>
-<span id="cb616-62"><a href="#cb616-62" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb616-63"><a href="#cb616-63" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb616-64"><a href="#cb616-64" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
+<div class="sourceCode" id="cb619"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb619-1"><a href="#cb619-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
+<span id="cb619-2"><a href="#cb619-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span></span>
+<span id="cb619-3"><a href="#cb619-3" aria-hidden="true" tabindex="-1"></a> [</span>
+<span id="cb619-4"><a href="#cb619-4" aria-hidden="true" tabindex="-1"></a> tightLists = yes,</span>
+<span id="cb619-5"><a href="#cb619-5" aria-hidden="true" tabindex="-1"></a> startNumber = yes,</span>
+<span id="cb619-6"><a href="#cb619-6" aria-hidden="true" tabindex="-1"></a> ]</span>
+<span id="cb619-7"><a href="#cb619-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
+<span id="cb619-8"><a href="#cb619-8" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb619-9"><a href="#cb619-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{}</span>
+<span id="cb619-10"><a href="#cb619-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererOlBeginTight</span>{ (}</span>
+<span id="cb619-11"><a href="#cb619-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererOlItemWithNumber</span>#1{<span class="co">%</span></span>
+<span id="cb619-12"><a href="#cb619-12" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifnum</span> #1=1<span class="fu">\relax</span></span>
+<span id="cb619-13"><a href="#cb619-13" aria-hidden="true" tabindex="-1"></a> the first</span>
+<span id="cb619-14"><a href="#cb619-14" aria-hidden="true" tabindex="-1"></a> <span class="fu">\else</span></span>
+<span id="cb619-15"><a href="#cb619-15" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifnum</span> #1=2<span class="fu">\relax</span></span>
+<span id="cb619-16"><a href="#cb619-16" aria-hidden="true" tabindex="-1"></a> , the second</span>
+<span id="cb619-17"><a href="#cb619-17" aria-hidden="true" tabindex="-1"></a> <span class="fu">\else</span></span>
+<span id="cb619-18"><a href="#cb619-18" aria-hidden="true" tabindex="-1"></a> , and the third</span>
+<span id="cb619-19"><a href="#cb619-19" aria-hidden="true" tabindex="-1"></a> <span class="fu">\fi</span></span>
+<span id="cb619-20"><a href="#cb619-20" aria-hidden="true" tabindex="-1"></a> <span class="fu">\fi</span></span>
+<span id="cb619-21"><a href="#cb619-21" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb619-22"><a href="#cb619-22" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererOlItemEnd</span>{}</span>
+<span id="cb619-23"><a href="#cb619-23" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererOlEndTight</span>{).}</span>
+<span id="cb619-24"><a href="#cb619-24" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb619-25"><a href="#cb619-25" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb619-26"><a href="#cb619-26" aria-hidden="true" tabindex="-1"></a>This is a tight list</span>
+<span id="cb619-27"><a href="#cb619-27" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb619-28"><a href="#cb619-28" aria-hidden="true" tabindex="-1"></a>1. item</span>
+<span id="cb619-29"><a href="#cb619-29" aria-hidden="true" tabindex="-1"></a>2. item</span>
+<span id="cb619-30"><a href="#cb619-30" aria-hidden="true" tabindex="-1"></a>3. item</span>
+<span id="cb619-31"><a href="#cb619-31" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb619-32"><a href="#cb619-32" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb619-33"><a href="#cb619-33" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="co">%</span></span>
+<span id="cb619-34"><a href="#cb619-34" aria-hidden="true" tabindex="-1"></a> :<span class="fu">\par</span></span>
+<span id="cb619-35"><a href="#cb619-35" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\markdownRendererInterblockSeparator</span>{<span class="fu">\par</span>}<span class="co">%</span></span>
+<span id="cb619-36"><a href="#cb619-36" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb619-37"><a href="#cb619-37" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererOlBegin</span>{<span class="fu">\startitemize</span>}</span>
+<span id="cb619-38"><a href="#cb619-38" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererOlItemWithNumber</span>#1{<span class="co">%</span></span>
+<span id="cb619-39"><a href="#cb619-39" aria-hidden="true" tabindex="-1"></a> <span class="fu">\sym</span>{#1.}</span>
+<span id="cb619-40"><a href="#cb619-40" aria-hidden="true" tabindex="-1"></a> This is the</span>
+<span id="cb619-41"><a href="#cb619-41" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifnum</span> #1=1<span class="fu">\relax</span></span>
+<span id="cb619-42"><a href="#cb619-42" aria-hidden="true" tabindex="-1"></a> first</span>
+<span id="cb619-43"><a href="#cb619-43" aria-hidden="true" tabindex="-1"></a> <span class="fu">\else</span></span>
+<span id="cb619-44"><a href="#cb619-44" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifnum</span> #1=2<span class="fu">\relax</span></span>
+<span id="cb619-45"><a href="#cb619-45" aria-hidden="true" tabindex="-1"></a> second</span>
+<span id="cb619-46"><a href="#cb619-46" aria-hidden="true" tabindex="-1"></a> <span class="fu">\else</span></span>
+<span id="cb619-47"><a href="#cb619-47" aria-hidden="true" tabindex="-1"></a> third</span>
+<span id="cb619-48"><a href="#cb619-48" aria-hidden="true" tabindex="-1"></a> <span class="fu">\fi</span></span>
+<span id="cb619-49"><a href="#cb619-49" aria-hidden="true" tabindex="-1"></a> <span class="fu">\fi</span></span>
+<span id="cb619-50"><a href="#cb619-50" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb619-51"><a href="#cb619-51" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererOlItemEnd</span>{.<span class="fu">\par</span>}</span>
+<span id="cb619-52"><a href="#cb619-52" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererOlEnd</span>{<span class="fu">\stopitemize</span>}</span>
+<span id="cb619-53"><a href="#cb619-53" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb619-54"><a href="#cb619-54" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb619-55"><a href="#cb619-55" aria-hidden="true" tabindex="-1"></a>This is a loose list</span>
+<span id="cb619-56"><a href="#cb619-56" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb619-57"><a href="#cb619-57" aria-hidden="true" tabindex="-1"></a>1. item</span>
+<span id="cb619-58"><a href="#cb619-58" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb619-59"><a href="#cb619-59" aria-hidden="true" tabindex="-1"></a>2. item</span>
+<span id="cb619-60"><a href="#cb619-60" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb619-61"><a href="#cb619-61" aria-hidden="true" tabindex="-1"></a>3. item</span>
+<span id="cb619-62"><a href="#cb619-62" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb619-63"><a href="#cb619-63" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb619-64"><a href="#cb619-64" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb617"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb617-1"><a href="#cb617-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb620"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb620-1"><a href="#cb620-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -11579,57 +11672,57 @@ item).</p>
</blockquote>
<h4 data-number="2.3.1.31" id="raw-content-renderers"><span
class="header-section-number">2.3.1.31</span> Raw Content Renderers</h4>
-<p>The <code>\markdownRendererInputRawInline</code> macro represents an
+<p>The <code>markdownRendererInputRawInline</code> macro represents an
inline raw span. The macro receives two arguments: the filename of a
file containing the inline raw span contents and the raw attribute that
designates the format of the inline raw span. This macro will only be
-produced, when the <strong><code>rawAttribute</code></strong> option is
+produced, when the <code><strong>rawAttribute</strong></code> option is
enabled.</p>
-<p>The <code>\markdownRendererInputRawBlock</code> macro represents a
-raw block. The macro receives two arguments: the filename of a file
+<p>The <code>markdownRendererInputRawBlock</code> macro represents a raw
+block. The macro receives two arguments: the filename of a file
containing the raw block and the raw attribute that designates the
format of the raw block. This macro will only be produced, when the
-<strong><code>rawAttribute</code></strong> and
-<strong><code>fencedCode</code></strong> options are enabled.</p>
+<code><strong>rawAttribute</strong></code> and
+<code><strong>fencedCode</strong></code> options are enabled.</p>
<h5 class="unnumbered" id="latex-example-89"><span
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb618"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb618-1"><a href="#cb618-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb618-2"><a href="#cb618-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[rawAttribute, fencedCode]{<span class="ex">markdown</span>}</span>
-<span id="cb618-3"><a href="#cb618-3" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">expl3</span>}</span>
-<span id="cb618-4"><a href="#cb618-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\ExplSyntaxOn</span></span>
-<span id="cb618-5"><a href="#cb618-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\cs</span>_new:Nn</span>
-<span id="cb618-6"><a href="#cb618-6" aria-hidden="true" tabindex="-1"></a> <span class="fu">\display</span>_raw_content:nn</span>
-<span id="cb618-7"><a href="#cb618-7" aria-hidden="true" tabindex="-1"></a> {</span>
-<span id="cb618-8"><a href="#cb618-8" aria-hidden="true" tabindex="-1"></a> <span class="co">% If the raw attribute is TeX, execute the content as a TeX document.</span></span>
-<span id="cb618-9"><a href="#cb618-9" aria-hidden="true" tabindex="-1"></a> <span class="fu">\str</span>_if_eq:nnTF</span>
-<span id="cb618-10"><a href="#cb618-10" aria-hidden="true" tabindex="-1"></a> { #2 }</span>
-<span id="cb618-11"><a href="#cb618-11" aria-hidden="true" tabindex="-1"></a> { tex }</span>
-<span id="cb618-12"><a href="#cb618-12" aria-hidden="true" tabindex="-1"></a> { <span class="fu">\markdownEscape</span> { #1 } }</span>
-<span id="cb618-13"><a href="#cb618-13" aria-hidden="true" tabindex="-1"></a> <span class="co">% Otherwise, ignore the content.</span></span>
-<span id="cb618-14"><a href="#cb618-14" aria-hidden="true" tabindex="-1"></a> { }</span>
-<span id="cb618-15"><a href="#cb618-15" aria-hidden="true" tabindex="-1"></a> }</span>
-<span id="cb618-16"><a href="#cb618-16" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb618-17"><a href="#cb618-17" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb618-18"><a href="#cb618-18" aria-hidden="true" tabindex="-1"></a> rawInline = { <span class="fu">\display</span>_raw_content:nn { #1 } { #2 } },</span>
-<span id="cb618-19"><a href="#cb618-19" aria-hidden="true" tabindex="-1"></a> rawBlock = { <span class="fu">\display</span>_raw_content:nn { #1 } { #2 } }</span>
-<span id="cb618-20"><a href="#cb618-20" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb618-21"><a href="#cb618-21" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb618-22"><a href="#cb618-22" aria-hidden="true" tabindex="-1"></a><span class="fu">\ExplSyntaxOff</span></span>
-<span id="cb618-23"><a href="#cb618-23" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb618-24"><a href="#cb618-24" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb618-25"><a href="#cb618-25" aria-hidden="true" tabindex="-1"></a>`<span class="ss">$H_2 O$</span>`{=tex} is a liquid.</span>
-<span id="cb618-26"><a href="#cb618-26" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb618-27"><a href="#cb618-27" aria-hidden="true" tabindex="-1"></a>``` {=html}</span>
-<span id="cb618-28"><a href="#cb618-28" aria-hidden="true" tabindex="-1"></a>&lt;p&gt;Here is some HTML content that will be ignored.&lt;/p&gt;</span>
-<span id="cb618-29"><a href="#cb618-29" aria-hidden="true" tabindex="-1"></a>```</span>
-<span id="cb618-30"><a href="#cb618-30" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb618-31"><a href="#cb618-31" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb621"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb621-1"><a href="#cb621-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb621-2"><a href="#cb621-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[rawAttribute, fencedCode]{<span class="ex">markdown</span>}</span>
+<span id="cb621-3"><a href="#cb621-3" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">expl3</span>}</span>
+<span id="cb621-4"><a href="#cb621-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\ExplSyntaxOn</span></span>
+<span id="cb621-5"><a href="#cb621-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\cs</span>_new:Nn</span>
+<span id="cb621-6"><a href="#cb621-6" aria-hidden="true" tabindex="-1"></a> <span class="fu">\display</span>_raw_content:nn</span>
+<span id="cb621-7"><a href="#cb621-7" aria-hidden="true" tabindex="-1"></a> {</span>
+<span id="cb621-8"><a href="#cb621-8" aria-hidden="true" tabindex="-1"></a> <span class="co">% If the raw attribute is TeX, execute the content as a TeX document.</span></span>
+<span id="cb621-9"><a href="#cb621-9" aria-hidden="true" tabindex="-1"></a> <span class="fu">\str</span>_if_eq:nnTF</span>
+<span id="cb621-10"><a href="#cb621-10" aria-hidden="true" tabindex="-1"></a> { #2 }</span>
+<span id="cb621-11"><a href="#cb621-11" aria-hidden="true" tabindex="-1"></a> { tex }</span>
+<span id="cb621-12"><a href="#cb621-12" aria-hidden="true" tabindex="-1"></a> { <span class="fu">\markdownEscape</span> { #1 } }</span>
+<span id="cb621-13"><a href="#cb621-13" aria-hidden="true" tabindex="-1"></a> <span class="co">% Otherwise, ignore the content.</span></span>
+<span id="cb621-14"><a href="#cb621-14" aria-hidden="true" tabindex="-1"></a> { }</span>
+<span id="cb621-15"><a href="#cb621-15" aria-hidden="true" tabindex="-1"></a> }</span>
+<span id="cb621-16"><a href="#cb621-16" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb621-17"><a href="#cb621-17" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb621-18"><a href="#cb621-18" aria-hidden="true" tabindex="-1"></a> rawInline = { <span class="fu">\display</span>_raw_content:nn { #1 } { #2 } },</span>
+<span id="cb621-19"><a href="#cb621-19" aria-hidden="true" tabindex="-1"></a> rawBlock = { <span class="fu">\display</span>_raw_content:nn { #1 } { #2 } }</span>
+<span id="cb621-20"><a href="#cb621-20" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb621-21"><a href="#cb621-21" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb621-22"><a href="#cb621-22" aria-hidden="true" tabindex="-1"></a><span class="fu">\ExplSyntaxOff</span></span>
+<span id="cb621-23"><a href="#cb621-23" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb621-24"><a href="#cb621-24" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb621-25"><a href="#cb621-25" aria-hidden="true" tabindex="-1"></a>`<span class="ss">$H_2 O$</span>`{=tex} is a liquid.</span>
+<span id="cb621-26"><a href="#cb621-26" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb621-27"><a href="#cb621-27" aria-hidden="true" tabindex="-1"></a>``` {=html}</span>
+<span id="cb621-28"><a href="#cb621-28" aria-hidden="true" tabindex="-1"></a>&lt;p&gt;Here is some HTML content that will be ignored.&lt;/p&gt;</span>
+<span id="cb621-29"><a href="#cb621-29" aria-hidden="true" tabindex="-1"></a>```</span>
+<span id="cb621-30"><a href="#cb621-30" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb621-31"><a href="#cb621-31" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb619"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb619-1"><a href="#cb619-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb622"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb622-1"><a href="#cb622-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -11637,13 +11730,13 @@ contain the following text:</p>
</blockquote>
<h4 data-number="2.3.1.32" id="section-renderers"><span
class="header-section-number">2.3.1.32</span> Section Renderers</h4>
-<p>The <code>\markdownRendererSectionBegin</code> and
-<code>\markdownRendererSectionEnd</code> macros represent the beginning
+<p>The <code>markdownRendererSectionBegin</code> and
+<code>markdownRendererSectionEnd</code> macros represent the beginning
and the end of a section based on headings.</p>
<h4 data-number="2.3.1.33" id="replacement-character-renderers"><span
class="header-section-number">2.3.1.33</span> Replacement Character
Renderers</h4>
-<p>The <code>\markdownRendererReplacementCharacter</code> macro
+<p>The <code>markdownRendererReplacementCharacter</code> macro
represents the U+0000 and U+FFFD Unicode characters. The macro receives
no arguments.</p>
<h4 data-number="2.3.1.34" id="special-character-renderers"><span
@@ -11654,27 +11747,27 @@ class="tex">T<sub>e</sub>X</span> characters, including the active pipe
character (<code>|</code>) of Con<span
class="tex">T<sub>e</sub>X</span>t, in the input text:</p>
<ul>
-<li><code>\markdownRendererAmpersand</code> replaces the ampersand
+<li><code>markdownRendererAmpersand</code> replaces the ampersand
(<code>&amp;</code>).</li>
-<li><code>\markdownRendererBackslash</code> replaces the backslash
+<li><code>markdownRendererBackslash</code> replaces the backslash
(<code>\</code>).</li>
-<li><code>\markdownRendererCircumflex</code> replaces the circumflex
+<li><code>markdownRendererCircumflex</code> replaces the circumflex
(<code>^</code>).</li>
-<li><code>\markdownRendererDollarSign</code> replaces the dollar sign
+<li><code>markdownRendererDollarSign</code> replaces the dollar sign
(<code>$</code>).</li>
-<li><code>\markdownRendererHash</code> replaces the hash sign
+<li><code>markdownRendererHash</code> replaces the hash sign
(<code>#</code>).</li>
-<li><code>\markdownRendererLeftBrace</code> replaces the left brace
+<li><code>markdownRendererLeftBrace</code> replaces the left brace
(<code>{</code>).</li>
-<li><code>\markdownRendererPercentSign</code> replaces the percent sign
+<li><code>markdownRendererPercentSign</code> replaces the percent sign
(<code>%</code>).</li>
-<li><code>\markdownRendererPipe</code> replaces the pipe character
+<li><code>markdownRendererPipe</code> replaces the pipe character
(<code>|</code>).</li>
-<li><code>\markdownRendererRightBrace</code> replaces the right brace
+<li><code>markdownRendererRightBrace</code> replaces the right brace
(<code>}</code>).</li>
-<li><code>\markdownRendererTilde</code> replaces the tilde
+<li><code>markdownRendererTilde</code> replaces the tilde
(<code>~</code>).</li>
-<li><code>\markdownRendererUnderscore</code> replaces the underscore
+<li><code>markdownRendererUnderscore</code> replaces the underscore
(<code>_</code>).</li>
</ul>
<h5 class="unnumbered" id="plain-tex-example-40">Plain <span
@@ -11684,16 +11777,16 @@ class="tex">T<sub>e</sub>X</span> Example</h5>
tilde behave as if it were written in <span
class="tex">T<sub>e</sub>X</span>, where it represents a non-breaking
space.</p>
-<div class="sourceCode" id="cb620"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb620-1"><a href="#cb620-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
-<span id="cb620-2"><a href="#cb620-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererTilde</span>{~}</span>
-<span id="cb620-3"><a href="#cb620-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
-<span id="cb620-4"><a href="#cb620-4" aria-hidden="true" tabindex="-1"></a>Bartel~Leendert van~der~Waerden</span>
-<span id="cb620-5"><a href="#cb620-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
-<span id="cb620-6"><a href="#cb620-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb623"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb623-1"><a href="#cb623-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
+<span id="cb623-2"><a href="#cb623-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererTilde</span>{~}</span>
+<span id="cb623-3"><a href="#cb623-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
+<span id="cb623-4"><a href="#cb623-4" aria-hidden="true" tabindex="-1"></a>Bartel~Leendert van~der~Waerden</span>
+<span id="cb623-5"><a href="#cb623-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
+<span id="cb623-6"><a href="#cb623-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb621"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb621-1"><a href="#cb621-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb624"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb624-1"><a href="#cb624-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text, where the middot (<code>·</code>) denotes a
non-breaking space:</p>
@@ -11707,22 +11800,22 @@ class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
tilde behave as if it were written in <span
class="tex">T<sub>e</sub>X</span>, where it represents a non-breaking
space.</p>
-<div class="sourceCode" id="cb622"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb622-1"><a href="#cb622-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb622-2"><a href="#cb622-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span>
-<span id="cb622-3"><a href="#cb622-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb622-4"><a href="#cb622-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb622-5"><a href="#cb622-5" aria-hidden="true" tabindex="-1"></a> tilde = ~,</span>
-<span id="cb622-6"><a href="#cb622-6" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb622-7"><a href="#cb622-7" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb622-8"><a href="#cb622-8" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb622-9"><a href="#cb622-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb622-10"><a href="#cb622-10" aria-hidden="true" tabindex="-1"></a>Bartel~Leendert van~der~Waerden</span>
-<span id="cb622-11"><a href="#cb622-11" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb622-12"><a href="#cb622-12" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb625"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb625-1"><a href="#cb625-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb625-2"><a href="#cb625-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span>
+<span id="cb625-3"><a href="#cb625-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb625-4"><a href="#cb625-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb625-5"><a href="#cb625-5" aria-hidden="true" tabindex="-1"></a> tilde = ~,</span>
+<span id="cb625-6"><a href="#cb625-6" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb625-7"><a href="#cb625-7" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb625-8"><a href="#cb625-8" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb625-9"><a href="#cb625-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb625-10"><a href="#cb625-10" aria-hidden="true" tabindex="-1"></a>Bartel~Leendert van~der~Waerden</span>
+<span id="cb625-11"><a href="#cb625-11" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb625-12"><a href="#cb625-12" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb623"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb623-1"><a href="#cb623-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb626"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb626-1"><a href="#cb626-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text, where the middot (<code>·</code>) denotes a
non-breaking space:</p>
@@ -11736,17 +11829,17 @@ class="tex">T<sub>e</sub>X</span>t Example</h5>
tilde behave as if it were written in <span
class="tex">T<sub>e</sub>X</span>, where it represents a non-breaking
space.</p>
-<div class="sourceCode" id="cb624"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb624-1"><a href="#cb624-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
-<span id="cb624-2"><a href="#cb624-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererTilde</span>{~}</span>
-<span id="cb624-3"><a href="#cb624-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
-<span id="cb624-4"><a href="#cb624-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb624-5"><a href="#cb624-5" aria-hidden="true" tabindex="-1"></a>Bartel~Leendert van~der~Waerden</span>
-<span id="cb624-6"><a href="#cb624-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb624-7"><a href="#cb624-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
+<div class="sourceCode" id="cb627"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb627-1"><a href="#cb627-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
+<span id="cb627-2"><a href="#cb627-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererTilde</span>{~}</span>
+<span id="cb627-3"><a href="#cb627-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
+<span id="cb627-4"><a href="#cb627-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb627-5"><a href="#cb627-5" aria-hidden="true" tabindex="-1"></a>Bartel~Leendert van~der~Waerden</span>
+<span id="cb627-6"><a href="#cb627-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb627-7"><a href="#cb627-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb625"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb625-1"><a href="#cb625-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb628"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb628-1"><a href="#cb628-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text, where the middot (<code>·</code>) denotes a
non-breaking space:</p>
@@ -11756,27 +11849,27 @@ non-breaking space:</p>
<h4 data-number="2.3.1.35" id="strike-through-renderer"><span
class="header-section-number">2.3.1.35</span> Strike-Through
Renderer</h4>
-<p>The <code>\markdownRendererStrikeThrough</code> macro represents a
+<p>The <code>markdownRendererStrikeThrough</code> macro represents a
strike-through span of text. The macro receives a single argument that
corresponds to the striked-out span of text. This macro will only be
-produced, when the <strong><code>strikeThrough</code></strong> option is
+produced, when the <code><strong>strikeThrough</strong></code> option is
enabled.</p>
<h5 class="unnumbered" id="plain-tex-example-41">Plain <span
class="tex">T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb626"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb626-1"><a href="#cb626-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
-<span id="cb626-2"><a href="#cb626-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionStrikeThrough</span>{true}</span>
-<span id="cb626-3"><a href="#cb626-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> soulutf8.sty</span>
-<span id="cb626-4"><a href="#cb626-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererStrikeThrough</span>#1{<span class="fu">\st</span>{#1}}</span>
-<span id="cb626-5"><a href="#cb626-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
-<span id="cb626-6"><a href="#cb626-6" aria-hidden="true" tabindex="-1"></a>This is ~~a lunar roving vehicle~~ strike-through text.</span>
-<span id="cb626-7"><a href="#cb626-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
-<span id="cb626-8"><a href="#cb626-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb629"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb629-1"><a href="#cb629-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
+<span id="cb629-2"><a href="#cb629-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionStrikeThrough</span>{true}</span>
+<span id="cb629-3"><a href="#cb629-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> soulutf8.sty</span>
+<span id="cb629-4"><a href="#cb629-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererStrikeThrough</span>#1{<span class="fu">\st</span>{#1}}</span>
+<span id="cb629-5"><a href="#cb629-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
+<span id="cb629-6"><a href="#cb629-6" aria-hidden="true" tabindex="-1"></a>This is ~~a lunar roving vehicle~~ strike-through text.</span>
+<span id="cb629-7"><a href="#cb629-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
+<span id="cb629-8"><a href="#cb629-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb627"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb627-1"><a href="#cb627-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb630"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb630-1"><a href="#cb630-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -11786,23 +11879,23 @@ contain the following text:</p>
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb628"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb628-1"><a href="#cb628-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb628-2"><a href="#cb628-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[strikeThrough]{<span class="ex">markdown</span>}</span>
-<span id="cb628-3"><a href="#cb628-3" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">soulutf8</span>}</span>
-<span id="cb628-4"><a href="#cb628-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb628-5"><a href="#cb628-5" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb628-6"><a href="#cb628-6" aria-hidden="true" tabindex="-1"></a> strikeThrough = {<span class="fu">\st</span>{#1}},</span>
-<span id="cb628-7"><a href="#cb628-7" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb628-8"><a href="#cb628-8" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb628-9"><a href="#cb628-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb628-10"><a href="#cb628-10" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb628-11"><a href="#cb628-11" aria-hidden="true" tabindex="-1"></a>This is ~~a lunar roving vehicle~~ strike-through text.</span>
-<span id="cb628-12"><a href="#cb628-12" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb628-13"><a href="#cb628-13" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb631"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb631-1"><a href="#cb631-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb631-2"><a href="#cb631-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[strikeThrough]{<span class="ex">markdown</span>}</span>
+<span id="cb631-3"><a href="#cb631-3" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">soulutf8</span>}</span>
+<span id="cb631-4"><a href="#cb631-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb631-5"><a href="#cb631-5" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb631-6"><a href="#cb631-6" aria-hidden="true" tabindex="-1"></a> strikeThrough = {<span class="fu">\st</span>{#1}},</span>
+<span id="cb631-7"><a href="#cb631-7" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb631-8"><a href="#cb631-8" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb631-9"><a href="#cb631-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb631-10"><a href="#cb631-10" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb631-11"><a href="#cb631-11" aria-hidden="true" tabindex="-1"></a>This is ~~a lunar roving vehicle~~ strike-through text.</span>
+<span id="cb631-12"><a href="#cb631-12" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb631-13"><a href="#cb631-13" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb629"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb629-1"><a href="#cb629-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb632"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb632-1"><a href="#cb632-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -11812,18 +11905,18 @@ contain the following text:</p>
class="tex">T<sub>e</sub>X</span>t Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb630"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb630-1"><a href="#cb630-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
-<span id="cb630-2"><a href="#cb630-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[strikeThrough = yes]</span>
-<span id="cb630-3"><a href="#cb630-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererStrikeThrough</span>#1{<span class="fu">\overstrikes</span>{#1}}</span>
-<span id="cb630-4"><a href="#cb630-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
-<span id="cb630-5"><a href="#cb630-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb630-6"><a href="#cb630-6" aria-hidden="true" tabindex="-1"></a>This is ~~a lunar roving vehicle~~ strike-through text.</span>
-<span id="cb630-7"><a href="#cb630-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb630-8"><a href="#cb630-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
+<div class="sourceCode" id="cb633"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb633-1"><a href="#cb633-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
+<span id="cb633-2"><a href="#cb633-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[strikeThrough = yes]</span>
+<span id="cb633-3"><a href="#cb633-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererStrikeThrough</span>#1{<span class="fu">\overstrikes</span>{#1}}</span>
+<span id="cb633-4"><a href="#cb633-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
+<span id="cb633-5"><a href="#cb633-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb633-6"><a href="#cb633-6" aria-hidden="true" tabindex="-1"></a>This is ~~a lunar roving vehicle~~ strike-through text.</span>
+<span id="cb633-7"><a href="#cb633-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb633-8"><a href="#cb633-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb631"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb631-1"><a href="#cb631-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb634"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb634-1"><a href="#cb634-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -11831,26 +11924,26 @@ contain the following text:</p>
</blockquote>
<h4 data-number="2.3.1.36" id="subscript-renderer"><span
class="header-section-number">2.3.1.36</span> Subscript Renderer</h4>
-<p>The <code>\markdownRendererSubscript</code> macro represents a
+<p>The <code>markdownRendererSubscript</code> macro represents a
subscript span of text. The macro receives a single argument that
corresponds to the subscript span of text. This macro will only be
-produced, when the <strong><code>subscripts</code></strong> option is
+produced, when the <code><strong>subscripts</strong></code> option is
enabled.</p>
<h5 class="unnumbered" id="plain-tex-example-42">Plain <span
class="tex">T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb632"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb632-1"><a href="#cb632-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
-<span id="cb632-2"><a href="#cb632-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionSubscripts</span>{true}</span>
-<span id="cb632-3"><a href="#cb632-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererSubscript</span>#1{ (#1 moles) and }</span>
-<span id="cb632-4"><a href="#cb632-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
-<span id="cb632-5"><a href="#cb632-5" aria-hidden="true" tabindex="-1"></a>H~2~O is a liquid.</span>
-<span id="cb632-6"><a href="#cb632-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
-<span id="cb632-7"><a href="#cb632-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb635"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb635-1"><a href="#cb635-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
+<span id="cb635-2"><a href="#cb635-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionSubscripts</span>{true}</span>
+<span id="cb635-3"><a href="#cb635-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererSubscript</span>#1{ (#1 moles) and }</span>
+<span id="cb635-4"><a href="#cb635-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
+<span id="cb635-5"><a href="#cb635-5" aria-hidden="true" tabindex="-1"></a>H~2~O is a liquid.</span>
+<span id="cb635-6"><a href="#cb635-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
+<span id="cb635-7"><a href="#cb635-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb633"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb633-1"><a href="#cb633-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb636"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb636-1"><a href="#cb636-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -11860,22 +11953,22 @@ contain the following text:</p>
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb634"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb634-1"><a href="#cb634-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb634-2"><a href="#cb634-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[subscripts]{<span class="ex">markdown</span>}</span>
-<span id="cb634-3"><a href="#cb634-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb634-4"><a href="#cb634-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb634-5"><a href="#cb634-5" aria-hidden="true" tabindex="-1"></a> subscript = { (#1 moles) and },</span>
-<span id="cb634-6"><a href="#cb634-6" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb634-7"><a href="#cb634-7" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb634-8"><a href="#cb634-8" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb634-9"><a href="#cb634-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb634-10"><a href="#cb634-10" aria-hidden="true" tabindex="-1"></a>H~2~O is a liquid.</span>
-<span id="cb634-11"><a href="#cb634-11" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb634-12"><a href="#cb634-12" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb637"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb637-1"><a href="#cb637-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb637-2"><a href="#cb637-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[subscripts]{<span class="ex">markdown</span>}</span>
+<span id="cb637-3"><a href="#cb637-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb637-4"><a href="#cb637-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb637-5"><a href="#cb637-5" aria-hidden="true" tabindex="-1"></a> subscript = { (#1 moles) and },</span>
+<span id="cb637-6"><a href="#cb637-6" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb637-7"><a href="#cb637-7" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb637-8"><a href="#cb637-8" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb637-9"><a href="#cb637-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb637-10"><a href="#cb637-10" aria-hidden="true" tabindex="-1"></a>H~2~O is a liquid.</span>
+<span id="cb637-11"><a href="#cb637-11" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb637-12"><a href="#cb637-12" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb635"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb635-1"><a href="#cb635-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb638"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb638-1"><a href="#cb638-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -11885,18 +11978,18 @@ contain the following text:</p>
class="tex">T<sub>e</sub>X</span>t Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb636"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb636-1"><a href="#cb636-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
-<span id="cb636-2"><a href="#cb636-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[subscripts = yes]</span>
-<span id="cb636-3"><a href="#cb636-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererSubscript</span>#1{ (#1 moles) and }</span>
-<span id="cb636-4"><a href="#cb636-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
-<span id="cb636-5"><a href="#cb636-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb636-6"><a href="#cb636-6" aria-hidden="true" tabindex="-1"></a>H~2~O is a liquid.</span>
-<span id="cb636-7"><a href="#cb636-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb636-8"><a href="#cb636-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
+<div class="sourceCode" id="cb639"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb639-1"><a href="#cb639-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
+<span id="cb639-2"><a href="#cb639-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[subscripts = yes]</span>
+<span id="cb639-3"><a href="#cb639-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererSubscript</span>#1{ (#1 moles) and }</span>
+<span id="cb639-4"><a href="#cb639-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
+<span id="cb639-5"><a href="#cb639-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb639-6"><a href="#cb639-6" aria-hidden="true" tabindex="-1"></a>H~2~O is a liquid.</span>
+<span id="cb639-7"><a href="#cb639-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb639-8"><a href="#cb639-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb637"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb637-1"><a href="#cb637-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb640"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb640-1"><a href="#cb640-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -11904,26 +11997,26 @@ contain the following text:</p>
</blockquote>
<h4 data-number="2.3.1.37" id="superscript-renderer"><span
class="header-section-number">2.3.1.37</span> Superscript Renderer</h4>
-<p>The <code>\markdownRendererSuperscript</code> macro represents a
+<p>The <code>markdownRendererSuperscript</code> macro represents a
superscript span of text. The macro receives a single argument that
corresponds to the superscript span of text. This macro will only be
-produced, when the <strong><code>superscripts</code></strong> option is
+produced, when the <code><strong>superscripts</strong></code> option is
enabled.</p>
<h5 class="unnumbered" id="plain-tex-example-43">Plain <span
class="tex">T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb638"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb638-1"><a href="#cb638-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
-<span id="cb638-2"><a href="#cb638-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionSuperscripts</span>{true}</span>
-<span id="cb638-3"><a href="#cb638-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererSuperscript</span>#1{ taken to the power of #1}</span>
-<span id="cb638-4"><a href="#cb638-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
-<span id="cb638-5"><a href="#cb638-5" aria-hidden="true" tabindex="-1"></a>2^10^ is 1024.</span>
-<span id="cb638-6"><a href="#cb638-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
-<span id="cb638-7"><a href="#cb638-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb641"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb641-1"><a href="#cb641-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
+<span id="cb641-2"><a href="#cb641-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionSuperscripts</span>{true}</span>
+<span id="cb641-3"><a href="#cb641-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererSuperscript</span>#1{ taken to the power of #1}</span>
+<span id="cb641-4"><a href="#cb641-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
+<span id="cb641-5"><a href="#cb641-5" aria-hidden="true" tabindex="-1"></a>2^10^ is 1024.</span>
+<span id="cb641-6"><a href="#cb641-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
+<span id="cb641-7"><a href="#cb641-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb639"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb639-1"><a href="#cb639-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb642"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb642-1"><a href="#cb642-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -11933,22 +12026,22 @@ contain the following text:</p>
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb640"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb640-1"><a href="#cb640-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb640-2"><a href="#cb640-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[superscripts]{<span class="ex">markdown</span>}</span>
-<span id="cb640-3"><a href="#cb640-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb640-4"><a href="#cb640-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb640-5"><a href="#cb640-5" aria-hidden="true" tabindex="-1"></a> superscript = { taken to the power of #1},</span>
-<span id="cb640-6"><a href="#cb640-6" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb640-7"><a href="#cb640-7" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb640-8"><a href="#cb640-8" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb640-9"><a href="#cb640-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb640-10"><a href="#cb640-10" aria-hidden="true" tabindex="-1"></a>2^10^ is 1024.</span>
-<span id="cb640-11"><a href="#cb640-11" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb640-12"><a href="#cb640-12" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb643"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb643-1"><a href="#cb643-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb643-2"><a href="#cb643-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[superscripts]{<span class="ex">markdown</span>}</span>
+<span id="cb643-3"><a href="#cb643-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb643-4"><a href="#cb643-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb643-5"><a href="#cb643-5" aria-hidden="true" tabindex="-1"></a> superscript = { taken to the power of #1},</span>
+<span id="cb643-6"><a href="#cb643-6" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb643-7"><a href="#cb643-7" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb643-8"><a href="#cb643-8" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb643-9"><a href="#cb643-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb643-10"><a href="#cb643-10" aria-hidden="true" tabindex="-1"></a>2^10^ is 1024.</span>
+<span id="cb643-11"><a href="#cb643-11" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb643-12"><a href="#cb643-12" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb641"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb641-1"><a href="#cb641-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb644"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb644-1"><a href="#cb644-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -11958,18 +12051,18 @@ contain the following text:</p>
class="tex">T<sub>e</sub>X</span>t Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb642"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb642-1"><a href="#cb642-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
-<span id="cb642-2"><a href="#cb642-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[superscripts = yes]</span>
-<span id="cb642-3"><a href="#cb642-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererSuperscript</span>#1{ taken to the power of #1}</span>
-<span id="cb642-4"><a href="#cb642-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
-<span id="cb642-5"><a href="#cb642-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb642-6"><a href="#cb642-6" aria-hidden="true" tabindex="-1"></a>2^10^ is 1024.</span>
-<span id="cb642-7"><a href="#cb642-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb642-8"><a href="#cb642-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
+<div class="sourceCode" id="cb645"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb645-1"><a href="#cb645-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
+<span id="cb645-2"><a href="#cb645-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[superscripts = yes]</span>
+<span id="cb645-3"><a href="#cb645-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererSuperscript</span>#1{ taken to the power of #1}</span>
+<span id="cb645-4"><a href="#cb645-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
+<span id="cb645-5"><a href="#cb645-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb645-6"><a href="#cb645-6" aria-hidden="true" tabindex="-1"></a>2^10^ is 1024.</span>
+<span id="cb645-7"><a href="#cb645-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb645-8"><a href="#cb645-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb643"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb643-1"><a href="#cb643-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb646"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb646-1"><a href="#cb646-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -11979,67 +12072,67 @@ contain the following text:</p>
class="header-section-number">2.3.1.38</span> Table Attribute Context
Renderers</h4>
<p>The following macros are only produced, when the
-<strong><code>tableCaptions</code></strong> and
-<strong><code>tableAttributes</code></strong> options are enabled.</p>
-<p>The <code>\markdownRendererTableAttributeContextBegin</code> and
-<code>\markdownRendererTableAttributeContextEnd</code> macros represent
+<code><strong>tableCaptions</strong></code> and
+<code><strong>tableAttributes</strong></code> options are enabled.</p>
+<p>The <code>markdownRendererTableAttributeContextBegin</code> and
+<code>markdownRendererTableAttributeContextEnd</code> macros represent
the beginning and the end of a context in which the attributes of a
table apply. The macros receive no arguments.</p>
<h5 class="unnumbered" id="latex-example-94"><span
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb644"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb644-1"><a href="#cb644-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb644-2"><a href="#cb644-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[</span>
-<span id="cb644-3"><a href="#cb644-3" aria-hidden="true" tabindex="-1"></a> pipeTables,</span>
-<span id="cb644-4"><a href="#cb644-4" aria-hidden="true" tabindex="-1"></a> tableCaptions,</span>
-<span id="cb644-5"><a href="#cb644-5" aria-hidden="true" tabindex="-1"></a> tableAttributes,</span>
-<span id="cb644-6"><a href="#cb644-6" aria-hidden="true" tabindex="-1"></a> relativeReferences,</span>
-<span id="cb644-7"><a href="#cb644-7" aria-hidden="true" tabindex="-1"></a>]{<span class="ex">markdown</span>}</span>
-<span id="cb644-8"><a href="#cb644-8" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">expl3</span>}</span>
-<span id="cb644-9"><a href="#cb644-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\ExplSyntaxOn</span></span>
-<span id="cb644-10"><a href="#cb644-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb644-11"><a href="#cb644-11" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb644-12"><a href="#cb644-12" aria-hidden="true" tabindex="-1"></a> tableAttributeContextBegin = {</span>
-<span id="cb644-13"><a href="#cb644-13" aria-hidden="true" tabindex="-1"></a> <span class="fu">\group</span>_begin:</span>
-<span id="cb644-14"><a href="#cb644-14" aria-hidden="true" tabindex="-1"></a> <span class="fu">\markdownSetup</span>{</span>
-<span id="cb644-15"><a href="#cb644-15" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb644-16"><a href="#cb644-16" aria-hidden="true" tabindex="-1"></a> attributeIdentifier = {</span>
-<span id="cb644-17"><a href="#cb644-17" aria-hidden="true" tabindex="-1"></a> <span class="fu">\markdownSetup</span>{</span>
-<span id="cb644-18"><a href="#cb644-18" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb644-19"><a href="#cb644-19" aria-hidden="true" tabindex="-1"></a> tableAttributeContextEnd = {</span>
-<span id="cb644-20"><a href="#cb644-20" aria-hidden="true" tabindex="-1"></a> <span class="kw">\label</span>{<span class="ex">##1</span>}</span>
-<span id="cb644-21"><a href="#cb644-21" aria-hidden="true" tabindex="-1"></a> <span class="fu">\group</span>_end:</span>
-<span id="cb644-22"><a href="#cb644-22" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb644-23"><a href="#cb644-23" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb644-24"><a href="#cb644-24" aria-hidden="true" tabindex="-1"></a> }</span>
-<span id="cb644-25"><a href="#cb644-25" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb644-26"><a href="#cb644-26" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb644-27"><a href="#cb644-27" aria-hidden="true" tabindex="-1"></a> }</span>
-<span id="cb644-28"><a href="#cb644-28" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb644-29"><a href="#cb644-29" aria-hidden="true" tabindex="-1"></a> tableAttributeContextEnd = {</span>
-<span id="cb644-30"><a href="#cb644-30" aria-hidden="true" tabindex="-1"></a> <span class="fu">\group</span>_end:</span>
-<span id="cb644-31"><a href="#cb644-31" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb644-32"><a href="#cb644-32" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb644-33"><a href="#cb644-33" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb644-34"><a href="#cb644-34" aria-hidden="true" tabindex="-1"></a><span class="fu">\ExplSyntaxOff</span></span>
-<span id="cb644-35"><a href="#cb644-35" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb644-36"><a href="#cb644-36" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb644-37"><a href="#cb644-37" aria-hidden="true" tabindex="-1"></a>See Table &lt;#example-table&gt;.</span>
-<span id="cb644-38"><a href="#cb644-38" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb644-39"><a href="#cb644-39" aria-hidden="true" tabindex="-1"></a>| Right | Left | Default | Center |</span>
-<span id="cb644-40"><a href="#cb644-40" aria-hidden="true" tabindex="-1"></a>|------:|:-----|---------|:------:|</span>
-<span id="cb644-41"><a href="#cb644-41" aria-hidden="true" tabindex="-1"></a>| 12 | 12 | 12 | 12 |</span>
-<span id="cb644-42"><a href="#cb644-42" aria-hidden="true" tabindex="-1"></a>| 123 | 123 | 123 | 123 |</span>
-<span id="cb644-43"><a href="#cb644-43" aria-hidden="true" tabindex="-1"></a>| 1 | 1 | 1 | 1 |</span>
-<span id="cb644-44"><a href="#cb644-44" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb644-45"><a href="#cb644-45" aria-hidden="true" tabindex="-1"></a> : Demonstration of pipe table syntax. {#example-table}</span>
-<span id="cb644-46"><a href="#cb644-46" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb644-47"><a href="#cb644-47" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb647"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb647-1"><a href="#cb647-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb647-2"><a href="#cb647-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[</span>
+<span id="cb647-3"><a href="#cb647-3" aria-hidden="true" tabindex="-1"></a> pipeTables,</span>
+<span id="cb647-4"><a href="#cb647-4" aria-hidden="true" tabindex="-1"></a> tableCaptions,</span>
+<span id="cb647-5"><a href="#cb647-5" aria-hidden="true" tabindex="-1"></a> tableAttributes,</span>
+<span id="cb647-6"><a href="#cb647-6" aria-hidden="true" tabindex="-1"></a> relativeReferences,</span>
+<span id="cb647-7"><a href="#cb647-7" aria-hidden="true" tabindex="-1"></a>]{<span class="ex">markdown</span>}</span>
+<span id="cb647-8"><a href="#cb647-8" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">expl3</span>}</span>
+<span id="cb647-9"><a href="#cb647-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\ExplSyntaxOn</span></span>
+<span id="cb647-10"><a href="#cb647-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb647-11"><a href="#cb647-11" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb647-12"><a href="#cb647-12" aria-hidden="true" tabindex="-1"></a> tableAttributeContextBegin = {</span>
+<span id="cb647-13"><a href="#cb647-13" aria-hidden="true" tabindex="-1"></a> <span class="fu">\group</span>_begin:</span>
+<span id="cb647-14"><a href="#cb647-14" aria-hidden="true" tabindex="-1"></a> <span class="fu">\markdownSetup</span>{</span>
+<span id="cb647-15"><a href="#cb647-15" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb647-16"><a href="#cb647-16" aria-hidden="true" tabindex="-1"></a> attributeIdentifier = {</span>
+<span id="cb647-17"><a href="#cb647-17" aria-hidden="true" tabindex="-1"></a> <span class="fu">\markdownSetup</span>{</span>
+<span id="cb647-18"><a href="#cb647-18" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb647-19"><a href="#cb647-19" aria-hidden="true" tabindex="-1"></a> tableAttributeContextEnd = {</span>
+<span id="cb647-20"><a href="#cb647-20" aria-hidden="true" tabindex="-1"></a> <span class="kw">\label</span>{<span class="ex">##1</span>}</span>
+<span id="cb647-21"><a href="#cb647-21" aria-hidden="true" tabindex="-1"></a> <span class="fu">\group</span>_end:</span>
+<span id="cb647-22"><a href="#cb647-22" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb647-23"><a href="#cb647-23" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb647-24"><a href="#cb647-24" aria-hidden="true" tabindex="-1"></a> }</span>
+<span id="cb647-25"><a href="#cb647-25" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb647-26"><a href="#cb647-26" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb647-27"><a href="#cb647-27" aria-hidden="true" tabindex="-1"></a> }</span>
+<span id="cb647-28"><a href="#cb647-28" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb647-29"><a href="#cb647-29" aria-hidden="true" tabindex="-1"></a> tableAttributeContextEnd = {</span>
+<span id="cb647-30"><a href="#cb647-30" aria-hidden="true" tabindex="-1"></a> <span class="fu">\group</span>_end:</span>
+<span id="cb647-31"><a href="#cb647-31" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb647-32"><a href="#cb647-32" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb647-33"><a href="#cb647-33" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb647-34"><a href="#cb647-34" aria-hidden="true" tabindex="-1"></a><span class="fu">\ExplSyntaxOff</span></span>
+<span id="cb647-35"><a href="#cb647-35" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb647-36"><a href="#cb647-36" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb647-37"><a href="#cb647-37" aria-hidden="true" tabindex="-1"></a>See Table &lt;#example-table&gt;.</span>
+<span id="cb647-38"><a href="#cb647-38" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb647-39"><a href="#cb647-39" aria-hidden="true" tabindex="-1"></a>| Right | Left | Default | Center |</span>
+<span id="cb647-40"><a href="#cb647-40" aria-hidden="true" tabindex="-1"></a>|------:|:-----|---------|:------:|</span>
+<span id="cb647-41"><a href="#cb647-41" aria-hidden="true" tabindex="-1"></a>| 12 | 12 | 12 | 12 |</span>
+<span id="cb647-42"><a href="#cb647-42" aria-hidden="true" tabindex="-1"></a>| 123 | 123 | 123 | 123 |</span>
+<span id="cb647-43"><a href="#cb647-43" aria-hidden="true" tabindex="-1"></a>| 1 | 1 | 1 | 1 |</span>
+<span id="cb647-44"><a href="#cb647-44" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb647-45"><a href="#cb647-45" aria-hidden="true" tabindex="-1"></a> : Demonstration of pipe table syntax. {#example-table}</span>
+<span id="cb647-46"><a href="#cb647-46" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb647-47"><a href="#cb647-47" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb645"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb645-1"><a href="#cb645-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb648"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb648-1"><a href="#cb648-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -12078,9 +12171,9 @@ contain the following text:</p>
</blockquote>
<h4 data-number="2.3.1.39" id="table-renderer"><span
class="header-section-number">2.3.1.39</span> Table Renderer</h4>
-<p>The <code>\markdownRendererTable</code> macro represents a table.
-This macro will only be produced, when the
-<strong><code>pipeTables</code></strong> option is enabled. The macro
+<p>The <code>markdownRendererTable</code> macro represents a table. This
+macro will only be produced, when the
+<code><strong>pipeTables</strong></code> option is enabled. The macro
receives the parameters
<code>{</code>⟨<em>caption</em>⟩<code>}{</code>⟨<em>number of
rows</em>⟩<code>}{</code>⟨<em>number of columns</em>⟩<code>}</code>
@@ -12102,67 +12195,67 @@ one of the following:</p>
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb646"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb646-1"><a href="#cb646-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb646-2"><a href="#cb646-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[pipeTables, tableCaptions]{<span class="ex">markdown</span>}</span>
-<span id="cb646-3"><a href="#cb646-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\newcount\rowCounter</span></span>
-<span id="cb646-4"><a href="#cb646-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\newcount\columnCounter</span></span>
-<span id="cb646-5"><a href="#cb646-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\makeatletter</span></span>
-<span id="cb646-6"><a href="#cb646-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\processRow</span>#1{<span class="co">%</span></span>
-<span id="cb646-7"><a href="#cb646-7" aria-hidden="true" tabindex="-1"></a> <span class="fu">\columnCounter</span>=1<span class="co">%</span></span>
-<span id="cb646-8"><a href="#cb646-8" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifnum\rowCounter</span>=0<span class="fu">\relax</span></span>
-<span id="cb646-9"><a href="#cb646-9" aria-hidden="true" tabindex="-1"></a> As for the alignment,</span>
-<span id="cb646-10"><a href="#cb646-10" aria-hidden="true" tabindex="-1"></a> <span class="fu">\else</span></span>
-<span id="cb646-11"><a href="#cb646-11" aria-hidden="true" tabindex="-1"></a> In row <span class="fu">\the\rowCounter</span>,</span>
-<span id="cb646-12"><a href="#cb646-12" aria-hidden="true" tabindex="-1"></a> <span class="fu">\fi</span></span>
-<span id="cb646-13"><a href="#cb646-13" aria-hidden="true" tabindex="-1"></a> <span class="fu">\processColumn</span>#1</span>
-<span id="cb646-14"><a href="#cb646-14" aria-hidden="true" tabindex="-1"></a> <span class="fu">\advance\rowCounter</span> by 1<span class="fu">\relax</span></span>
-<span id="cb646-15"><a href="#cb646-15" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifnum\rowCounter</span>&gt;<span class="fu">\rowTotal\relax</span></span>
-<span id="cb646-16"><a href="#cb646-16" aria-hidden="true" tabindex="-1"></a> <span class="fu">\expandafter\@gobble</span></span>
-<span id="cb646-17"><a href="#cb646-17" aria-hidden="true" tabindex="-1"></a> <span class="fu">\fi\processRow</span>}<span class="co">%</span></span>
-<span id="cb646-18"><a href="#cb646-18" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\processColumn</span>#1{<span class="co">%</span></span>
-<span id="cb646-19"><a href="#cb646-19" aria-hidden="true" tabindex="-1"></a> column number <span class="fu">\the\columnCounter</span>{}</span>
-<span id="cb646-20"><a href="#cb646-20" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifnum\rowCounter</span>=0<span class="fu">\relax</span></span>
-<span id="cb646-21"><a href="#cb646-21" aria-hidden="true" tabindex="-1"></a> <span class="fu">\if</span>#1d{}has default alignment<span class="fu">\fi</span></span>
-<span id="cb646-22"><a href="#cb646-22" aria-hidden="true" tabindex="-1"></a> <span class="fu">\if</span>#1l{}is left-aligned<span class="fu">\fi</span></span>
-<span id="cb646-23"><a href="#cb646-23" aria-hidden="true" tabindex="-1"></a> <span class="fu">\if</span>#1c{}is centered<span class="fu">\fi</span></span>
-<span id="cb646-24"><a href="#cb646-24" aria-hidden="true" tabindex="-1"></a> <span class="fu">\if</span>#1r{}is right-aligned<span class="fu">\fi</span></span>
-<span id="cb646-25"><a href="#cb646-25" aria-hidden="true" tabindex="-1"></a> <span class="fu">\else</span></span>
-<span id="cb646-26"><a href="#cb646-26" aria-hidden="true" tabindex="-1"></a> says <span class="fu">\emph</span>{#1}<span class="co">%</span></span>
-<span id="cb646-27"><a href="#cb646-27" aria-hidden="true" tabindex="-1"></a> <span class="fu">\fi</span></span>
-<span id="cb646-28"><a href="#cb646-28" aria-hidden="true" tabindex="-1"></a> <span class="fu">\advance\columnCounter</span> by 1<span class="fu">\relax</span></span>
-<span id="cb646-29"><a href="#cb646-29" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifnum\columnCounter</span>&lt;<span class="fu">\columnTotal\relax</span>, <span class="fu">\fi</span></span>
-<span id="cb646-30"><a href="#cb646-30" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifnum\columnCounter</span>=<span class="fu">\columnTotal\relax</span>, and <span class="fu">\fi</span></span>
-<span id="cb646-31"><a href="#cb646-31" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifnum\columnCounter</span>&gt;<span class="fu">\columnTotal\relax</span></span>
-<span id="cb646-32"><a href="#cb646-32" aria-hidden="true" tabindex="-1"></a> .<span class="fu">\expandafter\@gobble</span></span>
-<span id="cb646-33"><a href="#cb646-33" aria-hidden="true" tabindex="-1"></a> <span class="fu">\fi\processColumn</span>}<span class="co">%</span></span>
-<span id="cb646-34"><a href="#cb646-34" aria-hidden="true" tabindex="-1"></a><span class="fu">\makeatother</span></span>
-<span id="cb646-35"><a href="#cb646-35" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb646-36"><a href="#cb646-36" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb646-37"><a href="#cb646-37" aria-hidden="true" tabindex="-1"></a> table = {<span class="co">%</span></span>
-<span id="cb646-38"><a href="#cb646-38" aria-hidden="true" tabindex="-1"></a> This is a table with caption <span class="fu">\emph</span>{#1} that is #3 columns wide</span>
-<span id="cb646-39"><a href="#cb646-39" aria-hidden="true" tabindex="-1"></a> and #2 rows long.</span>
-<span id="cb646-40"><a href="#cb646-40" aria-hidden="true" tabindex="-1"></a> <span class="fu">\rowCounter</span>=0<span class="co">%</span></span>
-<span id="cb646-41"><a href="#cb646-41" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\rowTotal</span>{#2}<span class="co">%</span></span>
-<span id="cb646-42"><a href="#cb646-42" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\columnTotal</span>{#3}<span class="co">%</span></span>
-<span id="cb646-43"><a href="#cb646-43" aria-hidden="true" tabindex="-1"></a> <span class="fu">\processRow</span></span>
-<span id="cb646-44"><a href="#cb646-44" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb646-45"><a href="#cb646-45" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb646-46"><a href="#cb646-46" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb646-47"><a href="#cb646-47" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb646-48"><a href="#cb646-48" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb646-49"><a href="#cb646-49" aria-hidden="true" tabindex="-1"></a>| Right | Left | Default | Center |</span>
-<span id="cb646-50"><a href="#cb646-50" aria-hidden="true" tabindex="-1"></a>|------:|:-----|---------|:------:|</span>
-<span id="cb646-51"><a href="#cb646-51" aria-hidden="true" tabindex="-1"></a>| 12 | 12 | 12 | 12 |</span>
-<span id="cb646-52"><a href="#cb646-52" aria-hidden="true" tabindex="-1"></a>| 123 | 123 | 123 | 123 |</span>
-<span id="cb646-53"><a href="#cb646-53" aria-hidden="true" tabindex="-1"></a>| 1 | 1 | 1 | 1 |</span>
-<span id="cb646-54"><a href="#cb646-54" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb646-55"><a href="#cb646-55" aria-hidden="true" tabindex="-1"></a> : Demonstration of pipe table syntax</span>
-<span id="cb646-56"><a href="#cb646-56" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb646-57"><a href="#cb646-57" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb649"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb649-1"><a href="#cb649-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb649-2"><a href="#cb649-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[pipeTables, tableCaptions]{<span class="ex">markdown</span>}</span>
+<span id="cb649-3"><a href="#cb649-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\newcount\rowCounter</span></span>
+<span id="cb649-4"><a href="#cb649-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\newcount\columnCounter</span></span>
+<span id="cb649-5"><a href="#cb649-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\makeatletter</span></span>
+<span id="cb649-6"><a href="#cb649-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\processRow</span>#1{<span class="co">%</span></span>
+<span id="cb649-7"><a href="#cb649-7" aria-hidden="true" tabindex="-1"></a> <span class="fu">\columnCounter</span>=1<span class="co">%</span></span>
+<span id="cb649-8"><a href="#cb649-8" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifnum\rowCounter</span>=0<span class="fu">\relax</span></span>
+<span id="cb649-9"><a href="#cb649-9" aria-hidden="true" tabindex="-1"></a> As for the alignment,</span>
+<span id="cb649-10"><a href="#cb649-10" aria-hidden="true" tabindex="-1"></a> <span class="fu">\else</span></span>
+<span id="cb649-11"><a href="#cb649-11" aria-hidden="true" tabindex="-1"></a> In row <span class="fu">\the\rowCounter</span>,</span>
+<span id="cb649-12"><a href="#cb649-12" aria-hidden="true" tabindex="-1"></a> <span class="fu">\fi</span></span>
+<span id="cb649-13"><a href="#cb649-13" aria-hidden="true" tabindex="-1"></a> <span class="fu">\processColumn</span>#1</span>
+<span id="cb649-14"><a href="#cb649-14" aria-hidden="true" tabindex="-1"></a> <span class="fu">\advance\rowCounter</span> by 1<span class="fu">\relax</span></span>
+<span id="cb649-15"><a href="#cb649-15" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifnum\rowCounter</span>&gt;<span class="fu">\rowTotal\relax</span></span>
+<span id="cb649-16"><a href="#cb649-16" aria-hidden="true" tabindex="-1"></a> <span class="fu">\expandafter\@gobble</span></span>
+<span id="cb649-17"><a href="#cb649-17" aria-hidden="true" tabindex="-1"></a> <span class="fu">\fi\processRow</span>}<span class="co">%</span></span>
+<span id="cb649-18"><a href="#cb649-18" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\processColumn</span>#1{<span class="co">%</span></span>
+<span id="cb649-19"><a href="#cb649-19" aria-hidden="true" tabindex="-1"></a> column number <span class="fu">\the\columnCounter</span>{}</span>
+<span id="cb649-20"><a href="#cb649-20" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifnum\rowCounter</span>=0<span class="fu">\relax</span></span>
+<span id="cb649-21"><a href="#cb649-21" aria-hidden="true" tabindex="-1"></a> <span class="fu">\if</span>#1d{}has default alignment<span class="fu">\fi</span></span>
+<span id="cb649-22"><a href="#cb649-22" aria-hidden="true" tabindex="-1"></a> <span class="fu">\if</span>#1l{}is left-aligned<span class="fu">\fi</span></span>
+<span id="cb649-23"><a href="#cb649-23" aria-hidden="true" tabindex="-1"></a> <span class="fu">\if</span>#1c{}is centered<span class="fu">\fi</span></span>
+<span id="cb649-24"><a href="#cb649-24" aria-hidden="true" tabindex="-1"></a> <span class="fu">\if</span>#1r{}is right-aligned<span class="fu">\fi</span></span>
+<span id="cb649-25"><a href="#cb649-25" aria-hidden="true" tabindex="-1"></a> <span class="fu">\else</span></span>
+<span id="cb649-26"><a href="#cb649-26" aria-hidden="true" tabindex="-1"></a> says <span class="fu">\emph</span>{#1}<span class="co">%</span></span>
+<span id="cb649-27"><a href="#cb649-27" aria-hidden="true" tabindex="-1"></a> <span class="fu">\fi</span></span>
+<span id="cb649-28"><a href="#cb649-28" aria-hidden="true" tabindex="-1"></a> <span class="fu">\advance\columnCounter</span> by 1<span class="fu">\relax</span></span>
+<span id="cb649-29"><a href="#cb649-29" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifnum\columnCounter</span>&lt;<span class="fu">\columnTotal\relax</span>, <span class="fu">\fi</span></span>
+<span id="cb649-30"><a href="#cb649-30" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifnum\columnCounter</span>=<span class="fu">\columnTotal\relax</span>, and <span class="fu">\fi</span></span>
+<span id="cb649-31"><a href="#cb649-31" aria-hidden="true" tabindex="-1"></a> <span class="fu">\ifnum\columnCounter</span>&gt;<span class="fu">\columnTotal\relax</span></span>
+<span id="cb649-32"><a href="#cb649-32" aria-hidden="true" tabindex="-1"></a> .<span class="fu">\expandafter\@gobble</span></span>
+<span id="cb649-33"><a href="#cb649-33" aria-hidden="true" tabindex="-1"></a> <span class="fu">\fi\processColumn</span>}<span class="co">%</span></span>
+<span id="cb649-34"><a href="#cb649-34" aria-hidden="true" tabindex="-1"></a><span class="fu">\makeatother</span></span>
+<span id="cb649-35"><a href="#cb649-35" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb649-36"><a href="#cb649-36" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb649-37"><a href="#cb649-37" aria-hidden="true" tabindex="-1"></a> table = {<span class="co">%</span></span>
+<span id="cb649-38"><a href="#cb649-38" aria-hidden="true" tabindex="-1"></a> This is a table with caption <span class="fu">\emph</span>{#1} that is #3 columns wide</span>
+<span id="cb649-39"><a href="#cb649-39" aria-hidden="true" tabindex="-1"></a> and #2 rows long.</span>
+<span id="cb649-40"><a href="#cb649-40" aria-hidden="true" tabindex="-1"></a> <span class="fu">\rowCounter</span>=0<span class="co">%</span></span>
+<span id="cb649-41"><a href="#cb649-41" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\rowTotal</span>{#2}<span class="co">%</span></span>
+<span id="cb649-42"><a href="#cb649-42" aria-hidden="true" tabindex="-1"></a> <span class="fu">\def\columnTotal</span>{#3}<span class="co">%</span></span>
+<span id="cb649-43"><a href="#cb649-43" aria-hidden="true" tabindex="-1"></a> <span class="fu">\processRow</span></span>
+<span id="cb649-44"><a href="#cb649-44" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb649-45"><a href="#cb649-45" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb649-46"><a href="#cb649-46" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb649-47"><a href="#cb649-47" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb649-48"><a href="#cb649-48" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb649-49"><a href="#cb649-49" aria-hidden="true" tabindex="-1"></a>| Right | Left | Default | Center |</span>
+<span id="cb649-50"><a href="#cb649-50" aria-hidden="true" tabindex="-1"></a>|------:|:-----|---------|:------:|</span>
+<span id="cb649-51"><a href="#cb649-51" aria-hidden="true" tabindex="-1"></a>| 12 | 12 | 12 | 12 |</span>
+<span id="cb649-52"><a href="#cb649-52" aria-hidden="true" tabindex="-1"></a>| 123 | 123 | 123 | 123 |</span>
+<span id="cb649-53"><a href="#cb649-53" aria-hidden="true" tabindex="-1"></a>| 1 | 1 | 1 | 1 |</span>
+<span id="cb649-54"><a href="#cb649-54" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb649-55"><a href="#cb649-55" aria-hidden="true" tabindex="-1"></a> : Demonstration of pipe table syntax</span>
+<span id="cb649-56"><a href="#cb649-56" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb649-57"><a href="#cb649-57" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb647"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb647-1"><a href="#cb647-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb650"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb650-1"><a href="#cb650-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -12184,33 +12277,33 @@ column number 3 says <em>1</em>, and column number 4 says
<h4 data-number="2.3.1.40" id="tex-math-renderers"><span
class="header-section-number">2.3.1.40</span> <span
class="tex">T<sub>e</sub>X</span> Math Renderers</h4>
-<p>The <code>\markdownRendererInlineMath</code> and
-<code>\markdownRendererDisplayMath</code> macros represent inline and
+<p>The <code>markdownRendererInlineMath</code> and
+<code>markdownRendererDisplayMath</code> macros represent inline and
display <span class="tex">T<sub>e</sub>X</span> math. Both macros
receive a single argument that corresponds to the <span
class="tex">T<sub>e</sub>X</span> math content. These macros will only
-be produced, when the <strong><code>texMathDollars</code></strong>,
-<strong><code>texMathSingleBackslash</code></strong>, or
-<strong><code>texMathDoubleBackslash</code></strong> option are
+be produced, when the <code><strong>texMathDollars</strong></code>,
+<code><strong>texMathSingleBackslash</strong></code>, or
+<code><strong>texMathDoubleBackslash</strong></code> option are
enabled.</p>
<h5 class="unnumbered" id="plain-tex-example-44">Plain <span
class="tex">T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb648"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb648-1"><a href="#cb648-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
-<span id="cb648-2"><a href="#cb648-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionTexMathDollars</span>{true}</span>
-<span id="cb648-3"><a href="#cb648-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererInlineMath</span>#1{<span class="ss">$#1</span><span class="sc">\dots</span><span class="ss">$</span>}</span>
-<span id="cb648-4"><a href="#cb648-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererDisplayMath</span>#1{<span class="ss">$$#1</span><span class="sc">\nonumber</span><span class="ss">$$</span>}</span>
-<span id="cb648-5"><a href="#cb648-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
-<span id="cb648-6"><a href="#cb648-6" aria-hidden="true" tabindex="-1"></a><span class="ss">$E=mc^2$</span></span>
-<span id="cb648-7"><a href="#cb648-7" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb648-8"><a href="#cb648-8" aria-hidden="true" tabindex="-1"></a><span class="ss">$$</span><span class="sc">\hat</span><span class="ss">{f} </span><span class="sc">\left</span><span class="ss"> ( </span><span class="sc">\xi</span><span class="ss"> </span><span class="sc">\right</span><span class="ss"> )= </span><span class="sc">\int</span><span class="ss">_{-</span><span class="sc">\infty</span><span class="ss">}^{</span><span class="sc">\infty</span><span class="ss">} f</span><span class="sc">\left</span><span class="ss"> ( x </span><span class="sc">\right</span><span class="ss"> ) e^{-i2</span><span class="sc">\pi</span><span class="ss"> </span><span class="sc">\xi</span><span class="ss"> x} dx$$</span></span>
-<span id="cb648-9"><a href="#cb648-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
-<span id="cb648-10"><a href="#cb648-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb651"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb651-1"><a href="#cb651-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
+<span id="cb651-2"><a href="#cb651-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionTexMathDollars</span>{true}</span>
+<span id="cb651-3"><a href="#cb651-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererInlineMath</span>#1{<span class="ss">$#1</span><span class="sc">\dots</span><span class="ss">$</span>}</span>
+<span id="cb651-4"><a href="#cb651-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererDisplayMath</span>#1{<span class="ss">$$#1</span><span class="sc">\nonumber</span><span class="ss">$$</span>}</span>
+<span id="cb651-5"><a href="#cb651-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
+<span id="cb651-6"><a href="#cb651-6" aria-hidden="true" tabindex="-1"></a><span class="ss">$E=mc^2$</span></span>
+<span id="cb651-7"><a href="#cb651-7" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb651-8"><a href="#cb651-8" aria-hidden="true" tabindex="-1"></a><span class="ss">$$</span><span class="sc">\hat</span><span class="ss">{f} </span><span class="sc">\left</span><span class="ss"> ( </span><span class="sc">\xi</span><span class="ss"> </span><span class="sc">\right</span><span class="ss"> )= </span><span class="sc">\int</span><span class="ss">_{-</span><span class="sc">\infty</span><span class="ss">}^{</span><span class="sc">\infty</span><span class="ss">} f</span><span class="sc">\left</span><span class="ss"> ( x </span><span class="sc">\right</span><span class="ss"> ) e^{-i2</span><span class="sc">\pi</span><span class="ss"> </span><span class="sc">\xi</span><span class="ss"> x} dx$$</span></span>
+<span id="cb651-9"><a href="#cb651-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
+<span id="cb651-10"><a href="#cb651-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb649"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb649-1"><a href="#cb649-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb652"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb652-1"><a href="#cb652-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -12223,22 +12316,22 @@ class="math display"><em>f̂</em>(<em>ξ</em>) = ∫<sub>−∞</sub><sup>
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb650"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb650-1"><a href="#cb650-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb650-2"><a href="#cb650-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[texMathDollars]{<span class="ex">markdown</span>}</span>
-<span id="cb650-3"><a href="#cb650-3" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">amsmath</span>}</span>
-<span id="cb650-4"><a href="#cb650-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererInlineMath</span>#1{<span class="kw">\begin</span>{<span class="ex">math</span>}<span class="ss">#1</span><span class="sc">\dots\end</span><span class="ss">{math}}</span></span>
-<span id="cb650-5"><a href="#cb650-5" aria-hidden="true" tabindex="-1"></a><span class="sc">\def\markdownRendererDisplayMath</span><span class="ss">#1{</span><span class="kw">\begin</span>{<span class="ex">equation</span>}<span class="ss">#1</span><span class="sc">\end</span><span class="ss">{equation}}</span></span>
-<span id="cb650-6"><a href="#cb650-6" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb650-7"><a href="#cb650-7" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb650-8"><a href="#cb650-8" aria-hidden="true" tabindex="-1"></a><span class="er">$</span><span class="ss">E=mc^2</span><span class="er">$</span></span>
-<span id="cb650-9"><a href="#cb650-9" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb650-10"><a href="#cb650-10" aria-hidden="true" tabindex="-1"></a><span class="er">$$</span><span class="sc">\hat</span><span class="ss">{f} </span><span class="sc">\left</span><span class="ss"> ( </span><span class="sc">\xi</span><span class="ss"> </span><span class="sc">\right</span><span class="ss"> )= </span><span class="sc">\int</span><span class="ss">_{-</span><span class="sc">\infty</span><span class="ss">}^{</span><span class="sc">\infty</span><span class="ss">} f</span><span class="sc">\left</span><span class="ss"> ( x </span><span class="sc">\right</span><span class="ss"> ) e^{-i2</span><span class="sc">\pi</span><span class="ss"> </span><span class="sc">\xi</span><span class="ss"> x} dx</span><span class="er">$$</span></span>
-<span id="cb650-11"><a href="#cb650-11" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb650-12"><a href="#cb650-12" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb653"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb653-1"><a href="#cb653-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb653-2"><a href="#cb653-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[texMathDollars]{<span class="ex">markdown</span>}</span>
+<span id="cb653-3"><a href="#cb653-3" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">amsmath</span>}</span>
+<span id="cb653-4"><a href="#cb653-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererInlineMath</span>#1{<span class="kw">\begin</span>{<span class="ex">math</span>}<span class="ss">#1</span><span class="sc">\dots\end</span><span class="ss">{math}}</span></span>
+<span id="cb653-5"><a href="#cb653-5" aria-hidden="true" tabindex="-1"></a><span class="sc">\def\markdownRendererDisplayMath</span><span class="ss">#1{</span><span class="kw">\begin</span>{<span class="ex">equation</span>}<span class="ss">#1</span><span class="sc">\end</span><span class="ss">{equation}}</span></span>
+<span id="cb653-6"><a href="#cb653-6" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb653-7"><a href="#cb653-7" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb653-8"><a href="#cb653-8" aria-hidden="true" tabindex="-1"></a><span class="er">$</span><span class="ss">E=mc^2</span><span class="er">$</span></span>
+<span id="cb653-9"><a href="#cb653-9" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb653-10"><a href="#cb653-10" aria-hidden="true" tabindex="-1"></a><span class="er">$$</span><span class="sc">\hat</span><span class="ss">{f} </span><span class="sc">\left</span><span class="ss"> ( </span><span class="sc">\xi</span><span class="ss"> </span><span class="sc">\right</span><span class="ss"> )= </span><span class="sc">\int</span><span class="ss">_{-</span><span class="sc">\infty</span><span class="ss">}^{</span><span class="sc">\infty</span><span class="ss">} f</span><span class="sc">\left</span><span class="ss"> ( x </span><span class="sc">\right</span><span class="ss"> ) e^{-i2</span><span class="sc">\pi</span><span class="ss"> </span><span class="sc">\xi</span><span class="ss"> x} dx</span><span class="er">$$</span></span>
+<span id="cb653-11"><a href="#cb653-11" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb653-12"><a href="#cb653-12" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb651"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb651-1"><a href="#cb651-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb654"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb654-1"><a href="#cb654-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -12251,21 +12344,21 @@ class="math display"><em>f̂</em>(<em>ξ</em>) = ∫<sub>−∞</sub><sup>
class="tex">T<sub>e</sub>X</span>t Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb652"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb652-1"><a href="#cb652-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
-<span id="cb652-2"><a href="#cb652-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[texMathDollars = yes]</span>
-<span id="cb652-3"><a href="#cb652-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererInlineMath</span>#1{<span class="ss">$#1</span><span class="sc">\dots</span><span class="ss">$</span>}<span class="co">%</span></span>
-<span id="cb652-4"><a href="#cb652-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererDisplayMath</span>#1{<span class="fu">\placeformula\startformula</span>#1<span class="fu">\stopformula</span>}<span class="co">%</span></span>
-<span id="cb652-5"><a href="#cb652-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
-<span id="cb652-6"><a href="#cb652-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb652-7"><a href="#cb652-7" aria-hidden="true" tabindex="-1"></a><span class="ss">$E=mc^2$</span></span>
-<span id="cb652-8"><a href="#cb652-8" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb652-9"><a href="#cb652-9" aria-hidden="true" tabindex="-1"></a><span class="ss">$$</span><span class="sc">\hat</span><span class="ss">{f} </span><span class="sc">\left</span><span class="ss"> ( </span><span class="sc">\xi</span><span class="ss"> </span><span class="sc">\right</span><span class="ss"> )= </span><span class="sc">\int</span><span class="ss">_{-</span><span class="sc">\infty</span><span class="ss">}^{</span><span class="sc">\infty</span><span class="ss">} f</span><span class="sc">\left</span><span class="ss"> ( x </span><span class="sc">\right</span><span class="ss"> ) e^{-i2</span><span class="sc">\pi</span><span class="ss"> </span><span class="sc">\xi</span><span class="ss"> x} dx$$</span></span>
-<span id="cb652-10"><a href="#cb652-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb652-11"><a href="#cb652-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
+<div class="sourceCode" id="cb655"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb655-1"><a href="#cb655-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
+<span id="cb655-2"><a href="#cb655-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[texMathDollars = yes]</span>
+<span id="cb655-3"><a href="#cb655-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererInlineMath</span>#1{<span class="ss">$#1</span><span class="sc">\dots</span><span class="ss">$</span>}<span class="co">%</span></span>
+<span id="cb655-4"><a href="#cb655-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererDisplayMath</span>#1{<span class="fu">\placeformula\startformula</span>#1<span class="fu">\stopformula</span>}<span class="co">%</span></span>
+<span id="cb655-5"><a href="#cb655-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
+<span id="cb655-6"><a href="#cb655-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb655-7"><a href="#cb655-7" aria-hidden="true" tabindex="-1"></a><span class="ss">$E=mc^2$</span></span>
+<span id="cb655-8"><a href="#cb655-8" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb655-9"><a href="#cb655-9" aria-hidden="true" tabindex="-1"></a><span class="ss">$$</span><span class="sc">\hat</span><span class="ss">{f} </span><span class="sc">\left</span><span class="ss"> ( </span><span class="sc">\xi</span><span class="ss"> </span><span class="sc">\right</span><span class="ss"> )= </span><span class="sc">\int</span><span class="ss">_{-</span><span class="sc">\infty</span><span class="ss">}^{</span><span class="sc">\infty</span><span class="ss">} f</span><span class="sc">\left</span><span class="ss"> ( x </span><span class="sc">\right</span><span class="ss"> ) e^{-i2</span><span class="sc">\pi</span><span class="ss"> </span><span class="sc">\xi</span><span class="ss"> x} dx$$</span></span>
+<span id="cb655-10"><a href="#cb655-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb655-11"><a href="#cb655-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb653"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb653-1"><a href="#cb653-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb656"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb656-1"><a href="#cb656-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -12277,26 +12370,26 @@ class="math display"><em>f̂</em>(<em>ξ</em>) = ∫<sub>−∞</sub><sup>
<h4 data-number="2.3.1.41" id="thematic-break-renderer"><span
class="header-section-number">2.3.1.41</span> Thematic Break
Renderer</h4>
-<p>The <code>\markdownRendererThematicBreak</code> macro represents a
+<p>The <code>markdownRendererThematicBreak</code> macro represents a
thematic break. The macro receives no arguments.</p>
<h5 class="unnumbered" id="plain-tex-example-45">Plain <span
class="tex">T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb654"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb654-1"><a href="#cb654-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
-<span id="cb654-2"><a href="#cb654-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererThematicBreak</span>{<span class="fu">\vfil\break</span>}</span>
-<span id="cb654-3"><a href="#cb654-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
-<span id="cb654-4"><a href="#cb654-4" aria-hidden="true" tabindex="-1"></a>This is the first page.</span>
-<span id="cb654-5"><a href="#cb654-5" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb654-6"><a href="#cb654-6" aria-hidden="true" tabindex="-1"></a>***</span>
-<span id="cb654-7"><a href="#cb654-7" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb654-8"><a href="#cb654-8" aria-hidden="true" tabindex="-1"></a>This is the second page.</span>
-<span id="cb654-9"><a href="#cb654-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
-<span id="cb654-10"><a href="#cb654-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb657"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb657-1"><a href="#cb657-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
+<span id="cb657-2"><a href="#cb657-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererThematicBreak</span>{<span class="fu">\vfil\break</span>}</span>
+<span id="cb657-3"><a href="#cb657-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
+<span id="cb657-4"><a href="#cb657-4" aria-hidden="true" tabindex="-1"></a>This is the first page.</span>
+<span id="cb657-5"><a href="#cb657-5" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb657-6"><a href="#cb657-6" aria-hidden="true" tabindex="-1"></a>***</span>
+<span id="cb657-7"><a href="#cb657-7" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb657-8"><a href="#cb657-8" aria-hidden="true" tabindex="-1"></a>This is the second page.</span>
+<span id="cb657-9"><a href="#cb657-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
+<span id="cb657-10"><a href="#cb657-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb655"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb655-1"><a href="#cb655-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb658"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb658-1"><a href="#cb658-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -12308,26 +12401,26 @@ contain the following text:</p>
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb656"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb656-1"><a href="#cb656-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb656-2"><a href="#cb656-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span>
-<span id="cb656-3"><a href="#cb656-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb656-4"><a href="#cb656-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb656-5"><a href="#cb656-5" aria-hidden="true" tabindex="-1"></a> thematicBreak = <span class="fu">\newpage</span>,</span>
-<span id="cb656-6"><a href="#cb656-6" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb656-7"><a href="#cb656-7" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb656-8"><a href="#cb656-8" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb656-9"><a href="#cb656-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb656-10"><a href="#cb656-10" aria-hidden="true" tabindex="-1"></a>This is the first page.</span>
-<span id="cb656-11"><a href="#cb656-11" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb656-12"><a href="#cb656-12" aria-hidden="true" tabindex="-1"></a>***</span>
-<span id="cb656-13"><a href="#cb656-13" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb656-14"><a href="#cb656-14" aria-hidden="true" tabindex="-1"></a>This is the second page.</span>
-<span id="cb656-15"><a href="#cb656-15" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb656-16"><a href="#cb656-16" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb659"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb659-1"><a href="#cb659-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb659-2"><a href="#cb659-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span>
+<span id="cb659-3"><a href="#cb659-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb659-4"><a href="#cb659-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb659-5"><a href="#cb659-5" aria-hidden="true" tabindex="-1"></a> thematicBreak = <span class="fu">\newpage</span>,</span>
+<span id="cb659-6"><a href="#cb659-6" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb659-7"><a href="#cb659-7" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb659-8"><a href="#cb659-8" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb659-9"><a href="#cb659-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb659-10"><a href="#cb659-10" aria-hidden="true" tabindex="-1"></a>This is the first page.</span>
+<span id="cb659-11"><a href="#cb659-11" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb659-12"><a href="#cb659-12" aria-hidden="true" tabindex="-1"></a>***</span>
+<span id="cb659-13"><a href="#cb659-13" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb659-14"><a href="#cb659-14" aria-hidden="true" tabindex="-1"></a>This is the second page.</span>
+<span id="cb659-15"><a href="#cb659-15" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb659-16"><a href="#cb659-16" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb657"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb657-1"><a href="#cb657-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb660"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb660-1"><a href="#cb660-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -12339,21 +12432,21 @@ contain the following text:</p>
class="tex">T<sub>e</sub>X</span>t Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb658"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb658-1"><a href="#cb658-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
-<span id="cb658-2"><a href="#cb658-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererThematicBreak</span>{<span class="fu">\page</span>[yes]}</span>
-<span id="cb658-3"><a href="#cb658-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
-<span id="cb658-4"><a href="#cb658-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb658-5"><a href="#cb658-5" aria-hidden="true" tabindex="-1"></a>This is the first page.</span>
-<span id="cb658-6"><a href="#cb658-6" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb658-7"><a href="#cb658-7" aria-hidden="true" tabindex="-1"></a>***</span>
-<span id="cb658-8"><a href="#cb658-8" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb658-9"><a href="#cb658-9" aria-hidden="true" tabindex="-1"></a>This is the second page.</span>
-<span id="cb658-10"><a href="#cb658-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb658-11"><a href="#cb658-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
+<div class="sourceCode" id="cb661"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb661-1"><a href="#cb661-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
+<span id="cb661-2"><a href="#cb661-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererThematicBreak</span>{<span class="fu">\page</span>[yes]}</span>
+<span id="cb661-3"><a href="#cb661-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
+<span id="cb661-4"><a href="#cb661-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb661-5"><a href="#cb661-5" aria-hidden="true" tabindex="-1"></a>This is the first page.</span>
+<span id="cb661-6"><a href="#cb661-6" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb661-7"><a href="#cb661-7" aria-hidden="true" tabindex="-1"></a>***</span>
+<span id="cb661-8"><a href="#cb661-8" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb661-9"><a href="#cb661-9" aria-hidden="true" tabindex="-1"></a>This is the second page.</span>
+<span id="cb661-10"><a href="#cb661-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb661-11"><a href="#cb661-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb659"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb659-1"><a href="#cb659-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb662"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb662-1"><a href="#cb662-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -12363,11 +12456,11 @@ contain the following text:</p>
</blockquote>
<h4 data-number="2.3.1.42" id="tickbox-renderers"><span
class="header-section-number">2.3.1.42</span> Tickbox Renderers</h4>
-<p>The macros named <code>\markdownRendererTickedBox</code>,
-<code>\markdownRendererHalfTickedBox</code>, and
-<code>\markdownRendererUntickedBox</code> represent ticked and unticked
+<p>The macros named <code>markdownRendererTickedBox</code>,
+<code>markdownRendererHalfTickedBox</code>, and
+<code>markdownRendererUntickedBox</code> represent ticked and unticked
boxes, respectively. These macros will either be produced, when the
-<strong><code>taskLists</code></strong> option is enabled, or when the
+<code><strong>taskLists</strong></code> option is enabled, or when the
Ballot Box with X (☒, U+2612), Hourglass (⌛, U+231B) or Ballot Box (☐,
U+2610) Unicode characters are encountered in the markdown input,
respectively.</p>
@@ -12375,24 +12468,24 @@ respectively.</p>
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb660"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb660-1"><a href="#cb660-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb660-2"><a href="#cb660-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[taskLists]{<span class="ex">markdown</span>}</span>
-<span id="cb660-3"><a href="#cb660-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb660-4"><a href="#cb660-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb660-5"><a href="#cb660-5" aria-hidden="true" tabindex="-1"></a> untickedBox = No,</span>
-<span id="cb660-6"><a href="#cb660-6" aria-hidden="true" tabindex="-1"></a> tickedBox = Yes,</span>
-<span id="cb660-7"><a href="#cb660-7" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb660-8"><a href="#cb660-8" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb660-9"><a href="#cb660-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb660-10"><a href="#cb660-10" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb660-11"><a href="#cb660-11" aria-hidden="true" tabindex="-1"></a>- [ ] you can&#39;t.</span>
-<span id="cb660-12"><a href="#cb660-12" aria-hidden="true" tabindex="-1"></a>- [x] I can!</span>
-<span id="cb660-13"><a href="#cb660-13" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb660-14"><a href="#cb660-14" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb663"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb663-1"><a href="#cb663-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb663-2"><a href="#cb663-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[taskLists]{<span class="ex">markdown</span>}</span>
+<span id="cb663-3"><a href="#cb663-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb663-4"><a href="#cb663-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb663-5"><a href="#cb663-5" aria-hidden="true" tabindex="-1"></a> untickedBox = No,</span>
+<span id="cb663-6"><a href="#cb663-6" aria-hidden="true" tabindex="-1"></a> tickedBox = Yes,</span>
+<span id="cb663-7"><a href="#cb663-7" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb663-8"><a href="#cb663-8" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb663-9"><a href="#cb663-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb663-10"><a href="#cb663-10" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb663-11"><a href="#cb663-11" aria-hidden="true" tabindex="-1"></a>- [ ] you can&#39;t.</span>
+<span id="cb663-12"><a href="#cb663-12" aria-hidden="true" tabindex="-1"></a>- [x] I can!</span>
+<span id="cb663-13"><a href="#cb663-13" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb663-14"><a href="#cb663-14" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb661"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb661-1"><a href="#cb661-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb664"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb664-1"><a href="#cb664-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -12405,20 +12498,20 @@ contain the following text:</p>
class="tex">T<sub>e</sub>X</span>t Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb662"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb662-1"><a href="#cb662-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
-<span id="cb662-2"><a href="#cb662-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[taskLists = yes]</span>
-<span id="cb662-3"><a href="#cb662-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererUntickedBox</span>{No}</span>
-<span id="cb662-4"><a href="#cb662-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererTickedBox</span>{Yes}</span>
-<span id="cb662-5"><a href="#cb662-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
-<span id="cb662-6"><a href="#cb662-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb662-7"><a href="#cb662-7" aria-hidden="true" tabindex="-1"></a>- [ ] you can&#39;t.</span>
-<span id="cb662-8"><a href="#cb662-8" aria-hidden="true" tabindex="-1"></a>- [x] I can!</span>
-<span id="cb662-9"><a href="#cb662-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb662-10"><a href="#cb662-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
+<div class="sourceCode" id="cb665"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb665-1"><a href="#cb665-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
+<span id="cb665-2"><a href="#cb665-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[taskLists = yes]</span>
+<span id="cb665-3"><a href="#cb665-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererUntickedBox</span>{No}</span>
+<span id="cb665-4"><a href="#cb665-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererTickedBox</span>{Yes}</span>
+<span id="cb665-5"><a href="#cb665-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
+<span id="cb665-6"><a href="#cb665-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb665-7"><a href="#cb665-7" aria-hidden="true" tabindex="-1"></a>- [ ] you can&#39;t.</span>
+<span id="cb665-8"><a href="#cb665-8" aria-hidden="true" tabindex="-1"></a>- [x] I can!</span>
+<span id="cb665-9"><a href="#cb665-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb665-10"><a href="#cb665-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb663"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb663-1"><a href="#cb663-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb666"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb666-1"><a href="#cb666-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -12427,62 +12520,103 @@ contain the following text:</p>
<li>Yes I can!</li>
</ul>
</blockquote>
-<h4 data-number="2.3.1.43" id="yamlmetadatarenderers"><span
-class="header-section-number">2.3.1.43</span> YAML Metadata
+<h4 data-number="2.3.1.43" id="warning-and-error-renderers"><span
+class="header-section-number">2.3.1.43</span> Warning and Error
+Renderers</h4>
+<p>The <code>markdownRendererWarning</code> and
+<code>markdownRendererError</code> macros represent warnings and errors
+produced by the markdown parser. Both macros receive four
+parameters:</p>
+<ol type="1">
+<li>The fully escaped text of the warning or error that can be directly
+typeset</li>
+<li>The raw text of the warning or error that can be used outside
+typesetting for e.g. logging the warning or error.</li>
+<li>The fully escaped text with more details about the warning or error
+that can be directly typeset. Can be empty, unlike the first two
+parameters.</li>
+<li>The raw text with more details about the warning or error that can
+be used outside typesetting for e.g. logging the warning or error. Can
+be empty, unlike the first two parameters.</li>
+</ol>
+<h4 data-number="2.3.1.44" id="yamlmetadatarenderers"><span
+class="header-section-number">2.3.1.44</span> YAML Metadata
Renderers</h4>
-<p>The <code>\markdownRendererJekyllDataBegin</code> macro represents
-the beginning of a <abbr>yaml</abbr> document. This macro will only be
-produced when the <strong><code>jekyllData</code></strong> option is
+<p>The <code>markdownRendererJekyllDataBegin</code> macro represents the
+beginning of a <abbr>yaml</abbr> document. This macro will only be
+produced when the <code><strong>jekyllData</strong></code> option is
enabled. The macro receives no arguments.</p>
-<p>The <code>\markdownRendererJekyllDataEnd</code> macro represents the
+<p>The <code>markdownRendererJekyllDataEnd</code> macro represents the
end of a <abbr>yaml</abbr> document. This macro will only be produced
-when the <strong><code>jekyllData</code></strong> option is enabled. The
+when the <code><strong>jekyllData</strong></code> option is enabled. The
macro receives no arguments.</p>
-<p>The <code>\markdownRendererJekyllDataMappingBegin</code> macro
+<p>The <code>markdownRendererJekyllDataMappingBegin</code> macro
represents the beginning of a mapping in a <abbr>yaml</abbr> document.
This macro will only be produced when the
-<strong><code>jekyllData</code></strong> option is enabled. The macro
+<code><strong>jekyllData</strong></code> option is enabled. The macro
receives two arguments: the scalar key in the parent structure, cast to
a string following <abbr>yaml</abbr> serialization rules, and the number
of items in the mapping.</p>
-<p>The <code>\markdownRendererJekyllDataMappingEnd</code> macro
+<p>The <code>markdownRendererJekyllDataMappingEnd</code> macro
represents the end of a mapping in a <abbr>yaml</abbr> document. This
macro will only be produced when the
-<strong><code>jekyllData</code></strong> option is enabled. The macro
+<code><strong>jekyllData</strong></code> option is enabled. The macro
receives no arguments.</p>
-<p>The <code>\markdownRendererJekyllDataSequenceBegin</code> macro
+<p>The <code>markdownRendererJekyllDataSequenceBegin</code> macro
represents the beginning of a sequence in a <abbr>yaml</abbr> document.
This macro will only be produced when the
-<strong><code>jekyllData</code></strong> option is enabled. The macro
+<code><strong>jekyllData</strong></code> option is enabled. The macro
receives two arguments: the scalar key in the parent structure, cast to
a string following <abbr>yaml</abbr> serialization rules, and the number
of items in the sequence.</p>
-<p>The <code>\markdownRendererJekyllDataSequenceEnd</code> macro
+<p>The <code>markdownRendererJekyllDataSequenceEnd</code> macro
represents the end of a sequence in a <abbr>yaml</abbr> document. This
macro will only be produced when the
-<strong><code>jekyllData</code></strong> option is enabled. The macro
+<code><strong>jekyllData</strong></code> option is enabled. The macro
receives no arguments.</p>
-<p>The <code>\markdownRendererJekyllDataBoolean</code> macro represents
-a boolean scalar value in a <abbr>yaml</abbr> document. This macro will
-only be produced when the <strong><code>jekyllData</code></strong>
+<p>The <code>markdownRendererJekyllDataBoolean</code> macro represents a
+boolean scalar value in a <abbr>yaml</abbr> document. This macro will
+only be produced when the <code><strong>jekyllData</strong></code>
option is enabled. The macro receives two arguments: the scalar key in
the parent structure, and the scalar value, both cast to a string
following <abbr>yaml</abbr> serialization rules.</p>
-<p>The <code>\markdownRendererJekyllDataNumber</code> macro represents a
+<p>The <code>markdownRendererJekyllDataNumber</code> macro represents a
numeric scalar value in a <abbr>yaml</abbr> document. This macro will
-only be produced when the <strong><code>jekyllData</code></strong>
+only be produced when the <code><strong>jekyllData</strong></code>
option is enabled. The macro receives two arguments: the scalar key in
the parent structure, and the scalar value, both cast to a string
following <abbr>yaml</abbr> serialization rules.</p>
-<p>The <code>\markdownRendererJekyllDataString</code> macro represents a
-string scalar value in a <abbr>yaml</abbr> document. This macro will
-only be produced when the <strong><code>jekyllData</code></strong>
-option is enabled. The macro receives two arguments: the scalar key in
-the parent structure, cast to a string following <abbr>yaml</abbr>
-serialization rules, and the scalar value.</p>
-<p>The <code>\markdownRendererJekyllDataEmpty</code> macro represents an
+<p>The <code>markdownRendererJekyllDataTypographicString</code> and
+<code>markdownRendererJekyllDataProgrammaticString</code> macros
+represent string scalar values in a <abbr>yaml</abbr> document. This
+macro will only be produced when the
+<code><strong>jekyllData</strong></code> option is enabled. The macro
+receives two arguments: the scalar key in the parent structure, cast to
+a string following <abbr>yaml</abbr> serialization rules, and the scalar
+value.</p>
+<p>For each string scalar value, both macros are produced. Whereas
+<code>markdownRendererJekyllDataTypographicString</code> receives the
+scalar value after all markdown markup and special <span
+class="tex">T<sub>e</sub>X</span> characters in the string have been
+replaced by <span class="tex">T<sub>e</sub>X</span> macros,
+<code>markdownRendererJekyllDataProgrammaticString</code> receives the
+raw scalar value. Therefore, whereas the
+<code>markdownRendererJekyllDataTypographicString</code> macro is more
+appropriate for texts that are supposed to be typeset with <span
+class="tex">T<sub>e</sub>X</span>, such as document titles, author
+names, or exam questions, the
+<code>markdownRendererJekyllDataProgrammaticString</code> macro is more
+appropriate for identifiers and other programmatic text that won’t be
+typeset by <span class="tex">T<sub>e</sub>X</span>.</p>
+<p>Before Markdown 3.7.0, the
+<code>markdownRendererJekyllDataTypographicString</code> macro was named
+<code>markdownRendererJekyllDataString</code> and the
+<code>markdownRendererJekyllDataProgrammaticString</code> macro was not
+produced. The <code>markdownRendererJekyllDataString</code> has been
+deprecated and will be removed in Markdown 4.0.0.</p>
+<p>The <code>markdownRendererJekyllDataEmpty</code> macro represents an
empty scalar value in a <abbr>yaml</abbr> document. This macro will only
-be produced when the <strong><code>jekyllData</code></strong> option is
+be produced when the <code><strong>jekyllData</strong></code> option is
enabled. The macro receives one argument: the scalar key in the parent
structure, cast to a string following <abbr>yaml</abbr> serialization
rules.</p>
@@ -12490,23 +12624,23 @@ rules.</p>
class="tex">T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb664"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb664-1"><a href="#cb664-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
-<span id="cb664-2"><a href="#cb664-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionJekyllData</span>{true}</span>
-<span id="cb664-3"><a href="#cb664-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererJekyllDataString</span>#1#2{<span class="fu">\gdef\name</span>{#2}}</span>
-<span id="cb664-4"><a href="#cb664-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererJekyllDataNumber</span>#1#2{<span class="fu">\gdef\age</span>{#2}}</span>
-<span id="cb664-5"><a href="#cb664-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererJekyllDataEnd</span>{<span class="co">%</span></span>
-<span id="cb664-6"><a href="#cb664-6" aria-hidden="true" tabindex="-1"></a> <span class="fu">\name</span>{} is <span class="fu">\age</span>{} years old.}</span>
-<span id="cb664-7"><a href="#cb664-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
-<span id="cb664-8"><a href="#cb664-8" aria-hidden="true" tabindex="-1"></a>---</span>
-<span id="cb664-9"><a href="#cb664-9" aria-hidden="true" tabindex="-1"></a>name: Jane Doe</span>
-<span id="cb664-10"><a href="#cb664-10" aria-hidden="true" tabindex="-1"></a>age: 99</span>
-<span id="cb664-11"><a href="#cb664-11" aria-hidden="true" tabindex="-1"></a>---</span>
-<span id="cb664-12"><a href="#cb664-12" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
-<span id="cb664-13"><a href="#cb664-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb667"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb667-1"><a href="#cb667-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
+<span id="cb667-2"><a href="#cb667-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionJekyllData</span>{true}</span>
+<span id="cb667-3"><a href="#cb667-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererJekyllDataTypographicString</span>#1#2{<span class="fu">\gdef\name</span>{#2}}</span>
+<span id="cb667-4"><a href="#cb667-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererJekyllDataNumber</span>#1#2{<span class="fu">\gdef\age</span>{#2}}</span>
+<span id="cb667-5"><a href="#cb667-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererJekyllDataEnd</span>{<span class="co">%</span></span>
+<span id="cb667-6"><a href="#cb667-6" aria-hidden="true" tabindex="-1"></a> <span class="fu">\name</span>{} is <span class="fu">\age</span>{} years old.}</span>
+<span id="cb667-7"><a href="#cb667-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
+<span id="cb667-8"><a href="#cb667-8" aria-hidden="true" tabindex="-1"></a>---</span>
+<span id="cb667-9"><a href="#cb667-9" aria-hidden="true" tabindex="-1"></a>name: Jane Doe</span>
+<span id="cb667-10"><a href="#cb667-10" aria-hidden="true" tabindex="-1"></a>age: 99</span>
+<span id="cb667-11"><a href="#cb667-11" aria-hidden="true" tabindex="-1"></a>---</span>
+<span id="cb667-12"><a href="#cb667-12" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
+<span id="cb667-13"><a href="#cb667-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb665"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb665-1"><a href="#cb665-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb668"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb668-1"><a href="#cb668-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -12516,29 +12650,29 @@ contain the following text:</p>
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb666"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb666-1"><a href="#cb666-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb666-2"><a href="#cb666-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[jekyllData]{<span class="ex">markdown</span>}</span>
-<span id="cb666-3"><a href="#cb666-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb666-4"><a href="#cb666-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb666-5"><a href="#cb666-5" aria-hidden="true" tabindex="-1"></a> jekyllDataString = {<span class="fu">\gdef\name</span>{#2}},</span>
-<span id="cb666-6"><a href="#cb666-6" aria-hidden="true" tabindex="-1"></a> jekyllDataNumber = {<span class="fu">\gdef\age</span>{#2}},</span>
-<span id="cb666-7"><a href="#cb666-7" aria-hidden="true" tabindex="-1"></a> jekyllDataEnd = {<span class="fu">\name</span>{} is <span class="fu">\age</span>{} years old.},</span>
-<span id="cb666-8"><a href="#cb666-8" aria-hidden="true" tabindex="-1"></a> }</span>
-<span id="cb666-9"><a href="#cb666-9" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb666-10"><a href="#cb666-10" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb666-11"><a href="#cb666-11" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb666-12"><a href="#cb666-12" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb666-13"><a href="#cb666-13" aria-hidden="true" tabindex="-1"></a>---</span>
-<span id="cb666-14"><a href="#cb666-14" aria-hidden="true" tabindex="-1"></a>name: Jane Doe</span>
-<span id="cb666-15"><a href="#cb666-15" aria-hidden="true" tabindex="-1"></a>age: 99</span>
-<span id="cb666-16"><a href="#cb666-16" aria-hidden="true" tabindex="-1"></a>---</span>
-<span id="cb666-17"><a href="#cb666-17" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb666-18"><a href="#cb666-18" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb666-19"><a href="#cb666-19" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb669"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb669-1"><a href="#cb669-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb669-2"><a href="#cb669-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[jekyllData]{<span class="ex">markdown</span>}</span>
+<span id="cb669-3"><a href="#cb669-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb669-4"><a href="#cb669-4" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb669-5"><a href="#cb669-5" aria-hidden="true" tabindex="-1"></a> jekyllDataTypographicString = {<span class="fu">\gdef\name</span>{#2}},</span>
+<span id="cb669-6"><a href="#cb669-6" aria-hidden="true" tabindex="-1"></a> jekyllDataNumber = {<span class="fu">\gdef\age</span>{#2}},</span>
+<span id="cb669-7"><a href="#cb669-7" aria-hidden="true" tabindex="-1"></a> jekyllDataEnd = {<span class="fu">\name</span>{} is <span class="fu">\age</span>{} years old.},</span>
+<span id="cb669-8"><a href="#cb669-8" aria-hidden="true" tabindex="-1"></a> }</span>
+<span id="cb669-9"><a href="#cb669-9" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb669-10"><a href="#cb669-10" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb669-11"><a href="#cb669-11" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb669-12"><a href="#cb669-12" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb669-13"><a href="#cb669-13" aria-hidden="true" tabindex="-1"></a>---</span>
+<span id="cb669-14"><a href="#cb669-14" aria-hidden="true" tabindex="-1"></a>name: Jane Doe</span>
+<span id="cb669-15"><a href="#cb669-15" aria-hidden="true" tabindex="-1"></a>age: 99</span>
+<span id="cb669-16"><a href="#cb669-16" aria-hidden="true" tabindex="-1"></a>---</span>
+<span id="cb669-17"><a href="#cb669-17" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb669-18"><a href="#cb669-18" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb669-19"><a href="#cb669-19" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb667"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb667-1"><a href="#cb667-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb670"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb670-1"><a href="#cb670-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -12548,26 +12682,26 @@ contain the following text:</p>
class="tex">T<sub>e</sub>X</span>t Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb668"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb668-1"><a href="#cb668-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
-<span id="cb668-2"><a href="#cb668-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[jekyllData = yes]</span>
-<span id="cb668-3"><a href="#cb668-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererJekyllDataString</span>#1#2{<span class="fu">\gdef\name</span>{#2}}</span>
-<span id="cb668-4"><a href="#cb668-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererJekyllDataNumber</span>#1#2{<span class="fu">\gdef\age</span>{#2}}</span>
-<span id="cb668-5"><a href="#cb668-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererJekyllDataEnd</span>{<span class="co">%</span></span>
-<span id="cb668-6"><a href="#cb668-6" aria-hidden="true" tabindex="-1"></a> <span class="fu">\name</span>{} is <span class="fu">\age</span>{} years old.}</span>
-<span id="cb668-7"><a href="#cb668-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
-<span id="cb668-8"><a href="#cb668-8" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb668-9"><a href="#cb668-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb668-10"><a href="#cb668-10" aria-hidden="true" tabindex="-1"></a>---</span>
-<span id="cb668-11"><a href="#cb668-11" aria-hidden="true" tabindex="-1"></a>name: Jane Doe</span>
-<span id="cb668-12"><a href="#cb668-12" aria-hidden="true" tabindex="-1"></a>age: 99</span>
-<span id="cb668-13"><a href="#cb668-13" aria-hidden="true" tabindex="-1"></a>---</span>
-<span id="cb668-14"><a href="#cb668-14" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb668-15"><a href="#cb668-15" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb668-16"><a href="#cb668-16" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
+<div class="sourceCode" id="cb671"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb671-1"><a href="#cb671-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
+<span id="cb671-2"><a href="#cb671-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[jekyllData = yes]</span>
+<span id="cb671-3"><a href="#cb671-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererJekyllDataTypographicString</span>#1#2{<span class="fu">\gdef\name</span>{#2}}</span>
+<span id="cb671-4"><a href="#cb671-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererJekyllDataNumber</span>#1#2{<span class="fu">\gdef\age</span>{#2}}</span>
+<span id="cb671-5"><a href="#cb671-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererJekyllDataEnd</span>{<span class="co">%</span></span>
+<span id="cb671-6"><a href="#cb671-6" aria-hidden="true" tabindex="-1"></a> <span class="fu">\name</span>{} is <span class="fu">\age</span>{} years old.}</span>
+<span id="cb671-7"><a href="#cb671-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
+<span id="cb671-8"><a href="#cb671-8" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb671-9"><a href="#cb671-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb671-10"><a href="#cb671-10" aria-hidden="true" tabindex="-1"></a>---</span>
+<span id="cb671-11"><a href="#cb671-11" aria-hidden="true" tabindex="-1"></a>name: Jane Doe</span>
+<span id="cb671-12"><a href="#cb671-12" aria-hidden="true" tabindex="-1"></a>age: 99</span>
+<span id="cb671-13"><a href="#cb671-13" aria-hidden="true" tabindex="-1"></a>---</span>
+<span id="cb671-14"><a href="#cb671-14" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb671-15"><a href="#cb671-15" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb671-16"><a href="#cb671-16" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb669"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb669-1"><a href="#cb669-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb672"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb672-1"><a href="#cb672-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -12583,25 +12717,25 @@ class="tex">T<sub>e</sub>X</span> macros, further referred to as
class="tex">T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb670"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb670-1"><a href="#cb670-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
-<span id="cb670-2"><a href="#cb670-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererTildePrototype</span>{<span class="co">%</span></span>
-<span id="cb670-3"><a href="#cb670-3" aria-hidden="true" tabindex="-1"></a> Packages can specify token renderer prototypes.<span class="co">%</span></span>
-<span id="cb670-4"><a href="#cb670-4" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb670-5"><a href="#cb670-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
-<span id="cb670-6"><a href="#cb670-6" aria-hidden="true" tabindex="-1"></a>~</span>
-<span id="cb670-7"><a href="#cb670-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
-<span id="cb670-8"><a href="#cb670-8" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb670-9"><a href="#cb670-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererTilde</span>{<span class="co">%</span></span>
-<span id="cb670-10"><a href="#cb670-10" aria-hidden="true" tabindex="-1"></a> User-defined token renderers take precedence.<span class="co">%</span></span>
-<span id="cb670-11"><a href="#cb670-11" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb670-12"><a href="#cb670-12" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
-<span id="cb670-13"><a href="#cb670-13" aria-hidden="true" tabindex="-1"></a>~</span>
-<span id="cb670-14"><a href="#cb670-14" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
-<span id="cb670-15"><a href="#cb670-15" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb673"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb673-1"><a href="#cb673-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
+<span id="cb673-2"><a href="#cb673-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererTildePrototype</span>{<span class="co">%</span></span>
+<span id="cb673-3"><a href="#cb673-3" aria-hidden="true" tabindex="-1"></a> Packages can specify token renderer prototypes.<span class="co">%</span></span>
+<span id="cb673-4"><a href="#cb673-4" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb673-5"><a href="#cb673-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
+<span id="cb673-6"><a href="#cb673-6" aria-hidden="true" tabindex="-1"></a>~</span>
+<span id="cb673-7"><a href="#cb673-7" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
+<span id="cb673-8"><a href="#cb673-8" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb673-9"><a href="#cb673-9" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererTilde</span>{<span class="co">%</span></span>
+<span id="cb673-10"><a href="#cb673-10" aria-hidden="true" tabindex="-1"></a> User-defined token renderers take precedence.<span class="co">%</span></span>
+<span id="cb673-11"><a href="#cb673-11" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb673-12"><a href="#cb673-12" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
+<span id="cb673-13"><a href="#cb673-13" aria-hidden="true" tabindex="-1"></a>~</span>
+<span id="cb673-14"><a href="#cb673-14" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
+<span id="cb673-15"><a href="#cb673-15" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb671"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb671-1"><a href="#cb671-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb674"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb674-1"><a href="#cb674-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -12612,30 +12746,30 @@ contain the following text:</p>
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb672"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb672-1"><a href="#cb672-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb672-2"><a href="#cb672-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span>
-<span id="cb672-3"><a href="#cb672-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb672-4"><a href="#cb672-4" aria-hidden="true" tabindex="-1"></a> rendererPrototypes = {</span>
-<span id="cb672-5"><a href="#cb672-5" aria-hidden="true" tabindex="-1"></a> tilde = {Packages can specify token renderer prototypes.},</span>
-<span id="cb672-6"><a href="#cb672-6" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb672-7"><a href="#cb672-7" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb672-8"><a href="#cb672-8" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb672-9"><a href="#cb672-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb672-10"><a href="#cb672-10" aria-hidden="true" tabindex="-1"></a>~</span>
-<span id="cb672-11"><a href="#cb672-11" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb672-12"><a href="#cb672-12" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb672-13"><a href="#cb672-13" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}[</span>
-<span id="cb672-14"><a href="#cb672-14" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb672-15"><a href="#cb672-15" aria-hidden="true" tabindex="-1"></a> tilde = {User-defined token renderers take precedence.},</span>
-<span id="cb672-16"><a href="#cb672-16" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb672-17"><a href="#cb672-17" aria-hidden="true" tabindex="-1"></a>]</span>
-<span id="cb672-18"><a href="#cb672-18" aria-hidden="true" tabindex="-1"></a>~</span>
-<span id="cb672-19"><a href="#cb672-19" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb672-20"><a href="#cb672-20" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<div class="sourceCode" id="cb675"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb675-1"><a href="#cb675-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb675-2"><a href="#cb675-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>{<span class="ex">markdown</span>}</span>
+<span id="cb675-3"><a href="#cb675-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb675-4"><a href="#cb675-4" aria-hidden="true" tabindex="-1"></a> rendererPrototypes = {</span>
+<span id="cb675-5"><a href="#cb675-5" aria-hidden="true" tabindex="-1"></a> tilde = {Packages can specify token renderer prototypes.},</span>
+<span id="cb675-6"><a href="#cb675-6" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb675-7"><a href="#cb675-7" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb675-8"><a href="#cb675-8" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb675-9"><a href="#cb675-9" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb675-10"><a href="#cb675-10" aria-hidden="true" tabindex="-1"></a>~</span>
+<span id="cb675-11"><a href="#cb675-11" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb675-12"><a href="#cb675-12" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb675-13"><a href="#cb675-13" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}[</span>
+<span id="cb675-14"><a href="#cb675-14" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb675-15"><a href="#cb675-15" aria-hidden="true" tabindex="-1"></a> tilde = {User-defined token renderers take precedence.},</span>
+<span id="cb675-16"><a href="#cb675-16" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb675-17"><a href="#cb675-17" aria-hidden="true" tabindex="-1"></a>]</span>
+<span id="cb675-18"><a href="#cb675-18" aria-hidden="true" tabindex="-1"></a>~</span>
+<span id="cb675-19"><a href="#cb675-19" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb675-20"><a href="#cb675-20" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb673"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb673-1"><a href="#cb673-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb676"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb676-1"><a href="#cb676-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -12646,26 +12780,26 @@ contain the following text:</p>
class="tex">T<sub>e</sub>X</span>t Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb674"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb674-1"><a href="#cb674-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
-<span id="cb674-2"><a href="#cb674-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererTildePrototype</span>{<span class="co">%</span></span>
-<span id="cb674-3"><a href="#cb674-3" aria-hidden="true" tabindex="-1"></a> Packages can specify token renderer prototypes.<span class="co">%</span></span>
-<span id="cb674-4"><a href="#cb674-4" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb674-5"><a href="#cb674-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
-<span id="cb674-6"><a href="#cb674-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb674-7"><a href="#cb674-7" aria-hidden="true" tabindex="-1"></a>~</span>
-<span id="cb674-8"><a href="#cb674-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb674-9"><a href="#cb674-9" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb674-10"><a href="#cb674-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererTilde</span>{<span class="co">%</span></span>
-<span id="cb674-11"><a href="#cb674-11" aria-hidden="true" tabindex="-1"></a> User-defined token renderers take precedence.<span class="co">%</span></span>
-<span id="cb674-12"><a href="#cb674-12" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb674-13"><a href="#cb674-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb674-14"><a href="#cb674-14" aria-hidden="true" tabindex="-1"></a>~</span>
-<span id="cb674-15"><a href="#cb674-15" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb674-16"><a href="#cb674-16" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
+<div class="sourceCode" id="cb677"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb677-1"><a href="#cb677-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
+<span id="cb677-2"><a href="#cb677-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererTildePrototype</span>{<span class="co">%</span></span>
+<span id="cb677-3"><a href="#cb677-3" aria-hidden="true" tabindex="-1"></a> Packages can specify token renderer prototypes.<span class="co">%</span></span>
+<span id="cb677-4"><a href="#cb677-4" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb677-5"><a href="#cb677-5" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
+<span id="cb677-6"><a href="#cb677-6" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb677-7"><a href="#cb677-7" aria-hidden="true" tabindex="-1"></a>~</span>
+<span id="cb677-8"><a href="#cb677-8" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb677-9"><a href="#cb677-9" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb677-10"><a href="#cb677-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererTilde</span>{<span class="co">%</span></span>
+<span id="cb677-11"><a href="#cb677-11" aria-hidden="true" tabindex="-1"></a> User-defined token renderers take precedence.<span class="co">%</span></span>
+<span id="cb677-12"><a href="#cb677-12" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb677-13"><a href="#cb677-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb677-14"><a href="#cb677-14" aria-hidden="true" tabindex="-1"></a>~</span>
+<span id="cb677-15"><a href="#cb677-15" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb677-16"><a href="#cb677-16" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb675"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb675-1"><a href="#cb675-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb678"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb678-1"><a href="#cb678-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -12683,29 +12817,29 @@ the <span class="latex">L<sup>a</sup>T<sub>e</sub>X</span>3 kernel.</p>
class="tex">T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb676"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb676-1"><a href="#cb676-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
-<span id="cb676-2"><a href="#cb676-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionJekyllData</span>{true}</span>
-<span id="cb676-3"><a href="#cb676-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\ExplSyntaxOn</span></span>
-<span id="cb676-4"><a href="#cb676-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\keys</span>_define:nn</span>
-<span id="cb676-5"><a href="#cb676-5" aria-hidden="true" tabindex="-1"></a> { markdown/jekyllData }</span>
-<span id="cb676-6"><a href="#cb676-6" aria-hidden="true" tabindex="-1"></a> {</span>
-<span id="cb676-7"><a href="#cb676-7" aria-hidden="true" tabindex="-1"></a> name .code:n = { <span class="fu">\gdef\name</span>{#1} },</span>
-<span id="cb676-8"><a href="#cb676-8" aria-hidden="true" tabindex="-1"></a> age .code:n = { <span class="fu">\gdef\age</span>{#1} },</span>
-<span id="cb676-9"><a href="#cb676-9" aria-hidden="true" tabindex="-1"></a> }</span>
-<span id="cb676-10"><a href="#cb676-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\ExplSyntaxOff</span></span>
-<span id="cb676-11"><a href="#cb676-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererJekyllDataEnd</span>{<span class="co">%</span></span>
-<span id="cb676-12"><a href="#cb676-12" aria-hidden="true" tabindex="-1"></a> <span class="fu">\name</span>{} is <span class="fu">\age</span>{} years old.}</span>
-<span id="cb676-13"><a href="#cb676-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
-<span id="cb676-14"><a href="#cb676-14" aria-hidden="true" tabindex="-1"></a>---</span>
-<span id="cb676-15"><a href="#cb676-15" aria-hidden="true" tabindex="-1"></a>name: Jane Doe</span>
-<span id="cb676-16"><a href="#cb676-16" aria-hidden="true" tabindex="-1"></a>age: 99</span>
-<span id="cb676-17"><a href="#cb676-17" aria-hidden="true" tabindex="-1"></a>---</span>
-<span id="cb676-18"><a href="#cb676-18" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
-<span id="cb676-19"><a href="#cb676-19" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
+<div class="sourceCode" id="cb679"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb679-1"><a href="#cb679-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\input</span> markdown</span>
+<span id="cb679-2"><a href="#cb679-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownOptionJekyllData</span>{true}</span>
+<span id="cb679-3"><a href="#cb679-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\ExplSyntaxOn</span></span>
+<span id="cb679-4"><a href="#cb679-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\keys</span>_define:nn</span>
+<span id="cb679-5"><a href="#cb679-5" aria-hidden="true" tabindex="-1"></a> { markdown/jekyllData }</span>
+<span id="cb679-6"><a href="#cb679-6" aria-hidden="true" tabindex="-1"></a> {</span>
+<span id="cb679-7"><a href="#cb679-7" aria-hidden="true" tabindex="-1"></a> name .code:n = { <span class="fu">\gdef\name</span>{#1} },</span>
+<span id="cb679-8"><a href="#cb679-8" aria-hidden="true" tabindex="-1"></a> age .code:n = { <span class="fu">\gdef\age</span>{#1} },</span>
+<span id="cb679-9"><a href="#cb679-9" aria-hidden="true" tabindex="-1"></a> }</span>
+<span id="cb679-10"><a href="#cb679-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\ExplSyntaxOff</span></span>
+<span id="cb679-11"><a href="#cb679-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererJekyllDataEnd</span>{<span class="co">%</span></span>
+<span id="cb679-12"><a href="#cb679-12" aria-hidden="true" tabindex="-1"></a> <span class="fu">\name</span>{} is <span class="fu">\age</span>{} years old.}</span>
+<span id="cb679-13"><a href="#cb679-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownBegin</span></span>
+<span id="cb679-14"><a href="#cb679-14" aria-hidden="true" tabindex="-1"></a>---</span>
+<span id="cb679-15"><a href="#cb679-15" aria-hidden="true" tabindex="-1"></a>name: Jane Doe</span>
+<span id="cb679-16"><a href="#cb679-16" aria-hidden="true" tabindex="-1"></a>age: 99</span>
+<span id="cb679-17"><a href="#cb679-17" aria-hidden="true" tabindex="-1"></a>---</span>
+<span id="cb679-18"><a href="#cb679-18" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownEnd</span></span>
+<span id="cb679-19"><a href="#cb679-19" aria-hidden="true" tabindex="-1"></a><span class="fu">\bye</span></span></code></pre></div>
<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb677"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb677-1"><a href="#cb677-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb680"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb680-1"><a href="#cb680-1" aria-hidden="true" tabindex="-1"></a><span class="ex">luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -12715,31 +12849,31 @@ contain the following text:</p>
class="latex">L<sup>a</sup>T<sub>e</sub>X</span> Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb678"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb678-1"><a href="#cb678-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
-<span id="cb678-2"><a href="#cb678-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[jekyllData]{<span class="ex">markdown</span>}</span>
-<span id="cb678-3"><a href="#cb678-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
-<span id="cb678-4"><a href="#cb678-4" aria-hidden="true" tabindex="-1"></a> jekyllDataRenderers = {</span>
-<span id="cb678-5"><a href="#cb678-5" aria-hidden="true" tabindex="-1"></a> name = {<span class="fu">\gdef\name</span>{#1}},</span>
-<span id="cb678-6"><a href="#cb678-6" aria-hidden="true" tabindex="-1"></a> code = {<span class="fu">\gdef\age</span>{#1}},</span>
-<span id="cb678-7"><a href="#cb678-7" aria-hidden="true" tabindex="-1"></a> },</span>
-<span id="cb678-8"><a href="#cb678-8" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
-<span id="cb678-9"><a href="#cb678-9" aria-hidden="true" tabindex="-1"></a> jekyllDataEnd = {<span class="fu">\name</span>{} is <span class="fu">\age</span>{} years old.},</span>
-<span id="cb678-10"><a href="#cb678-10" aria-hidden="true" tabindex="-1"></a> }</span>
-<span id="cb678-11"><a href="#cb678-11" aria-hidden="true" tabindex="-1"></a>}</span>
-<span id="cb678-12"><a href="#cb678-12" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
-<span id="cb678-13"><a href="#cb678-13" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb678-14"><a href="#cb678-14" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
-<span id="cb678-15"><a href="#cb678-15" aria-hidden="true" tabindex="-1"></a>---</span>
-<span id="cb678-16"><a href="#cb678-16" aria-hidden="true" tabindex="-1"></a>name: Jane Doe</span>
-<span id="cb678-17"><a href="#cb678-17" aria-hidden="true" tabindex="-1"></a>age: 99</span>
-<span id="cb678-18"><a href="#cb678-18" aria-hidden="true" tabindex="-1"></a>---</span>
-<span id="cb678-19"><a href="#cb678-19" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
-<span id="cb678-20"><a href="#cb678-20" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb678-21"><a href="#cb678-21" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
-<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb679"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb679-1"><a href="#cb679-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb681"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb681-1"><a href="#cb681-1" aria-hidden="true" tabindex="-1"></a><span class="bu">\documentclass</span>{<span class="ex">article</span>}</span>
+<span id="cb681-2"><a href="#cb681-2" aria-hidden="true" tabindex="-1"></a><span class="bu">\usepackage</span>[jekyllData]{<span class="ex">markdown</span>}</span>
+<span id="cb681-3"><a href="#cb681-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\markdownSetup</span>{</span>
+<span id="cb681-4"><a href="#cb681-4" aria-hidden="true" tabindex="-1"></a> jekyllDataRenderers = {</span>
+<span id="cb681-5"><a href="#cb681-5" aria-hidden="true" tabindex="-1"></a> name = {<span class="fu">\gdef\name</span>{#1}},</span>
+<span id="cb681-6"><a href="#cb681-6" aria-hidden="true" tabindex="-1"></a> code = {<span class="fu">\gdef\age</span>{#1}},</span>
+<span id="cb681-7"><a href="#cb681-7" aria-hidden="true" tabindex="-1"></a> },</span>
+<span id="cb681-8"><a href="#cb681-8" aria-hidden="true" tabindex="-1"></a> renderers = {</span>
+<span id="cb681-9"><a href="#cb681-9" aria-hidden="true" tabindex="-1"></a> jekyllDataEnd = {<span class="fu">\name</span>{} is <span class="fu">\age</span>{} years old.},</span>
+<span id="cb681-10"><a href="#cb681-10" aria-hidden="true" tabindex="-1"></a> }</span>
+<span id="cb681-11"><a href="#cb681-11" aria-hidden="true" tabindex="-1"></a>}</span>
+<span id="cb681-12"><a href="#cb681-12" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">document</span>}</span>
+<span id="cb681-13"><a href="#cb681-13" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb681-14"><a href="#cb681-14" aria-hidden="true" tabindex="-1"></a><span class="kw">\begin</span>{<span class="ex">markdown</span>}</span>
+<span id="cb681-15"><a href="#cb681-15" aria-hidden="true" tabindex="-1"></a>---</span>
+<span id="cb681-16"><a href="#cb681-16" aria-hidden="true" tabindex="-1"></a>name: Jane Doe</span>
+<span id="cb681-17"><a href="#cb681-17" aria-hidden="true" tabindex="-1"></a>age: 99</span>
+<span id="cb681-18"><a href="#cb681-18" aria-hidden="true" tabindex="-1"></a>---</span>
+<span id="cb681-19"><a href="#cb681-19" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">markdown</span>}</span>
+<span id="cb681-20"><a href="#cb681-20" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb681-21"><a href="#cb681-21" aria-hidden="true" tabindex="-1"></a><span class="kw">\end</span>{<span class="ex">document</span>}</span></code></pre></div>
+<p>Next, invoke LuaTeX from the terminal:</p>
+<div class="sourceCode" id="cb682"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb682-1"><a href="#cb682-1" aria-hidden="true" tabindex="-1"></a><span class="ex">lualatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
@@ -12749,32 +12883,32 @@ contain the following text:</p>
class="tex">T<sub>e</sub>X</span>t Example</h5>
<p>Using a text editor, create a text document named
<code>document.tex</code> with the following content:</p>
-<div class="sourceCode" id="cb680"><pre
-class="sourceCode tex"><code class="sourceCode latex"><span id="cb680-1"><a href="#cb680-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
-<span id="cb680-2"><a href="#cb680-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[jekyllData = yes]</span>
-<span id="cb680-3"><a href="#cb680-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\ExplSyntaxOn</span></span>
-<span id="cb680-4"><a href="#cb680-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\keys</span>_define:nn</span>
-<span id="cb680-5"><a href="#cb680-5" aria-hidden="true" tabindex="-1"></a> { markdown/jekyllData }</span>
-<span id="cb680-6"><a href="#cb680-6" aria-hidden="true" tabindex="-1"></a> {</span>
-<span id="cb680-7"><a href="#cb680-7" aria-hidden="true" tabindex="-1"></a> name .code:n = { <span class="fu">\gdef\name</span>{#1} },</span>
-<span id="cb680-8"><a href="#cb680-8" aria-hidden="true" tabindex="-1"></a> age .code:n = { <span class="fu">\gdef\age</span>{#1} },</span>
-<span id="cb680-9"><a href="#cb680-9" aria-hidden="true" tabindex="-1"></a> }</span>
-<span id="cb680-10"><a href="#cb680-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\ExplSyntaxOff</span></span>
-<span id="cb680-11"><a href="#cb680-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererJekyllDataEnd</span>{<span class="co">%</span></span>
-<span id="cb680-12"><a href="#cb680-12" aria-hidden="true" tabindex="-1"></a> <span class="fu">\name</span>{} is <span class="fu">\age</span>{} years old.}</span>
-<span id="cb680-13"><a href="#cb680-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
-<span id="cb680-14"><a href="#cb680-14" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb680-15"><a href="#cb680-15" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
-<span id="cb680-16"><a href="#cb680-16" aria-hidden="true" tabindex="-1"></a>---</span>
-<span id="cb680-17"><a href="#cb680-17" aria-hidden="true" tabindex="-1"></a>name: Jane Doe</span>
-<span id="cb680-18"><a href="#cb680-18" aria-hidden="true" tabindex="-1"></a>age: 99</span>
-<span id="cb680-19"><a href="#cb680-19" aria-hidden="true" tabindex="-1"></a>---</span>
-<span id="cb680-20"><a href="#cb680-20" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
-<span id="cb680-21"><a href="#cb680-21" aria-hidden="true" tabindex="-1"></a></span>
-<span id="cb680-22"><a href="#cb680-22" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
-<p>Next, invoke LuaTeX from the terminal:</p>
-<div class="sourceCode" id="cb681"><pre
-class="sourceCode sh"><code class="sourceCode bash"><span id="cb681-1"><a href="#cb681-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
+<div class="sourceCode" id="cb683"><pre
+class="sourceCode tex"><code class="sourceCode latex"><span id="cb683-1"><a href="#cb683-1" aria-hidden="true" tabindex="-1"></a><span class="fu">\usemodule</span>[t][markdown]</span>
+<span id="cb683-2"><a href="#cb683-2" aria-hidden="true" tabindex="-1"></a><span class="fu">\setupmarkdown</span>[jekyllData = yes]</span>
+<span id="cb683-3"><a href="#cb683-3" aria-hidden="true" tabindex="-1"></a><span class="fu">\ExplSyntaxOn</span></span>
+<span id="cb683-4"><a href="#cb683-4" aria-hidden="true" tabindex="-1"></a><span class="fu">\keys</span>_define:nn</span>
+<span id="cb683-5"><a href="#cb683-5" aria-hidden="true" tabindex="-1"></a> { markdown/jekyllData }</span>
+<span id="cb683-6"><a href="#cb683-6" aria-hidden="true" tabindex="-1"></a> {</span>
+<span id="cb683-7"><a href="#cb683-7" aria-hidden="true" tabindex="-1"></a> name .code:n = { <span class="fu">\gdef\name</span>{#1} },</span>
+<span id="cb683-8"><a href="#cb683-8" aria-hidden="true" tabindex="-1"></a> age .code:n = { <span class="fu">\gdef\age</span>{#1} },</span>
+<span id="cb683-9"><a href="#cb683-9" aria-hidden="true" tabindex="-1"></a> }</span>
+<span id="cb683-10"><a href="#cb683-10" aria-hidden="true" tabindex="-1"></a><span class="fu">\ExplSyntaxOff</span></span>
+<span id="cb683-11"><a href="#cb683-11" aria-hidden="true" tabindex="-1"></a><span class="fu">\def\markdownRendererJekyllDataEnd</span>{<span class="co">%</span></span>
+<span id="cb683-12"><a href="#cb683-12" aria-hidden="true" tabindex="-1"></a> <span class="fu">\name</span>{} is <span class="fu">\age</span>{} years old.}</span>
+<span id="cb683-13"><a href="#cb683-13" aria-hidden="true" tabindex="-1"></a><span class="fu">\starttext</span></span>
+<span id="cb683-14"><a href="#cb683-14" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb683-15"><a href="#cb683-15" aria-hidden="true" tabindex="-1"></a><span class="fu">\startmarkdown</span></span>
+<span id="cb683-16"><a href="#cb683-16" aria-hidden="true" tabindex="-1"></a>---</span>
+<span id="cb683-17"><a href="#cb683-17" aria-hidden="true" tabindex="-1"></a>name: Jane Doe</span>
+<span id="cb683-18"><a href="#cb683-18" aria-hidden="true" tabindex="-1"></a>age: 99</span>
+<span id="cb683-19"><a href="#cb683-19" aria-hidden="true" tabindex="-1"></a>---</span>
+<span id="cb683-20"><a href="#cb683-20" aria-hidden="true" tabindex="-1"></a><span class="fu">\stopmarkdown</span></span>
+<span id="cb683-21"><a href="#cb683-21" aria-hidden="true" tabindex="-1"></a></span>
+<span id="cb683-22"><a href="#cb683-22" aria-hidden="true" tabindex="-1"></a><span class="fu">\stoptext</span></span></code></pre></div>
+<p>Next, invoke LuaTeX from the terminal:</p>
+<div class="sourceCode" id="cb684"><pre
+class="sourceCode sh"><code class="sourceCode bash"><span id="cb684-1"><a href="#cb684-1" aria-hidden="true" tabindex="-1"></a><span class="ex">context</span> <span class="at">--luatex</span> document.tex</span></code></pre></div>
<p>A PDF document named <code>document.pdf</code> should be produced and
contain the following text:</p>
<blockquote>
diff --git a/macros/generic/markdown/markdown.ins b/macros/generic/markdown/markdown.ins
index 4261ddfdd4..c0ee2662d5 100644
--- a/macros/generic/markdown/markdown.ins
+++ b/macros/generic/markdown/markdown.ins
@@ -2,8 +2,11 @@
\generate{
\usepreamble\luapreamble
\usepostamble\luapostamble
- \file{markdown.lua}{\from{markdown.dtx}{lua}}
+ \file{markdown.lua}{\from{markdown.dtx}{lua-loader}}
+ \file{markdown-parser.lua}{\from{markdown.dtx}{lua}}
\file{markdown-cli.lua}{\from{markdown.dtx}{lua-cli}}
+ \file{markdown-unicode-data-generator.lua}{\from{markdown.dtx}{lua-unicode-data-generator}}
+ \file{markdown-unicode-data.lua}{\from{markdown.dtx}{lua-unicode-data}}
\usepreamble\texpreamble
\usepostamble\texpostamble
\file{markdown.tex}{\from{markdown.dtx}{tex}}
@@ -14,7 +17,7 @@
\file{markdownthemewitiko_tilde.tex}{\from{markdown.dtx}{themes-witiko-tilde}}
\file{markdownthemewitiko_markdown_defaults.tex}{\from{markdown.dtx}{themes-witiko-markdown-defaults-tex}}
\file{markdownthemewitiko_markdown_defaults.sty}{\from{markdown.dtx}{themes-witiko-markdown-defaults-latex}}
- \file{t-markdownthemewitiko_markdown_defaults.tex}{\from{markdown.dtx}{themes-witiko-markdown-defaults-context}}
+ \file{t-markdownthemewitiko_markdown_defaults.tex}{\from{markdown.dtx}{themes-witiko-markdown-defaults-ctx}}
\file{markdownthemewitiko_markdown_techdoc.sty}{\from{markdown.dtx}{themes-witiko-markdown-techdoc}}
\usepreamble\empty
\usepostamble\empty
@@ -25,6 +28,6 @@
\file{markdown.css}{\from{markdown.dtx}{manual-css}}
\file{markdown-figure-block-diagram.tex}{\from{markdown.dtx}{techdoc-block-diagram}}
\file{markdown.bib}{\from{markdown.dtx}{techdoc-bibliography}}
- \file{DEPENDS.txt}{\from{markdown.dtx}{depends}}
+ \file{DEPENDS-raw.txt}{\from{markdown.dtx}{depends}}
}
\endbatchfile
diff --git a/macros/generic/markdown/markdown.pdf b/macros/generic/markdown/markdown.pdf
index 3787cdbe80..bf3807990a 100644
--- a/macros/generic/markdown/markdown.pdf
+++ b/macros/generic/markdown/markdown.pdf
Binary files differ
diff --git a/macros/generic/witharrows/witharrows-french.pdf b/macros/generic/witharrows/witharrows-french.pdf
index 9b545653f4..407fbfa8f6 100644
--- a/macros/generic/witharrows/witharrows-french.pdf
+++ b/macros/generic/witharrows/witharrows-french.pdf
Binary files differ
diff --git a/macros/generic/witharrows/witharrows-french.tex b/macros/generic/witharrows/witharrows-french.tex
index 12837ba201..6fff445104 100644
--- a/macros/generic/witharrows/witharrows-french.tex
+++ b/macros/generic/witharrows/witharrows-french.tex
@@ -34,11 +34,57 @@
\titlespacing*{\subsection}{0pt}{4.5ex plus 1ex minus .2ex}{2ex plus .2ex}
+\NewDocumentCommand{\Definition}{m}
+ {{\setlength{\fboxsep}{1pt}\colorbox{gray!20}{\ttfamily \vphantom{gl}#1}}}
+
+\NewDocumentCommand{\DefinitionCommande}{m}
+ {{\setlength{\fboxsep}{1pt}\colorbox{gray!20}{\ttfamily
+ \vphantom{gl}\textbackslash #1}}}
+
+
\labelformat{equation}{(#1)}
\def\interitem{\vspace{7mm plus 2 mm minus 3mm}}
\def\emphase{\bgroup\color{RoyalPurple}\let\next=}
+
+
+\usepackage{piton}
+\PitonOptions{language = verbatim, detected-commands = {emph,textsl}, splittable = 4}
+\SetPitonStyle{ Number = , Comment = }
+
+\ExplSyntaxOn
+
+\dim_new:N \l__pantigny_width_dim
+
+\keys_define:nn { pantigny }
+ { width .dim_set:N = \l__pantigny_width_dim }
+
+\NewPitonEnvironment { Code } { O { } }
+ {
+ \medskip
+ \char_set_catcode_other:N |
+ \cs_set_eq:NN \emph \emphase
+ \dim_zero:N \l__pantigny_width_dim
+ \keys_set:nn { pantigny } { #1 }
+ \color{gray}
+ \dim_compare:nNnT \l__pantigny_width_dim > \c_zero_dim
+ {
+ \PitonOptions { width = \l__pantigny_width_dim }
+ \begin{minipage}[c]{\l__pantigny_width_dim}
+ }
+ }
+ {
+ \dim_compare:nNnT \l__pantigny_width_dim > \c_zero_dim
+ { \end{minipage} }
+ \medskip
+ }
+
+\ExplSyntaxOff
+
+
+
+
\skip \footins = 2 \bigskipamount
\usepackage[hyperfootnotes = false]{hyperref}
@@ -73,44 +119,48 @@ version~\myfileversion\space de \pkg{witharrows}, à la date du~\myfiledate.}}
\begin{abstract}
-L'extension \pkg{witharrows} fournit des environments |{WithArrows}| et
-|{DispWithArrows}| similaires aux environnements |{aligned}| et |{align}| de
-l'\pkg{amsmath} mais avec la possibilité de dessiner des flèches sur le côté droit.
-Ces flèches sont habituellement utilisées pour donner des explications concernant
-le calcul mathématique présenté.
+L'extension \pkg{witharrows} fournit des environments |{WithArrows}| et |{DispWithArrows}|
+similaires aux environnements |{aligned}| et |{align}| de l'extension \pkg{amsmath} mais
+avec la possibilité de dessiner des flèches sur le côté droit. Ces flèches sont
+habituellement utilisées pour donner des explications concernant le calcul mathématique
+présenté.
\end{abstract}
-\vspace{1cm}
-L'extension LaTeX \pkg{witharrows} est entièrement contenue dans le fichier |witharrows.sty|. Ce
-fichier peut être placé dans le répertoire courant ou dans une arborescence |texmf|. Le mieux reste néanmoins
-d'installer \pkg{witharrows} avec une distribution TeX comme MiKTeX, TeX~Live ou MacTeX.
+\vspace{1cm} L'extension LaTeX \pkg{witharrows} est entièrement contenue dans le fichier
+|witharrows.sty|. Ce fichier peut être placé dans le répertoire courant ou dans une
+arborescence |texmf|. Le mieux reste néanmoins d'installer \pkg{witharrows} avec une
+distribution TeX comme MiKTeX, TeX~Live ou MacTeX.
\medskip
-En fait, \pkg{witharrows} est aussi une extension utilisable avec plain-TeX et dans ce cas, le seul fichier
-nécessaire est le fichier |witharrows.tex| : voir à ce sujet p.~\pageref{plain-TeX}. Dans la suite, on décrira
-l'extension LaTeX.
+En fait, \pkg{witharrows} est aussi une extension utilisable avec plain-TeX et dans ce
+cas, le seul fichier nécessaire est le fichier |witharrows.tex| : voir à ce sujet
+p.~\pageref{plain-TeX}. Dans la suite, on décrira l'extension LaTeX.
\medskip
-Cette extension peut être utilisée avec |xelatex|, |lualatex|, |pdflatex| mais aussi avec le cheminement classique
-|latex|-|dvips|-|ps2pdf| (ou Adobe Distiller). L'extension \pkg{witharrows} charge les extensions \pkg{l3keys2e},
-\pkg{tikz}, \pkg{varwidth} ainsi que les bibliothèques Tikz \pkg{arrows.meta} et \pkg{bending}. L'utilisateur final n'a qu'à charger l'extension \pkg{witharrows} avec
-l'instruction habituelle : |\usepackage{witharrows}|.
+Cette extension peut être utilisée avec |xelatex|, |lualatex|, |pdflatex| mais aussi avec
+le cheminement classique |latex|-|dvips|-|ps2pdf| (ou Adobe Distiller). \textsl{Néanmoins,
+ le fichier witharrows-french.tex de la présente documentation ne peut être compilé
+ qu'avec LuaLaTeX.} L'extension \pkg{witharrows} charge les extensions \pkg{l3keys2e},
+\pkg{tikz}, \pkg{varwidth} ainsi que les bibliothèques Tikz \pkg{arrows.meta} et
+\pkg{bending}. L'utilisateur final n'a qu'à charger l'extension \pkg{witharrows} avec
+l'instruction habituelle : |\usepackage{witharrows}|.
\medskip
-Les flèches sont tracées avec Tikz et donc \textbf{plusieurs compilations peuvent être nécessaires}.\footnote{Si
- vous utilisez Overleaf, Overleaf effectue automatiquement un nombre de compilations suffisant (en utilisant |latexmk|).}
+Les flèches sont tracées avec Tikz et donc \textbf{plusieurs compilations peuvent être
+ nécessaires}.\footnote{Si vous utilisez Overleaf, Overleaf effectue automatiquement un
+ nombre de compilations suffisant (en utilisant |latexmk|).}
\bigskip
-Cette extension fournit un environnement |{WithArrows}| pour construire des alignements d'équations
-avec des flèches pour les explications sur le côté droit.
+Cette extension fournit un environnement \Definition{\{WithArrows\}} pour construire des
+alignements d'équations avec des flèches pour les explications sur le côté droit.
-\begin{Verbatim}
+\begin{Code}
$\begin{WithArrows}
-A & = (a+1)^2 ~emphase#\Arrow{on développe}@ \\
+A & = (a+1)^2 \emph{\Arrow{on développe}} \\
& = a^2 + 2a + 1 % <------ ne pas mettre de \\ ici
\end{WithArrows}$
-\end{Verbatim}
+\end{Code}
$\begin{WithArrows}
A & = (a+1)^2 \Arrow{on développe} \\
@@ -120,34 +170,37 @@ A & = (a+1)^2 \Arrow{on développe} \\
\medskip
-La flèche a été tracée avec la commande |\Arrow| dans la rangée dont la flèche part. La commande |\Arrow|
-doit être utilisée dans la seconde colonne (le mieux est de la mettre à la fin de la ligne comme dans l'exemple
-précédent).
+La flèche a été tracée avec la commande \DefinitionCommande{Arrow} dans la rangée dont la
+flèche part. La commande |\Arrow| doit être utilisée dans la seconde colonne (le mieux est
+de la mettre à la fin de la ligne comme dans l'exemple précédent).
\medskip
-Comme on le voit, l'environnement |{WithArrows}| est proche de l'environnement |{aligned}| de l'\pkg{amsmath}.
-L'extension \pkg{witharrows} propose aussi un environnement |{DispWithArrows}| qui est similaire à l'environnement
-|{align}| de l'\pkg{amsmath}: cf. p. \pageref{DispWithArrows}.
+L'environnement |{WithArrows}| est proche de l'environnement |{aligned}|
+de \pkg{amsmath}. L'extension \pkg{witharrows} propose aussi des environnements
+|{DispWithArrows}| et |{DispWithArrows*}| qui sont similaires aux environnements |{align}|
+et |{align*}| de l'extension \pkg{amsmath}: cf. p.~\pageref{DispWithArrows}.
\section{Options pour la forme des flèches}
-La commande |\Arrow| a plusieurs options. Ces options peuvent être placées entre crochets, avant, ou après,
-l'argument obligatoire.
+La commande |\Arrow| a plusieurs options. Ces options peuvent être placées entre crochets,
+avant, ou après, l'argument obligatoire.
-L'option |jump| indique le nombre\footnote{Il n'est pas possible de donner une valeur négative à |jump|.
-Voir plus loin (p.~\pageref{Backwards}) la manière de tracer une flèche qui remonte.} de rangées que la flèche doit sauter (la valeur initiale est, bien
-entendu,~$1$).
+\medskip
+L'option \Definition{jump} indique le nombre\footnote{Il n'est pas possible de donner une
+ valeur négative à |jump|. Voir plus loin (p.~\pageref{Backwards}) la manière de tracer
+ une flèche qui remonte.} de rangées que la flèche doit sauter (la valeur initiale est,
+bien entendu,~$1$).
-\begin{Verbatim}
+\begin{Code}
$\begin{WithArrows}
-A & = \bigl((a+b)+1\bigr)^2 \Arrow[~emphase#jump=2@]{on développe} \\
+A & = \bigl((a+b)+1\bigr)^2 \Arrow[\emph{jump=2}]{on développe} \\
& = (a+b)^2 + 2(a+b) +1 \\
& = a^2 + 2ab + b^2 + 2a + 2b +1
\end{WithArrows}$
-\end{Verbatim}
+\end{Code}
$\begin{WithArrows}
A & = \bigl((a+b)+1\bigr)^2 \Arrow[jump=1+1]{on développe} \\
@@ -157,13 +210,13 @@ A & = \bigl((a+b)+1\bigr)^2 \Arrow[jump=1+1]{on développe} \\
\interitem
Il est possible de faire partir plusieurs flèches d'une même rangée.
-\begin{Verbatim}
+\begin{Code}
$\begin{WithArrows}
-A & = \bigl((a+b)+1\bigr)^2 ~emphase#\Arrow{}\Arrow{}[jump=2]@ \\
+A & = \bigl((a+b)+1\bigr)^2 \emph{\Arrow{}\Arrow{}[jump=2]} \\
& = (a+b)^2 + 2(a+b) +1 \\
& = a^2 + 2ab + b^2 + 2a + 2b +1
\end{WithArrows}$
-\end{Verbatim}
+\end{Code}
$\begin{WithArrows}
A & = \bigl((a+b)+1\bigr)^2 \Arrow{}\Arrow{}[jump=2] \\
@@ -171,16 +224,16 @@ A & = \bigl((a+b)+1\bigr)^2 \Arrow{}\Arrow{}[jump=2] \\
& = a^2 + 2ab + b^2 + 2a + 2b +1
\end{WithArrows}$
-\interitem
-L'option |xoffset| décale la flèche vers la droite (habituellement, on ne souhaite pas que les flèches soient
-collées au texte). La valeur initiale de |xoffset| est de $3$~mm.
-\begin{Verbatim}
+\interitem L'option \Definition{xoffset} décale la flèche vers la droite (habituellement,
+on ne souhaite pas que les flèches soient collées au texte). La valeur initiale de
+|xoffset| est de $3$~mm.
+\begin{Code}
$\begin{WithArrows}
A & = \bigl((a+b)+1\bigr)^2
-\Arrow[~emphase#xoffset=1cm@]{avec \texttt{xoffset=1cm}} \\
+\Arrow[\emph{xoffset=1cm}]{avec \texttt{xoffset=1cm}} \\
& = (a+b)^2 + 2(a+b) +1
\end{WithArrows}$
-\end{Verbatim}
+\end{Code}
$\begin{WithArrows}
A & = \bigl((a+b)+1\bigr)^2
@@ -190,45 +243,47 @@ A & = \bigl((a+b)+1\bigr)^2
\interitem
-Les flèches sont tracées avec Tikz. C'est pourquoi la commande |\Arrow| a une option
-|tikz| qui peut être utilisée pour donner à la flèche (en fait, à la commande |\path| de
-Tikz) les options proposées par Tikz pour une telle flèche. L'exemple suivant fournit une flèche en trait épais.
-\begin{Verbatim}
+Les flèches sont tracées avec Tikz. C'est pourquoi la commande |\Arrow| a une option
+\Definition{tikz} qui peut être utilisée pour donner à la flèche (en fait, à la commande
+|\path| de Tikz) les options proposées par Tikz pour une telle flèche. L'exemple suivant
+fournit une flèche en trait épais.
+\begin{Code}
$\begin{WithArrows}
-A & = (a+1)^2 \Arrow[~emphase#tikz=thick@]{on développe} \\
+A & = (a+1)^2 \Arrow[\emph{tikz=thick}]{on développe} \\
& = a^2 + 2a + 1
\end{WithArrows}$
-\end{Verbatim}
+\end{Code}
$\begin{WithArrows}
A & = (a+1)^2 \Arrow[tikz=thick]{on développe} \\
& = a^2 + 2a + 1
\end{WithArrows}$
-\interitem
-Il est également possible de changer les pointes de flèche. Par exemple, nous pouvons tracer une flèche
-qui remonte vers le haut avec l'option Tikz~|<-|.\label{Backwards}
+\interitem
+Il est également possible de changer les pointes de flèche. Par exemple, nous pouvons
+tracer une flèche qui remonte vers le haut avec l'option Tikz~|<-|.\label{Backwards}
-\begin{Verbatim}
+\begin{Code}
$\begin{WithArrows}
-A & = (a+1)^2 \Arrow~emphase#[tikz=<-]@{on factorise} \\
+A & = (a+1)^2 \Arrow\emph{[tikz=<-]}{on factorise} \\
& = a^2 + 2a + 1
\end{WithArrows}$
-\end{Verbatim}
+\end{Code}
$\begin{WithArrows}
A & = (a+1)^2 \Arrow[tikz=<-]{on factorise} \\
& = a^2 + 2a + 1
\end{WithArrows}$
-\interitem
-Il est aussi possible de supprimer les deux pointes de flèche avec l'option Tikz «|-|».\par\nobreak
-\begin{Verbatim}
+\interitem
+Il est aussi possible de supprimer les deux pointes de flèche avec l'option Tikz
+«|-|».\par\nobreak
+\begin{Code}
$\begin{WithArrows}
-A & = (a+1)^2 \Arrow[~emphase#tikz=-@]{très classique} \\
+A & = (a+1)^2 \Arrow[\emph{tikz=-}]{très classique} \\
& = a^2 + 2a + 1
\end{WithArrows}$
-\end{Verbatim}
+\end{Code}
$\begin{WithArrows}
A & = (a+1)^2 \Arrow[tikz=-]{très classique} \\
@@ -238,12 +293,12 @@ A & = (a+1)^2 \Arrow[tikz=-]{très classique} \\
\interitem
Pour avoir des flèches droites et non incurvées, il convient d'utiliser l'option Tikz
«|bend left = 0|».
-\begin{Verbatim}
+\begin{Code}
$\begin{WithArrows}
-A & = (a+1)^2 \Arrow~emphase#[tikz={bend left=0}]@{on développe} \\
+A & = (a+1)^2 \Arrow\emph{[tikz={bend left=0}]}{on développe} \\
& = a^2 + 2a + 1
\end{WithArrows}$
-\end{Verbatim}
+\end{Code}
$\begin{WithArrows}
A & = (a+1)^2 \Arrow[tikz={bend left=0}]{on développe} \\
@@ -251,28 +306,28 @@ A & = (a+1)^2 \Arrow[tikz={bend left=0}]{on développe} \\
\end{WithArrows}$
\smallskip
-En fait, il est possible de modifier de manière plus drastique la forme des flèches avec l'option
-|tikz-code| (présentée p.~\pageref{tikz-code}).
+En fait, il est possible de modifier de manière plus drastique la forme des flèches avec
+l'option |tikz-code| (présentée p.~\pageref{tikz-code}).
\interitem
-Il est possible d'utiliser l'option «|text width|» pour contrôler la largeur du texte associé à la
-flèche.
-\newcounter{fnnohyphen}
-\setcounter{fnnohyphen}{\thefootnote}
+Il est possible d'utiliser l'option «|text width|» pour contrôler la largeur du texte
+associé à la flèche.
+\newcounter{fnnohyphen} \setcounter{fnnohyphen}{\thefootnote}
%
-\begin{Verbatim}
+\begin{Code}
$\begin{WithArrows}
A & = \bigl((a+b)+1\bigr)^2
-\Arrow[jump=2,~emphase#tikz={text width=5.3cm}@]{Nous avons développé...} \\
+\Arrow[jump=2,\emph{tikz={text width=5.3cm}}]{Nous avons développé...} \\
& = (a+b)^2 + 2(a+b) +1 \\
& = a^2 + 2ab + b^2 + 2a + 2b +1
\end{WithArrows}$
-\end{Verbatim}
+\end{Code}
$\begin{WithArrows}
A & = \bigl((a+b)+1\bigr)^2
-\Arrow[jump=2,tikz={text width=5.3cm}]{Nous avons développé en deux étapes mais il aurait été plus habile
- d'utiliser la formule du multinôme.} \\
+\Arrow[jump=2,tikz={text width=5.3cm}]{Nous avons développé en deux étapes
+ mais il aurait été plus habile
+ d'utiliser la formule du multinôme.} \\
& = (a+b)^2 + 2(a+b) +1 \\
& = a^2 + 2ab + b^2 + 2a + 2b +1
\end{WithArrows}$
@@ -284,17 +339,18 @@ option |wrap-lines|. Lorsque cette option est utilisée, les lignes des étiquet
automatiquement coupées sur la marge droite : voir p.~\pageref{DispWithArrows}.
\interitem
-Si on veut changer la fonte du texte associé à une flèche, on peut, bien entendu, placer une commande comme
-|\bfseries|, |\large| ou |\sffamily| au début du texte. Mais, par défaut, les étiquettes sont composées avec une
-combinaison de |\small| et |\itshape|. En ajoutant |\bfseries| au début du texte, on ne va pas supprimer le
-|\small| et le |\itshape| et, par conséquent, on aura un texte en gras, italique et petite taille.
+Si on veut changer la fonte du texte associé à une flèche, on peut, bien entendu, placer
+une commande comme |\bfseries|, |\large| ou |\sffamily| au début du texte. Mais, par
+défaut, les étiquettes sont composées avec une combinaison de |\small| et |\itshape|. En
+ajoutant |\bfseries| au début du texte, on ne va pas supprimer le |\small| et le
+|\itshape| et, par conséquent, on aura un texte en gras, italique et petite taille.
%
-\begin{Verbatim}
+\begin{Code}
$\begin{WithArrows}
-A & = (a+1)^2 \Arrow{~emphase#\bfseries@ on développe} \\
+A & = (a+1)^2 \Arrow{\emph{\bfseries} on développe} \\
& = a^2 + 2a + 1
\end{WithArrows}$
-\end{Verbatim}
+\end{Code}
$\begin{WithArrows}
A & = (a+1)^2 \Arrow{\bfseries on développe} \\
@@ -307,16 +363,16 @@ défaut, ce n'est pas possible dans un nœud Tikz. Néanmoins, dans \pkg{witharr
les nœuds sont construits avec l'option |align=left|, et, ainsi, cela devient possible.}. Néanmoins, si on utilise des commandes |\\|, une instruction de fonte placée au début
du texte aura un effet seulement jusqu'à la première occurrence de~|\\| (comme
dans un environnement |{tabular}|). C'est pourquoi Tikz fournit une option
-|font| pour modifier la fonte de tout le texte de l'étiquette. Cette fois-ci, si on utilise une option
-|tikz={font={\bfseries}}|, la spécification par défaut constituée par |\small| et |\itshape| va être
-écrasée.
+\Definition{font} pour modifier la fonte de tout le texte de l'étiquette. Cette fois-ci, si on
+utilise une option |tikz={font={\bfseries}}|, la spécification par défaut constituée par
+|\small| et |\itshape| va être écrasée.
%
-\begin{Verbatim}
+\begin{Code}
$\begin{WithArrows}
-A & = (a+1)^2 \Arrow[~emphase#tikz={font={\bfseries}}@]{on développe} \\
+A & = (a+1)^2 \Arrow[\emph{tikz={font={\bfseries}}}]{on développe} \\
& = a^2 + 2a + 1
\end{WithArrows}$
-\end{Verbatim}
+\end{Code}
$\begin{WithArrows}
A & = (a+1)^2 \Arrow[tikz={font={\bfseries}}]{on développe} \\
@@ -324,24 +380,25 @@ A & = (a+1)^2 \Arrow[tikz={font={\bfseries}}]{on développe} \\
\end{WithArrows}$
\medskip
-Si on veut exactement le même résultat que précédemment, on doit donner à l'option |font| la valeur
-|\itshape\small\bfseries|.
+Si on veut exactement le même résultat que précédemment, on doit donner à l'option |font|
+la valeur |\itshape\small\bfseries|.
\interitem
-Presque toutes les options peuvent être données entre crochets à l'environnement |{WithArrows}|. Il ne doit
-pas y avoir d'espace entre le |\begin{WithArrows}| et le crochet ouvrant (|[|) des options de
-l'environnement. Ces options s'appliquent à toutes les flèches de l'environnement.\footnote{Elles s'appliquent
- aussi aux environnements imbriqués dans un environnement |{WithArrows}| donné (avec des exceptions attendues
- pour les options |interline|, |code-before| et |code-after|).}
+Presque toutes les options peuvent être données entre crochets à l'environnement
+|{WithArrows}|. Il ne doit pas y avoir d'espace entre le |\begin{WithArrows}| et le
+crochet ouvrant (|[|) des options de l'environnement. Ces options s'appliquent à toutes
+les flèches de l'environnement.\footnote{Elles s'appliquent aussi aux environnements
+ imbriqués dans un environnement |{WithArrows}| donné (avec des exceptions attendues pour
+ les options |interline|, |code-before| et |code-after|).}
%
-\begin{Verbatim}
-$\begin{WithArrows}[~emphase#tikz=blue@]
+\begin{Code}
+$\begin{WithArrows}[\emph{tikz=blue}]
A & = \bigl((a+b)+1\bigr)^2 \Arrow{premier développement} \\
& = (a+b)^2 + 2(a+b) +1 \Arrow{second développement} \\
& = a^2 + 2ab + b^2 + 2a + 2b +1
\end{WithArrows}$
-\end{Verbatim}
+\end{Code}
$\begin{WithArrows}[tikz=blue]
A & = \bigl((a+b)+1\bigr)^2 \Arrow{premier développement} \\
@@ -351,8 +408,9 @@ A & = \bigl((a+b)+1\bigr)^2 \Arrow{premier développement} \\
\interitem
-L'environnement |{WithArrows}| a une option |displaystyle|. Avec cette option, tous les éléments sont composés en
-|\displaystyle| (comme dans un environnement |{aligned}| de l'\pkg{amsmath}).
+L'environnement |{WithArrows}| a une option \Definition{displaystyle}. Avec cette option,
+tous les éléments sont composés en |\displaystyle| (comme dans un environnement
+|{aligned}| de l'extension \pkg{amsmath}).
\medskip
Sans l'option |displaystyle|:
@@ -363,8 +421,8 @@ $\begin{WithArrows}
& = \int_0^1 (x^2+2x+1) dx
\Arrow{linéarité de l'intégration} \\
& = \int_0^1 x^2 dx + 2 \int_0^1 x dx + \int_0^1 dx \\
-& = \frac13 + 2\frac12 + 1 \\
-& = \frac73
+& = \frac{1}{3} + 2\frac{1}{2} + 1 \\
+& = \frac{7}{3}
\end{WithArrows}$
\end{Verbatim}
@@ -373,8 +431,8 @@ $\begin{WithArrows}
& = \int_0^1 (x^2+2x+1) dx
\Arrow{linéarité de l'intégration} \\
& = \int_0^1 x^2 dx + 2 \int_0^1 x dx + \int_0^1 dx \\
-& = \frac13 + 2\frac12 + 1 \\
-& = \frac73
+& = \frac{1}{3} + 2\frac{1}{2} + 1 \\
+& = \frac{7}{3}
\end{WithArrows}$
@@ -386,30 +444,32 @@ $\begin{WithArrows}[displaystyle]
& = \int_0^1 (x^2+2x+1) dx
\Arrow{linéarité de l'intégration} \\
& = \int_0^1 x^2 dx + 2 \int_0^1 x dx + \int_0^1 dx \\
-& = \frac13 + 2\frac12 + 1 \\
-& = \frac73
+& = \frac{1}{3} + 2\frac{1}{2} + 1 \\
+& = \frac{7}{3}
\end{WithArrows}$
\interitem
-Presque toutes les options peuvent aussi être fixées au niveau du document avec la commande |\WithArrowsOptions|.
-Dans ce cas, la portée des déclarations est le groupe TeX courant (de telles déclarations sont parfois qualifiées
-de «semi-globales»). Par exemple, si nous voulons que tous les environnements |{WithArrows}| soient composés en
-|\displaystyle| avec des flèches bleues, nous pouvons écrire
-|\WithArrowsOptions{displaystyle,tikz=blue}|.\footnote{Il est aussi possible de configurer \pkg{witharrows} en
- modifiant le style Tikz |WithArrows/arrow| qui est le style utilisé par \pkg{witharrows} lors du tracé d'une
- flèche. Par exemple, pour avoir les étiquettes en bleu et en caractères droits, on peut utiliser l'instruction
- suivante : |\tikzset{WithArrows/arrow/.append style = {blue,font = {}}}|.}
-
-\begin{Verbatim}
-~emphase#\WithArrowsOptions{displaystyle,tikz=blue}@
+Presque toutes les options peuvent aussi être fixées au niveau du document avec la
+commande \DefinitionCommande{WithArrowsOptions}. Dans ce cas, la portée des déclarations
+est le groupe TeX courant (de telles déclarations sont parfois qualifiées de
+«semi-globales»). Par exemple, si nous voulons que tous les environnements |{WithArrows}|
+soient composés en |\displaystyle| avec des flèches bleues, nous pouvons écrire
+|\WithArrowsOptions{displaystyle,tikz=blue}|.\footnote{Il est aussi possible de configurer
+ \pkg{witharrows} en modifiant le style Tikz |WithArrows/arrow| qui est le style utilisé
+ par \pkg{witharrows} lors du tracé d'une flèche. Par exemple, pour avoir les étiquettes
+ en bleu et en caractères droits, on peut utiliser l'instruction suivante :
+ |\tikzset{WithArrows/arrow/.append style = {blue,font = {}}}|.}
+
+\begin{Code}
+\emph{\WithArrowsOptions{displaystyle,tikz=blue}}
$\begin{WithArrows}
\sum_{i=1}^n (x_i+1)^2
& = \sum_{i=1}^n (x_i^2+2x_i+1) \Arrow{par linéarité}\\
& = \sum_{i=1}^n x_i^2 + 2\sum_{i=1}^nx_i+ n
\end{WithArrows}$
-\end{Verbatim}
+\end{Code}
\begin{scope}
\WithArrowsOptions{displaystyle,tikz=blue}
@@ -422,23 +482,24 @@ $\begin{WithArrows}
\interitem
-La commande |\Arrow| est reconnue seulement dans les environnements de \pkg{witharrows}. Si on dispose d'une
-commande |\Arrow| précédemment définie, il est possible de continuer à l'utiliser à l'extérieur des environnements
-de \pkg{witharrows}.
-
-Néanmoins, une commande |\Arrow| définie précédemment pourrait encore être utile dans un environnement
-|{WithArrows}|. Si vous voulez l'utiliser dans un tel environnement, il est possible de changer le nom de la
-commande |\Arrow| de l'extension \pkg{witharrows} grâce à une option |command-name| dédiée. Le nouveau nom de la
-commande doit être fourni à l'option \emph{sans} la contre-oblique.
+La commande |\Arrow| est reconnue seulement dans les environnements de \pkg{witharrows}.
+Si on dispose d'une commande |\Arrow| précédemment définie, il est possible de continuer à
+l'utiliser à l'extérieur des environnements de \pkg{witharrows}.
+
+Néanmoins, une commande |\Arrow| définie précédemment pourrait encore être utile dans un
+environnement |{WithArrows}|. Si vous voulez l'utiliser dans un tel environnement, il est
+possible de changer le nom de la commande |\Arrow| de l'extension \pkg{witharrows} grâce à
+une option \Definition{command-name} dédiée. Le nouveau nom de la commande doit être
+fourni à l'option \emph{sans} la contre-oblique.
%
-\begin{Verbatim}
+\begin{Code}
\NewDocumentCommand {\Arrow} {} {\longmapsto}
$\begin{WithArrows}[~emphase#command-name=Explication@]
f & = \bigl(x \Arrow (x+1)^2\bigr)
-~emphase#\Explication{on travaille directement sur les fonctions}@\\
+\emph{\Explication{on travaille directement sur les fonctions}}\\
& = \bigl(x \Arrow x^2+2x+1\bigr)
\end{WithArrows}$
-\end{Verbatim}
+\end{Code}
%
\begin{scope}
\NewDocumentCommand {\Arrow} {} {\longmapsto}
@@ -451,17 +512,18 @@ f & = \bigl(x \Arrow (x+1)^2\bigr)
\interitem
-L'environnement |{WithArrows}| fournit aussi deux options |code-before| et |code-after| pour du code LaTeX qui sera
-exécuté au début et à la fin de l'environnement. Ces options ne sont pas conçues pour être utilisées comme des
-\emph{hooks} (elles sont disponibles uniquement au niveau de l'environnement et ne s'appliquent pas aux
-environnements imbriqués).
+L'environnement |{WithArrows}| fournit aussi deux options \Definition{code-before} et
+\Definition{code-after} pour du code LaTeX qui sera exécuté au début et à la fin de
+l'environnement. Ces options ne sont pas conçues pour être utilisées comme des
+\emph{hooks} (elles sont disponibles uniquement au niveau de l'environnement et ne
+s'appliquent pas aux environnements imbriqués).
%
-\begin{Verbatim}
-$\begin{WithArrows}[~emphase#code-before = \color{blue}@]
+\begin{Code}
+$\begin{WithArrows}[\emph{code-before = \color{blue}}]
A & = (a+b)^2 \Arrow{on développe} \\
& = a^2 + 2ab + b^2
\end{WithArrows}$
-\end{Verbatim}
+\end{Code}
$\begin{WithArrows}[code-before = \color{blue}]
A & = (a+b)^2 \Arrow{on développe} \\
@@ -469,35 +531,39 @@ A & = (a+b)^2 \Arrow{on développe} \\
\end{WithArrows}$
\medskip
-Des commandes spéciales sont disponibles dans le |code-after| : une commande |\WithArrowsNbLines| qui indique le
-nombre de lignes (=rangées) de l'environnement courant (pour TeX, il s'agit d'une commande et non d'un compteur),
-une forme spéciale de la commande |\Arrow| et la commande |\MultiArrow| : ces commandes sont décrites à partir de
-la page~\pageref{NestedEnv}.
+Des commandes spéciales sont disponibles dans le |code-after|: une commande
+\DefinitionCommande{WithArrowsNbLines} qui indique le nombre de lignes (=rangées) de
+l'environnement courant (pour TeX, il s'agit d'une commande et non d'un compteur), une
+forme spéciale de la commande |\Arrow| et la commande |\MultiArrow| : ces deux dernières
+commandes sont décrites à partir de la page~\pageref{NestedEnv}.
\section{Nombre et formats des colonnes}
-Jusqu'à présent, nous n'avons utilisé l'environnement |{WithArrows}| qu'avec deux colonnes. Néanmoins, il est
-possible de l'utiliser avec un nombre arbitraire de colonnes grâce à l'option |format|. La valeur donnée à cette
-option est similaire au préambule d'un environnement |{array}|: il s'agit d'une séquence de lettres |r|, |c| et
+Jusqu'à présent, nous n'avons utilisé l'environnement |{WithArrows}| qu'avec deux
+colonnes. Néanmoins, il est possible de l'utiliser avec un nombre arbitraire de colonnes
+grâce à l'option \Definition{format}. La valeur donnée à cette option est similaire au
+préambule d'un environnement |{array}|: il s'agit d'une séquence de lettres |r|, |c| et
|l| mais aussi |R|, |C| et |L|.
\smallskip
-Les lettres |R|, |C| et |L| placent des groupes vides |{}| qui permettent un espacement correct lorsque ces
-colonnes contiennent des symboles de type |\mathrel| (comme $=$, $\le$, etc.) ou |\mathbin| (comme $+$, $×$, etc.).
-Ce système est inspiré par l'environnement |{IEEEeqnarray}| de \pkg{IEEEtrantools}.
+Les lettres |R|, |C| et |L| placent des groupes vides |{}| qui permettent un espacement
+correct lorsque ces colonnes contiennent des symboles de type |\mathrel| (comme $=$,
+$\le$, etc.) ou |\mathbin| (comme $+$, $×$, etc.). Ce système est inspiré par
+l'environnement |{IEEEeqnarray}| de \pkg{IEEEtrantools}.
\smallskip
La valeur initiale du paramètre |format| est, en fait, |rL|.
\bigskip
-Par exemple, si on veut seulement une colonne alignée à gauche, on peut utiliser l'option |format=l|.
-\begin{Verbatim}
-$\begin{WithArrows}[~emphase#format = l@]
+Par exemple, si on veut seulement une colonne alignée à gauche, on peut utiliser l'option
+|format=l|.
+\begin{Code}
+$\begin{WithArrows}[\emph{format = l}]
f(x) \ge g(x) \Arrow{on élève les deux membres au carré} \\
f(x)^2 \ge g(x)^2 \Arrow{on fait tout passer à gauche} \\
f(x)^2 - g(x)^2 \ge 0
\end{WithArrows}$
-\end{Verbatim}
+\end{Code}
$\begin{WithArrows}[format = l]
f(x) \ge g(x) \Arrow{on élève les deux membres au carré} \\
@@ -506,11 +572,11 @@ f(x)^2 - g(x)^2 \ge 0
\end{WithArrows}$
\interitem
-Dans l'exemple suivant, on utilise cinq colonnes toutes centrées (l'environnement |{DispWithArrows*}| utilisé est
-présenté p.~\pageref{DispWithArrows}).
+Dans l'exemple suivant, on utilise cinq colonnes toutes centrées (l'environnement
+|{DispWithArrows*}| utilisé est présenté p.~\pageref{DispWithArrows}).
-\begin{Verbatim}
-\begin{DispWithArrows*}[~emphase#format = cCcCc@,
+\begin{Code}
+\begin{DispWithArrows*}[\emph{format = cCcCc},
wrap-lines,
interline=1mm]
k & \;\le\; & t & \;\le\; & k+1 \\
@@ -521,7 +587,7 @@ k & \;\le\; & t & \;\le\; & k+1 \\
& \le & \int\limits_k^{k+1} \frac{dt}{k} \\
\frac{1}{k+1} & \le & \ln(k+1)-\ln(k) & \le & \frac{1}{k}
\end{DispWithArrows*}
-\end{Verbatim}
+\end{Code}
\begin{DispWithArrows*}[format = cCcCc,
wrap-lines,
interline=1mm]
@@ -537,73 +603,76 @@ k & \;\le\; & t & \;\le\; & k+1 \\
\section{Positionnement précis des flèches}
-L'environnement |{WithArrows}| construit, lors de la composition du tableau, deux séries de nœuds représentés en
-rouge dans l'exemple suivant.\footnote{L'option |show-nodes| peut être utilisée pour visualiser ces nœuds. Les
- nœuds sont en fait des nœuds Tikz de forme rectangulaire et de largeur nulle. Une flèche entre deux nœuds part de
- l'ancre sud (\emph{south anchor}) du premier nœud et arrive à l'ancre nord (\emph{north anchor}) du deuxième
- nœud.}
+L'environnement |{WithArrows}| construit, lors de la composition du tableau, deux séries
+de nœuds représentés en rouge dans l'exemple suivant.\footnote{L'option
+ \Definition{show-nodes} peut être utilisée pour visualiser ces nœuds. Les nœuds sont en
+ fait des nœuds Tikz de forme rectangulaire et de largeur nulle. Une flèche entre deux
+ nœuds part de l'ancre sud (\emph{south anchor}) du premier nœud et arrive à l'ancre nord
+ (\emph{north anchor}) du deuxième nœud.}
\smallskip
$\begin{WithArrows}[displaystyle,show-nodes]
I
-& = \int_{\frac{\pi}4}^0 \ln\Bigl(1+\tan\left(\tfrac{\pi}4-u\right)\Bigr)(-d u) \\
-& = \int_0^{\frac{\pi}4} \ln\Bigl(1+\tan\left(\tfrac{\pi}4-u\right)\Bigr)d u \\
-& = \int_0^{\frac{\pi}4}\ln\left(1+\frac{1-\tan u}{1+\tan u}\right)\, d u \\
-& =\int_0^{\frac{\pi}4}\ln\left(\frac{1+\tan u+1-\tan u}{1+\tan u}\right) d u \\
-& =\int_0^{\frac{\pi}4} \ln\left(\frac2{1+\tan u}\right)\, d u\\
-& =\int_0^{\frac{\pi}4}\bigl(\ln2-\ln(1+\tan u)\bigr)\, d u \\
-& =\frac{\pi}4\ln2-\int_0^{\frac{\pi}4}\ln(1+\tan u)\, d u \\
-& =\frac{\pi}4\ln2-I
+& = \int_{\frac{\pi}{4}}^0 \ln\Bigl(1+\tan\left(\tfrac{\pi}{4}-u\right)\Bigr)(-d u) \\
+& = \int_0^{\frac{\pi}{4}} \ln\Bigl(1+\tan\left(\tfrac{\pi}{4}-u\right)\Bigr)d u \\
+& = \int_0^{\frac{\pi}{4}}\ln\left(1+\frac{1-\tan u}{1+\tan u}\right)\, d u \\
+& =\int_0^{\frac{\pi}{4}}\ln\left(\frac{1+\tan u+1-\tan u}{1+\tan u}\right) d u \\
+& =\int_0^{\frac{\pi}{4}} \ln\left(\frac{2}{1+\tan u}\right)\, d u\\
+& =\int_0^{\frac{\pi}{4}}\bigl(\ln2-\ln(1+\tan u)\bigr)\, d u \\
+& =\frac{\pi}{4}\ln2-\int_0^{\frac{\pi}{4}}\ln(1+\tan u)\, d u \\
+& =\frac{\pi}{4}\ln2-I
\end{WithArrows}$
\bigskip
-Les nœuds sur la gauche sont à la fin de chaque ligne de texte. Ces nœuds seront appelés \emph{nœuds de gauche}. Les
-nœuds du côté droit sont alignés verticalement sur le bord droit de l'alignement d'équations. Ces nœuds seront
-appelés \emph{nœuds de droite}.
+Les nœuds sur la gauche sont à la fin de chaque ligne de texte. Ces nœuds seront appelés
+\emph{nœuds de gauche}. Les nœuds du côté droit sont alignés verticalement sur le bord
+droit de l'alignement d'équations. Ces nœuds seront appelés \emph{nœuds de droite}.
-Par défaut, les flèches utilisent les nœuds de droite. Nous dirons que ces flèches sont dans le mode |rr| (\emph{r}
-for \emph{right} en anglais). Ces flèches sont verticales (nous dirons qu'une flèche est \emph{verticale} lorsque
-ses deux extrémités sont à la même abscisse).
+Par défaut, les flèches utilisent les nœuds de droite. Nous dirons que ces flèches sont
+dans le mode \Definition{rr} (\emph{r} for \emph{right} en anglais). Ces flèches sont
+verticales (nous dirons qu'une flèche est \emph{verticale} lorsque ses deux extrémités
+sont à la même abscisse).
\smallskip
-Néanmoins, il est possible d'utiliser les nœuds de gauche, ou une combinaison de nœuds de gauche et de droite avec
-l'une des options |lr|, |rl| et |ll| (\emph{l} for \emph{left} en anglais). Ces flèches sont, la plupart du temps,
-non verticales.
+Néanmoins, il est possible d'utiliser les nœuds de gauche, ou une combinaison de nœuds de
+gauche et de droite avec l'une des options \Definition{lr}, \Definition{rl} et
+\Definition{ll} (\emph{l} for \emph{left} en anglais). Ces flèches sont, la plupart du
+temps, non verticales.
Ainsi\enskip
$\begin{WithArrows}[displaystyle]
I
-& = \int_{\frac{\pi}4}^0 \ln\Bigl(1+\tan\left(\tfrac{\pi}4-u\right)\Bigr)(-d u)
+& = \int_{\frac{\pi}{4}}^0 \ln\Bigl(1+\tan\left(\tfrac{\pi}{4}-u\right)\Bigr)(-d u)
\Arrow[lr]{Cette flèche utilise une option \texttt{lr}.}\\
-& = \int_0^{\frac{\pi}4} \ln\Bigl(1+\tan\left(\tfrac{\pi}4-u\right)\Bigr)d u \\
-& = \int_0^{\frac{\pi}4}\ln\left(1+\frac{1-\tan u}{1+\tan u}\right)\, d u \\
-& =\int_0^{\frac{\pi}4}\ln\left(\frac{1+\tan u+1-\tan u}{1+\tan u}\right) d u
+& = \int_0^{\frac{\pi}{4}} \ln\Bigl(1+\tan\left(\tfrac{\pi}{4}-u\right)\Bigr)d u \\
+& = \int_0^{\frac{\pi}{4}}\ln\left(1+\frac{1-\tan u}{1+\tan u}\right)\, d u \\
+& =\int_0^{\frac{\pi}{4}}\ln\left(\frac{1+\tan u+1-\tan u}{1+\tan u}\right) d u
\Arrow[ll,jump=2,tikz={text width = 5cm}]{Cette flèche utilise une option \texttt{ll}
et une option \texttt{jump} fixée à $2$}\\
-& =\int_0^{\frac{\pi}4} \ln\left(\frac2{1+\tan u}\right)\, d u\\
-& =\int_0^{\frac{\pi}4}\bigl(\ln2-\ln(1+\tan u)\bigr)\, d u \\
-& =\frac{\pi}4\ln2-\int_0^{\frac{\pi}4}\ln(1+\tan u)\, d u \\
-& =\frac{\pi}4\ln2-I
+& =\int_0^{\frac{\pi}{4}} \ln\left(\frac{2}{1+\tan u}\right)\, d u\\
+& =\int_0^{\frac{\pi}{4}}\bigl(\ln2-\ln(1+\tan u)\bigr)\, d u \\
+& =\frac{\pi}{4}\ln2-\int_0^{\frac{\pi}{4}}\ln(1+\tan u)\, d u \\
+& =\frac{\pi}{4}\ln2-I
\end{WithArrows}$
\interitem
-Il y a aussi une option nommée |i| (\emph{i} pour \emph{intermédiaire}). Avec cette option, la flèche est
+Il y a aussi une option nommée \Definition{i} (\emph{i} pour \emph{intermédiaire}). Avec cette option, la flèche est
verticale et calée à gauche.
-\begin{Verbatim}
+\begin{Code}
$\begin{WithArrows}
(a+b)(a+ib)(a-b)(a-ib)
& = (a+b)(a-b)\cdot(a+ib)(a-ib) \\
-& = (a^2-b^2)(a^2+b^2) \Arrow~emphase#[i]@{parce que $(x-y)(x+y)=x^2-y^2$}\\
+& = (a^2-b^2)(a^2+b^2) \Arrow\emph{[i]}{parce que $(x-y)(x+y)=x^2-y^2$}\\
& = a^4-b^4
\end{WithArrows}$
-\end{Verbatim}
+\end{Code}
$\begin{WithArrows}
(a+b)(a+ib)(a-b)(a-ib)
@@ -614,41 +683,43 @@ $\begin{WithArrows}
\interitem
-L'environnement |{WithArrows}| propose aussi une option |group|. Avec cette option,
+L'environnement |{WithArrows}| propose aussi une option \Definition{group}. Avec cette option,
\emph{toutes} les flèches de l'environnement sont regroupées sur une même verticale calée à gauche.
\label{group}
%
-\begin{Verbatim}[formatcom=\small\color{gray}]
-$\begin{WithArrows}[~emphase#displaystyle,group@]
-2xy'-3y=\sqrt x
-& \Longleftrightarrow 2x(K'y_0+Ky_0')-3Ky_0 = \sqrt x \\
-& \Longleftrightarrow 2xK'y_0 + K(2xy_0'-3y_0) = \sqrt x \\
-& \Longleftrightarrow 2x K'y_0 = \sqrt x \Arrow{...}\\
+\begin{Code}
+$\begin{WithArrows}[\emph{displaystyle,group}]
+2xy'-3y=\sqrt{x}
+& \Longleftrightarrow 2x(K'y_0+Ky_0')-3Ky_0 = \sqrt{x} \\
+& \Longleftrightarrow 2xK'y_0 + K(2xy_0'-3y_0) = \sqrt{x} \\
+& \Longleftrightarrow 2x K'y_0 = \sqrt{x} \Arrow{...}\\
...
\end{WithArrows}$
-\end{Verbatim}
+\end{Code}
$\begin{WithArrows}[displaystyle,group]
-2xy'-3y=\sqrt x
-& \Longleftrightarrow 2x(K'y_0+Ky_0')-3Ky_0 = \sqrt x \\
-& \Longleftrightarrow 2xK'y_0 + K(2xy_0'-3y_0) = \sqrt x \\
-& \Longleftrightarrow 2x K'y_0 = \sqrt x \Arrow{on remplace $y_0$ par sa valeur}\\
-& \Longleftrightarrow 2xK'x^{\frac32} = x^{\frac12} \Arrow{simplification par $x$}\\
-& \Longleftrightarrow K' = \tfrac1{2x^2} \Arrow{on primitive}\\
-& \Longleftrightarrow K = -\tfrac1{2x}
+2xy'-3y=\sqrt{x}
+& \Longleftrightarrow 2x(K'y_0+Ky_0')-3Ky_0 = \sqrt{x} \\
+& \Longleftrightarrow 2xK'y_0 + K(2xy_0'-3y_0) = \sqrt{x} \\
+& \Longleftrightarrow 2x K'y_0 = \sqrt{x} \Arrow{on remplace $y_0$ par sa valeur}\\
+& \Longleftrightarrow 2xK'x^{\frac{3}{2}} = x^{\frac{1}{2}} \Arrow{simplification par $x$}\\
+& \Longleftrightarrow K' = \tfrac{1}{2x^2} \Arrow{on primitive}\\
+& \Longleftrightarrow K = -\tfrac{1}{2x}
\end{WithArrows}$
\bigskip
-L'environnement |{WithArrows}| fournit encore une autre option, nommée |groups| (avec un \emph{s} dans le
-nom). Avec cette option, les flèches sont divisées en plusieurs «groupes». Chaque groupe est un ensemble de flèches
-connectées entre elles\footnote{Plus précisément : pour chaque flèche $a$, notons $i(a)$ le numéro de sa rangée de
- départ et
- $f(a)$ le numéro de sa rangée d'arrivée ; pour deux flèches $a$ et $b$, nous noterons $a \sim b$ lorsque
- $\llbracket i(a),f(a)\rrbracket \cap \llbracket i(b),f(b)\rrbracket \neq \varnothing$ ; les groupes sont les
- classes d'équivalence de la clôture transitive de la relation $\sim$.}. Toutes les flèches d'un même groupe sont placées sur
-une même verticale qui est calée à gauche.
+L'environnement |{WithArrows}| fournit encore une autre option, nommée \Definition{groups}
+(avec un \emph{s} dans le nom). Avec cette option, les flèches sont divisées en plusieurs
+«groupes». Chaque groupe est un ensemble de flèches connectées entre elles\footnote{Plus
+ précisément : pour chaque flèche $a$, notons $i(a)$ le numéro de sa rangée de départ et
+ $f(a)$ le numéro de sa rangée d'arrivée ; pour deux flèches $a$ et $b$, nous noterons
+ $a \sim b$ lorsque
+ $\llbracket i(a),f(a)\rrbracket \cap \llbracket i(b),f(b)\rrbracket \neq \varnothing$ ;
+ les groupes sont les classes d'équivalence de la clôture transitive de la relation
+ $\sim$.}. Toutes les flèches d'un même groupe sont placées sur une même verticale qui
+est calée à gauche.
\bigskip
@@ -663,24 +734,28 @@ A & = B \Arrow{un} \\
\end{WithArrows}$
\bigskip
-Dans un environnement qui utilise l'option |group| ou l'option |groups|, il est encore possible de donner une
-option de position (|ll|, |lr|, |rl|, |rr| ou |i|) à une flèche individuelle\footnote{Une telle flèche est
- qualifiée d'\emph{indépendante} (\emph{independent} en anglais) dans la documentation technique.}. Une telle
-flèche sera tracée indépendamment des groupes. Il est aussi possible de commencer un nouveau groupe avec l'option
-|new-group| pour une certaine flèche.
+Dans un environnement qui utilise l'option |group| ou l'option |groups|, il est encore
+possible de donner une option de position (|ll|, |lr|, |rl|, |rr| ou |i|) à une flèche
+individuelle\footnote{Une telle flèche est qualifiée d'\emph{indépendante}
+ (\emph{independent} en anglais) dans la documentation technique.}. Une telle flèche sera
+tracée indépendamment des groupes. Il est aussi possible de commencer un nouveau groupe
+avec l'option \Definition{new-group} pour une certaine flèche.
\bigskip
-Si on le souhaite, on peut passer l'option |group| ou |groups| à la commande |WithArrowsOptions| de telle sorte
-qu'elle deviendra la valeur par défaut (jusqu'à la fin du groupe TeX courant). Dans ce cas, il est encore possible
-de revenir au comportement par défaut pour un environnement |{WithArrows}| donné avec l'option |rr|:
+Si on le souhaite, on peut passer l'option |group| ou |groups| à la commande
+|WithArrowsOptions| de telle sorte qu'elle deviendra la valeur par défaut (jusqu'à la fin
+du groupe TeX courant). Dans ce cas, il est encore possible de revenir au comportement par
+défaut pour un environnement |{WithArrows}| donné avec l'option |rr|:
|\begin{WithArrows}[rr]|.
-\vspace{1cm}
-Dans l'exemple suivant, nous avons utilisé l'option |groups| pour l'environnement et l'option |new-group| pour la
-dernière flèche (c'est pourquoi cette dernière flèche n'est pas alignée avec les premières).
+\vspace{1cm}
+Dans l'exemple suivant, nous avons utilisé l'option |groups| pour l'environnement et
+l'option |new-group| pour la dernière flèche (c'est pourquoi cette dernière flèche n'est
+pas alignée avec les premières).
+\bigskip
$\begin{WithArrows}[interline=1mm,groups]
\sum\limits_{k=0}^n\frac{\cos kx}{\cos^k x}
& = \sum\limits_{k=0}^n \frac{\Re (e^{ikx})}{(\cos x)^k}
@@ -695,11 +770,13 @@ $\begin{WithArrows}[interline=1mm,groups]
\Arrow{réduction au même dénominateur} \\
& = \Re \left(\frac{\frac{\cos^{n+1}x-e^{i(n+1)x}}{\cos^{n+1}x}}{\frac{\cos x-e^{ix}}{\cos x}}\right)
\Arrow{\(\Re(kz) = k\cdot\Re(z)\) lorsque \(k\) est réel} \\
-& = \frac1{\cos^n x}\Re \left(\frac{\cos^{n+1}x-e^{i(n+1)x}}{\cos x-e^{ix}}\right)
+& = \frac{1}{\cos^n x}\Re \left(\frac{\cos^{n+1}x-e^{i(n+1)x}}{\cos x-e^{ix}}\right)
\Arrow[new-group]{forme algébrique des nombres complexes} \\
-& =\frac1{\cos^n x}\Re\left(\frac{\cos^{n+1}x-(\cos(n+1)x+i\sin(n+1)x)}{\cos x-(\cos x+i\sin x)}\right) \\
-& =\frac1{\cos^n x}\Re\left(\frac{(\cos^{n+1}x-\cos(n+1)x)-i\sin(n+1)x}{-i\sin x}\right) \\
-& = \frac1{\cos^nx}\cdot\frac{\sin(n+1)x}{\sin x}
+& =\frac{1}{\cos^n x}
+ \Re\left(\frac{\cos^{n+1}x-(\cos(n+1)x+i\sin(n+1)x)}{\cos x-(\cos x+i\sin x)}\right) \\
+& =\frac{1}{\cos^n x}
+ \Re\left(\frac{(\cos^{n+1}x-\cos(n+1)x)-i\sin(n+1)x}{-i\sin x}\right) \\
+& = \frac{1}{\cos^nx}\cdot\frac{\sin(n+1)x}{\sin x}
\end{WithArrows}$
@@ -710,8 +787,8 @@ $\begin{WithArrows}[interline=1mm,groups]
Considérons, dans un environnement donné, deux flèches notées formellement $a$ et $b$.
-On notera $i_a$ et $i_b$ les numéros des lignes de départ de $a$ et $b$ et $f_a$ et $f_b$ les numéros de leurs
-lignes d'arrivée. On a bien entendu $i_a \le f_a$ et $i_b \le f_b$
+On notera $i_a$ et $i_b$ les numéros des lignes de départ de $a$ et $b$ et $f_a$ et $f_b$
+les numéros de leurs lignes d'arrivée. On a bien entendu $i_a \le f_a$ et $i_b \le f_b$
\smallskip
On dira que la flèche~$a$ \emph{recouvre} la flèche~$b$ lorsque $i_a \le i_b \le f_b \le f_a$
@@ -727,25 +804,26 @@ A & = B \Arrow[tikz=red,jump=3]{}\\
\end{WithArrows}$
\bigskip
-Au niveau local, il existe une option |o|. Cette option n'est disponible que lorsque l'on est en mode |group| ou bien
-en mode |groups| (cf. p.~\pageref{group}).
+Au niveau local, il existe une option \Definition{o}. Cette option n'est disponible que
+lorsque l'on est en mode |group| ou bien en mode |groups| (cf. p.~\pageref{group}).
-Une flèche de type |o| est tracée avec un décalage horizontal (comme celui fixé par |xoffset|) calculé
-automatiquement en fonction des flèches qu'elle recrouvre.\footnote{Parmi les flèches recouvertes, les flèches
- indépendantes (c'est-à-dire celles qui ont une option explicite |rr|, |ll|, |rl|, |lr|, |i|, |up| ou |down|) ne
- sont pas prises en compte pour le calcul du |xoffset|.}
+Une flèche de type |o| est tracée avec un décalage horizontal (comme celui fixé par
+|xoffset|) calculé automatiquement en fonction des flèches qu'elle
+recrouvre.\footnote{Parmi les flèches recouvertes, les flèches indépendantes (c'est-à-dire
+ celles qui ont une option explicite |rr|, |ll|, |rl|, |lr|, |i|, |up| ou |down|) ne sont
+ pas prises en compte pour le calcul du |xoffset|.}
\bigskip
-\begin{BVerbatim}[boxwidth=10cm,baseline=c]
+\begin{Code}[width=10cm]
$\begin{WithArrows}[groups]
-A & = B \Arrow{un}\Arrow[~emphase#o@,jump=3]{direct} \\
+A & = B \Arrow{un}\Arrow[\emph{o},jump=3]{direct} \\
& = C + C \Arrow{deux} \\
& = D + D + D \Arrow{trois} \\
& = E + E \\
& = F + F
\end{WithArrows}$
-\end{BVerbatim}
+\end{Code}
$\begin{WithArrows}[c,groups]
A & = B \Arrow{un}\Arrow[o,jump=3]{direct} \\
& = C + C \Arrow{deux} \\
@@ -757,17 +835,18 @@ A & = B \Arrow{un}\Arrow[o,jump=3]{direct} \\
\interitem
-Les flèches de type |o| peuvent elles-mêmes être recouvertes par d'autres flèches de type~|o|:\par\nobreak
+Les flèches de type |o| peuvent elles-mêmes être recouvertes par d'autres flèches de
+type~|o|:\par\nobreak
\bigskip
-\begin{BVerbatim}
+\begin{Code}
$\begin{WithArrows}[groups]
-A & = B \Arrow{un}\Arrow[~emphase#o@,jump=2]{deux}\Arrow[~emphase#o@,jump=3]{trois}\\
+A & = B \Arrow{un}\Arrow[\emph{o},jump=2]{deux}\Arrow[\emph{o},jump=3]{trois}\\
& = C \\
& = D \\
& = E + E + E + E + E + E + E
\end{WithArrows}$
-\end{BVerbatim}
+\end{Code}
\bigskip
@@ -779,32 +858,33 @@ A & = B \Arrow{un}\Arrow[o,jump=2]{deux}\Arrow[o,jump=3]{trois}\\
\end{WithArrows}$
\bigskip
-L'espace (horizontal) entre une flèche de type |o| et les flèches immédiatement recouvertes est fixé par le
-paramètre |xoffset-for-o-arrows| que l'on peut régler avec |\WithArrowsOptions| (valeur initiale : 2~mm).
+L'espace (horizontal) entre une flèche de type |o| et les flèches immédiatement
+recouvertes est fixé par le paramètre \Definition{xoffset-for-o-arrows} que l'on peut
+régler avec |\WithArrowsOptions| (valeur initiale : 2~mm).
\bigskip
-\emph{Remarque} : La lettre |o| a été choisie car c'est la première lettre du mot anglais \emph{over}. Une flèche
-de type~|o| est \emph{au-dessus} des flèches qu'elle recouvre.
+\emph{Remarque} : La lettre |o| a été choisie car c'est la première lettre du mot anglais
+\emph{over}. Une flèche de type~|o| est \emph{au-dessus} des flèches qu'elle recouvre.
\interitem
\section{Les options « up » et « down » pour des flèches individuelles}
\label{up-and-down}
-Au niveau local, il y a deux options pour les flèches individuelles, nommées «|up|» et «|down|». L'exemple
-suivant illustre ces types de flèches:
+Au niveau local, il y a deux options pour les flèches individuelles, nommées
+\Definition{up} et \Definition{down}. L'exemple suivant illustre ces types de flèches:
-\begin{Verbatim}
+\begin{Code}
\(\begin{WithArrows}
A & = B
-\Arrow~emphase#[up]@{une flèche de type \texttt{up}} \\
+\Arrow\emph{[up]}{une flèche de type \texttt{up}} \\
& = C + C + C + C + C + C + C + C \\
& = C + C + C + C + C + C + C + C
-\Arrow~emphase#[down]@{une flèche de type \texttt{down}} \\
+\Arrow\emph{[down]}{une flèche de type \texttt{down}} \\
& = E + E
\end{WithArrows}\)
-\end{Verbatim}
+\end{Code}
\bigskip
$\begin{WithArrows}
@@ -818,31 +898,36 @@ A & = B
\vspace{1cm}
-Les options |up| et |down| nécessitent la bibliothèque Tikz \pkg{calc}. Si elle n'a pas été chargée au préalable par
-l'utilisateur, une erreur sera levée.
+Les options |up| et |down| nécessitent la bibliothèque Tikz \pkg{calc}. Si elle n'a pas
+été chargée au préalable par l'utilisateur, une erreur sera levée.
\vspace{1cm}
-Les options |up| et |down| peuvent en fait prendre comme valeur une liste de couples clé-valeur.
+Les options |up| et |down| peuvent en fait prendre comme valeur une liste de couples
+clé-valeur.
\begin{itemize}
-\item La clé |radius| est le rayon de l'angle arrondi de la flèche\footnote{La valeur initiale de ce paramètre est égale à
-$4$~pt, qui est la valeur par défaut du ``|rounded corners|'' de Tikz.}.
-\item La clé |width| contrôle la largeur (de la partie horizontale) de la flèche :
+\item La clé \Definition{radius} est le rayon de l'angle arrondi de la flèche\footnote{La
+ valeur initiale de ce paramètre est égale à $4$~pt, qui est la valeur par défaut du
+ ``|rounded corners|'' de Tikz.}.
+\item La clé \Definition{width} contrôle la largeur (de la partie horizontale) de la flèche :
\begin{itemize}
-\item avec la valeur |max|, la largeur de la flèche est ajustée par rapport à la position des nœuds (c'est le
-comportement par défaut des flèches |up| et |down| comme illustré dans l'exemple précédent) ;
-\item avec une valeur numérique, la largeur de la flèche est directement fixée par cette valeur numérique ;
-\item avec la valeur |min|, la largeur de la flèche est ajustée au contenu de son étiquette.
+\item avec la valeur \Definition{max}, la largeur de la flèche est ajustée par rapport à
+la position des nœuds (c'est le comportement par défaut des flèches |up| et |down| comme
+illustré dans l'exemple précédent) ;
+\item avec une valeur numérique, la largeur de la flèche est directement fixée par cette
+valeur numérique ;
+\item avec la valeur \Definition{min}, la largeur de la flèche est ajustée au contenu de
+son étiquette.
\end{itemize}
\end{itemize}
\vspace{1cm}
-\begin{Verbatim}
+\begin{Code}
$\begin{WithArrows}
A & = B
-\Arrow[~emphase#up={width=2cm,radius=0pt}@]{essai} \\
+\Arrow[\emph{up={width=2cm,radius=0pt}}]{essai} \\
& = C + C + C + C + C + C + C + C
\end{WithArrows}$
-\end{Verbatim}
+\end{Code}
\medskip
$\begin{WithArrows}
@@ -853,13 +938,13 @@ A & = B
\vspace{1cm}
-\begin{Verbatim}
+\begin{Code}
$\begin{WithArrows}
A & = B
-\Arrow[~emphase#up={width=min}@]{essai} \\
+\Arrow[\emph{up={width=min}}]{essai} \\
& = C + C + C + C + C + C + C + C
\end{WithArrows}$
-\end{Verbatim}
+\end{Code}
\medskip
$\begin{WithArrows}
@@ -869,8 +954,9 @@ A & = B
\end{WithArrows}$
\vspace{1cm}
-Les options relatives aux flèches |up| et |down| peuvent être fixées au niveau global ou environnemental avec la
-clé |up-and-down|. Cette clé peut aussi être utilisée comme préfixe comme illustré maintenant.
+Les options relatives aux flèches |up| et |down| peuvent être fixées au niveau global ou
+environnemental avec la clé \Definition{up-and-down}. Cette clé peut aussi être utilisée
+comme préfixe comme illustré maintenant.
%
\begin{Verbatim}
\WithArrowsOptions{up-and-down/width=min}
@@ -880,23 +966,25 @@ clé |up-and-down|. Cette clé peut aussi être utilisée comme préfixe comme i
\section{Comparaison avec l'environnement \{aligned\}}
-L'environnement |{WithArrows}| présente des similitudes avec l'environnement |{aligned}| de l'extension
-\pkg{amsmath}. Ce sont seulement des similitudes car |{WithArrows}| n'a pas été écrit en s'appuyant sur
-|{aligned}|.\footnote{En fait, il est possible d'utiliser l'extension \pkg{witharrows} sans l'extension
- \pkg{amsmath}.}
+L'environnement |{WithArrows}| présente des similitudes avec l'environnement |{aligned}|
+de l'extension \pkg{amsmath}. Ce sont seulement des similitudes car |{WithArrows}| n'a pas
+été écrit en s'appuyant sur |{aligned}|.\footnote{En fait, il est possible d'utiliser
+ l'extension \pkg{witharrows} sans l'extension \pkg{amsmath}.}
\interitem
-Comme dans les environnements de l'\pkg{amsmath}, il est possible de changer l'espacement entre deux rangées avec
-l'option de la commande |\\| de fin de ligne (il est aussi possible d'utiliser |\\*| mais cela a
-exactement le même effet que |\\| puisqu'un environnement |{WithArrows}| est toujours insécable). Cette
-option est conçu pour être utilisée avec des valeurs positives uniquement.
+
+Comme dans les environnements de l'extension \pkg{amsmath}, il est possible de changer
+l'espacement entre deux rangées avec l'option de la commande |\\| de fin de ligne (il est
+aussi possible d'utiliser |\\*| mais cela a exactement le même effet que |\\| puisqu'un
+environnement |{WithArrows}| est toujours insécable). Cette option est conçue pour être
+utilisée avec des valeurs positives uniquement.
%
-\begin{Verbatim}
+\begin{Code}
$\begin{WithArrows}
-A & = (a+1)^2 \Arrow{on développe} ~emphase#\\[2ex]@
+A & = (a+1)^2 \Arrow{on développe} \emph{\\[2ex]}
& = a^2 + 2a + 1
\end{WithArrows}$
-\end{Verbatim}
+\end{Code}
$\begin{WithArrows}
A & = (a+1)^2 \Arrow{on développe} \\*[2ex]
@@ -906,34 +994,35 @@ A & = (a+1)^2 \Arrow{on développe} \\*[2ex]
\interitem
-Dans les environnements de l'\pkg{amsmath} (ou de \pkg{mathtools}), l'espace entre deux rangées est fixé par un
-paramètre appelé |\jot| (il s'agit d'une dimension et non d'un ressort). C'est aussi le cas pour l'environnement
-|{WithArrows}|. Une option |jot| a été ajoutée à l'environnement |{WithArrows}| dans le but de changer ce paramètre
-|\jot| pour un environnement donné.\footnote{Il est aussi possible de changer |\jot| avec l'environnement
- |{spreadlines}| de \pkg{mathtools}.}
+Dans les environnements de l'extension \pkg{amsmath} (ou de \pkg{mathtools}), l'espace
+entre deux rangées est fixé par un paramètre appelé |\jot| (il s'agit d'une dimension et
+non d'un ressort). C'est aussi le cas pour l'environnement |{WithArrows}|. Une option
+\Definition{jot} a été ajoutée à l'environnement |{WithArrows}| dans le but de changer ce
+paramètre |\jot| pour un environnement donné.\footnote{Il est aussi possible de changer
+ |\jot| avec l'environnement |{spreadlines}| de \pkg{mathtools}.}
%
-\begin{Verbatim}
-$\begin{WithArrows}[displaystyle,~emphase#jot=2ex@]
-F & = \frac12G \Arrow{on développe}\\
- & = H + \frac12K \Arrow{on continue}\\
+\begin{Code}
+$\begin{WithArrows}[displaystyle,\emph{jot=2ex}]
+F & = \frac{1}{2}G \Arrow{on développe}\\
+ & = H + \frac{1}{2}K \Arrow{on continue}\\
& = K
\end{WithArrows}$
-\end{Verbatim}
+\end{Code}
$\begin{WithArrows}[displaystyle,jot=2ex]
-F & = \frac12G \Arrow{on développe}\\
- & = H + \frac12K \Arrow{on continue}\\
+F & = \frac{1}{2}G \Arrow{on développe}\\
+ & = H + \frac{1}{2}K \Arrow{on continue}\\
& = K
\end{WithArrows}$
\bigskip
-Néanmoins, cette nouvelle valeur de |\jot| sera aussi utilisée dans les nouveaux alignements inclus dans
-l'environnement~|{WithArrows}|:
+Néanmoins, cette nouvelle valeur de |\jot| sera aussi utilisée dans les nouveaux
+alignements inclus dans l'environnement~|{WithArrows}|:
%
-\begin{Verbatim}
-$\begin{WithArrows}[jot=2ex]
+\begin{Code}
+$\begin{WithArrows}[\emph{jot=2ex}]
\varphi(x,y) = 0 & \Leftrightarrow (x+y)^2 + (x+2y)^2 = 0
\Arrow{$x$ et $y$ sont réels}\\
& \Leftrightarrow \left\{
@@ -943,7 +1032,7 @@ x+2y & = 0
\end{aligned}
\right.
\end{WithArrows}$
-\end{Verbatim}
+\end{Code}
$\begin{WithArrows}[jot=2ex]
@@ -958,11 +1047,12 @@ x+2y & = 0
\end{WithArrows}$
\bigskip
-Peut-être que cela ne correspond pas au résultat souhaité. C'est pourquoi une option |interline| est fournie. Il
-est possible d'utiliser un ressort (\emph{skip}) pour cette option.
+Peut-être que cela ne correspond pas au résultat souhaité. C'est pourquoi une option
+\Definition{interline} est fournie. Il est possible d'utiliser un ressort (\emph{skip})
+pour cette option.
%
-\begin{Verbatim}
-$\begin{WithArrows}[~emphase#interline=2ex@]
+\begin{Code}
+$\begin{WithArrows}[\emph{interline=2ex}]
\varphi(x,y) = 0 & \Leftrightarrow (x+y)^2 + (x+2y)^2 = 0
\Arrow{$x$ et $y$ sont réels}\\
& \Leftrightarrow \left\{
@@ -972,7 +1062,7 @@ x+2y & = 0 \\
\end{aligned}
\right.
\end{WithArrows}$
-\end{Verbatim}
+\end{Code}
$\begin{WithArrows}[interline=2ex]
@@ -987,10 +1077,11 @@ x+2y & = 0 \\
\end{WithArrows}$
-\interitem
-De même que l'environnement |{aligned}|, |{WithArrows}| a une option de placement qui peut prendre les valeurs |t|,
-|c| ou |b|. Néanmoins, la valeur initiale n'est pas |c| mais |t|. Si on le souhaite, il est possible d'avoir la
-valeur |c| comme valeur par défaut en utilisant l'instruction |\WithArrowsOptions{c}| au début du document.
+\interitem
+De même que l'environnement |{aligned}|, |{WithArrows}| a une option de placement qui peut
+prendre les valeurs \Definition{t}, \Definition{c} ou \Definition{b}. Néanmoins, la valeur
+initiale n'est pas |c| mais |t|. Si on le souhaite, il est possible d'avoir la valeur |c|
+comme valeur par défaut en utilisant l'instruction |\WithArrowsOptions{c}| au début du document.
%
\begin{Verbatim}
Ainsi\enskip
@@ -1010,14 +1101,15 @@ A & = (a+1)^2 \Arrow{on développe} \\
La valeur |c| peut être utile, par exemple, si on souhaite mettre une accolade :
\smallskip
+% Dans le code suivant, on ne peut utiliser {Code} avec \emph{} à cause du \{...
\begin{Verbatim}
-On pose\enskip $~emphase#\left\{@
+On pose\enskip $~emphase#{\left\{@
\begin{WithArrows}[~emphase#c@]
f(x) & = 3x^3+2x^2-x+4
\Arrow[tikz=-]{les deux sont des polynômes}\\
g(x) & = 5x^2-5x+6
\end{WithArrows}
-~emphase#\right.@$
+~emphase#\right.@
\end{Verbatim}
@@ -1035,7 +1127,8 @@ Contrairement à |{aligned}|, l'environnement |{WithArrows}| utilise |\textstyle
Là aussi, il est possible de changer ce comportement avec |\WithArrowsOptions|:
-\quad |\WithArrowsOptions{displaystyle}|.
+\smallskip
+|\WithArrowsOptions{displaystyle}|.
\smallskip
@@ -1046,23 +1139,21 @@ $\left\{
\begin{aligned}
\sum_{i=1}^n (x_i+1)^2
& = \sum_{i=1}^n (x_i^2 + 2x_i+1) \\
-& = \sum_{i=1}^n x_i^2 + 2 \sum_{i=1}^nx_i + n
+& = \sum_{i=1}^n x_i^2 + 2 \sum_{i=1}^n x_i + n
\end{aligned}
\right.$
\medskip
L'exemple suivant est composé avec |{WithArrows}[c,displaystyle]|. Les résultats
-sont parfaitement identiques.\footnote{Dans les versions de l'\pkg{amsmath} antérieures au
-5~novembre~2016, un espace fin était ajouté sur la gauche de l'environnement |{aligned}|.
-Les versions plus récentes n'ajoutent pas d'espace et |{WithArrows}| non plus.}\par\nobreak
+sont parfaitement identiques.\par\nobreak
\smallskip
$\left\{
\begin{WithArrows}[c,displaystyle]
\sum_{i=1}^n (x_i+1)^2
& = \sum_{i=1}^n (x_i^2 + 2x_i+1) \\
-& = \sum_{i=1}^n x_i^2 + 2 \sum_{i=1}^nx_i + n
+& = \sum_{i=1}^n x_i^2 + 2 \sum_{i=1}^n x_i + n
\end{WithArrows}
\right.$
@@ -1074,25 +1165,25 @@ $\left\{
Les environnements |{WithArrows}| peuvent être imbriqués. Dans ce cas, les options fournies
à l'environnement englobant s'appliquent aussi aux environnements imbriqués (avec des
exceptions tout à fait attendues pour |interline|, |code-before| et |code-after|). La commande
-|Arrow| peut être utilisée dans chaque environnement |{WithArrows}|.
+|\Arrow| peut être utilisée dans chaque environnement |{WithArrows}|.
-\begin{Verbatim}[formatcom=\small\color{gray}]
-$~emphase#\begin{WithArrows}@
+\begin{Code}
+$\emph{\begin{WithArrows}}
\varphi(x,y)=0
& \Leftrightarrow (x+2y)^2+(2x+4y)^2 = 0 \Arrow{les nombres sont réels}\\
& \Leftrightarrow
- \left\{~emphase#\begin{WithArrows}@[c]
+ \left\{\emph{\begin{WithArrows}}[c]
x+2y & = 0 \\
2x+4y & = 0
- ~emphase#\end{WithArrows}@\right. \\
+ \emph{\end{WithArrows}}\right. \\
& \Leftrightarrow
- \left\{~emphase#\begin{WithArrows}@[c]
+ \left\{\emph{\begin{WithArrows}}[c]
x+2y & = 0 \Arrow[tikz=-]{la même équation}\\
x+2y & = 0
- ~emphase#\end{WithArrows}@\right. \\
+ \emph{\end{WithArrows}}\right. \\
& \Leftrightarrow x+2y=0
-~emphase#\end{WithArrows}@$
-\end{Verbatim}
+\emph{\end{WithArrows}}$
+\end{Code}
$\begin{WithArrows}
\varphi(x,y)=0
@@ -1111,8 +1202,8 @@ $\begin{WithArrows}
\end{WithArrows}$
\bigskip
-Néanmoins, on peut souhaiter tracer une flèche entre des rangées qui ne sont pas dans le même
-environnement. Par exemple, on pourrait souhaiter tracer la flèche suivante :
+Néanmoins, on peut souhaiter tracer une flèche entre des rangées qui ne sont pas dans le
+même environnement. Par exemple, on pourrait souhaiter tracer la flèche suivante :
\bigskip
$\begin{WithArrows}[code-after = \Arrow[v]{1-2}{2-2}{division par $2$} ]
@@ -1144,16 +1235,16 @@ Une commande |\Arrow| dans le |code-after| prend trois arguments :
\item une spécification pour la rangée d'arrivée ;
\item une étiquette pour la flèche.
\end{itemize}
-Comme d'habitude, il est possible de donner des options entre crochets avant ou après les trois arguments
-obligatoires. Néanmoins, ces options sont limitées (voir plus bas).
+Comme d'habitude, il est possible de donner des options entre crochets avant ou après les
+trois arguments obligatoires. Néanmoins, ces options sont limitées (voir plus bas).
-\interitem
-La spécification de rangée est construite avec la position de l'environnement conidéré dans l'arbre des
-imbrications, suivie, après un trait d'union, par le numéro de la rangée.
+\interitem La spécification de rangée est construite avec la position de l'environnement
+conidéré dans l'arbre des imbrications, suivie, après un trait d'union, par le numéro de
+la rangée.
\bigskip
-Dans l'exemple précédent, il y a deux environnements |{WithArrows}| imbriqués dans l'environnement
-|{WithArrows}| principal.
+Dans l'exemple précédent, il y a deux environnements |{WithArrows}| imbriqués dans
+l'environnement |{WithArrows}| principal.
\medskip
$\begin{WithArrows}[tikz-code = {\path (#1) to node {#3} (#2) ; }]
@@ -1173,18 +1264,18 @@ $\begin{WithArrows}[tikz-code = {\path (#1) to node {#3} (#2) ; }]
\end{WithArrows}$
\bigskip
-La flèche que nous voulons tracer part de la rangée~$2$ du sous-environnement \no $1$ (et, par conséquent, la
-spécification est |1-2|) et arrive à la rangée~$2$ du sous-environnement \no $2$ (et, par conséquent, la
-spécification est |2-2|). Nous pouvons tracer la flèche avec une commande |\Arrow| dans le |code-after| de la
-manière suivante :
+La flèche que nous voulons tracer part de la rangée~$2$ du sous-environnement \no $1$ (et,
+par conséquent, la spécification est |1-2|) et arrive à la rangée~$2$ du
+sous-environnement \no $2$ (et, par conséquent, la spécification est |2-2|). Nous pouvons
+tracer la flèche avec une commande |\Arrow| dans le |code-after| de la manière suivante :
-\begin{Verbatim}
-$\begin{WithArrows}[~emphase#code-after = \Arrow{1-2}{2-2}{division par $2$}@ ]
+\begin{Code}
+$\begin{WithArrows}[\emph{code-after = \Arrow{1-2}{2-2}{division par $2$}}]
\varphi(x,y)=0
& \Leftrightarrow (x+2y)^2+(2x+4y)^2 = 0 \\
.........
\end{WithArrows}$
-\end{Verbatim}
+\end{Code}
$\begin{WithArrows}[code-after = \Arrow{1-2}{2-2}{division par $2$} ]
\varphi(x,y)=0
@@ -1203,23 +1294,23 @@ $\begin{WithArrows}[code-after = \Arrow{1-2}{2-2}{division par $2$} ]
\end{WithArrows}$
\bigskip
-Les options autorisées pour une commande |\Arrow| dans le |code-after| sont : |ll|, |lr|, |rl|, |rr|, |v|,
-|xoffset|, |tikz| et |tikz-code|. Exceptée |v|, qui est spécifique à |\Arrow| dans le |code-after|, toutes ces
-options ont leur signification habituelle.
+Les options autorisées pour une commande |\Arrow| dans le |code-after| sont : |ll|, |lr|,
+|rl|, |rr|, |v|, |xoffset|, |tikz| et |tikz-code|. Exceptée |v|, qui est spécifique à
+|\Arrow| dans le |code-after|, toutes ces options ont leur signification habituelle.
-Avec l'option |v|, la flèche tracée est verticale à une abscisse calculée avec
-la rangée de départ et la rangée d'arrivée uniquement : les lignes intermédiaires ne sont pas prises en compte
-contrairement à ce qui se passe avec l'option |i|. Pour le moment, l'option |i| n'est pas disponible
-pour la commande~|\Arrow| dans le |code-after|. Néanmoins, il est toujours possible
-de déplacer une flèche avec |xoffset| (ou |xshift| de Tikz).
-\begin{Verbatim}
-$\begin{WithArrows}[code-after=\Arrow~emphase#[v]@{1-2}{2-2}{division by $2$}]
+Avec l'option |v|, la flèche tracée est verticale à une abscisse calculée avec la rangée
+de départ et la rangée d'arrivée uniquement : les lignes intermédiaires ne sont pas prises
+en compte contrairement à ce qui se passe avec l'option |i|. Pour le moment, l'option |i|
+n'est pas disponible pour la commande~|\Arrow| dans le |code-after|. Néanmoins, il est
+toujours possible de déplacer une flèche avec |xoffset| (ou |xshift| de Tikz).
+\begin{Code}
+$\begin{WithArrows}[code-after=\Arrow\emph{[v]}{1-2}{2-2}{division by $2$}]
\varphi(x,y)=0
& \Leftrightarrow (x+2y)^2+(2x+4y)^2 = 0 \\
.........
\end{WithArrows}$
-\end{Verbatim}
+\end{Code}
$\begin{WithArrows}[code-after = \Arrow[v]{1-2}{2-2}{division par $2$} ]
\varphi(x,y)=0
@@ -1239,21 +1330,22 @@ $\begin{WithArrows}[code-after = \Arrow[v]{1-2}{2-2}{division par $2$} ]
\interitem
-L'extension \pkg{witharrows} fournit une autre commande disponible dans le |code-after| : la commande
-|\MultiArrow|. Cette commande dessine un «rateau». La liste des rangées concernées par ce rateau est donnée dans le
-premier argument de la commande |\MultiArrow|. La syntaxe utilisée pour décrire cette liste est celle de la
-commande |\foreach| de \pkg{pgffor}.
+L'extension \pkg{witharrows} fournit une autre commande disponible dans le |code-after| :
+la commande \DefinitionCommande{MultiArrow}. Cette commande dessine un «rateau». La liste
+des rangées concernées par ce rateau est donnée dans le premier argument de la commande
+|\MultiArrow|. La syntaxe utilisée pour décrire cette liste est celle de la commande
+|\foreach| de \pkg{pgffor}.
-\begin{Verbatim}
+\begin{Code}
$\begin{WithArrows}[tikz = rounded corners,
- code-after = {~emphase#\MultiArrow{1,...,4}{text}@} ]
+ code-after = {\emph{\MultiArrow{1,...,4}{text}}} ]
A & = B \\
& = C \\
& = D \\
& = E \\
& = F
\end{WithArrows}$
-\end{Verbatim}
+\end{Code}
$\begin{WithArrows}[tikz = rounded corners,
@@ -1272,17 +1364,18 @@ Pour le moment, aucune option n'est disponible pour cette commande |\MultiArrow|
\medskip
\section{Dessiner des flèches depuis l'extérieur des environnements \{WithArrows\}}
-Si on désire dessiner des flèches depuis l'extérieur des environnements |{WithArrows}|, il est possible de le
-faire en utilisant les nœuds Tikz créés par ces environnements.
+Si on désire dessiner des flèches depuis l'extérieur des environnements |{WithArrows}|, il
+est possible de le faire en utilisant les nœuds Tikz créés par ces environnements.
-Le nom d'un nœud Tikz créé par \pkg{witharrows} est préfixé par |wa-|. Ensuite, on trouve une liste de nombres
-qui indique quelle est la position de l'environnement dans l'arbre d'imbrication des environnements. À la fin, on a
-le suffixe |l| pour un nœud de gauche et le suffixe |r| pour un nœud de droite.
+Le nom d'un nœud Tikz créé par \pkg{witharrows} est préfixé par |wa-|. Ensuite, on trouve
+une liste de nombres qui indique quelle est la position de l'environnement dans l'arbre
+d'imbrication des environnements. À la fin, on a le suffixe |l| pour un nœud de gauche et
+le suffixe |r| pour un nœud de droite.
\smallskip
-À titre d'illustration, nous donnons un exemple d'environnements |{WithArrows}| imbriqués et, pour chaque nœud
-de droite, le nom de ce nœud.\footnote{Il existe une option |show-node-names| pour faire afficher les noms de
- ces nœuds.}
+À titre d'illustration, nous donnons un exemple d'environnements |{WithArrows}| imbriqués
+et, pour chaque nœud de droite, le nom de ce nœud.\footnote{Il existe une option
+ \Definition{show-node-names} pour faire afficher les noms de ces nœuds.}
\medskip
@@ -1319,19 +1412,21 @@ P & \vartriangleleft Q
\medskip
L'extension \pkg{witharrows} fournit quelques outils pour faciliter l'utilisation de ces nœuds :
\begin{itemize}
-\item la commande |\WithArrowsLastEnv| donne le numéro du dernier environnement de niveau~$0$ (c'est-à-dire
-non imbriqué dans un autre environnement de \pkg{witharrows}) ;
+\item la commande \DefinitionCommande{WithArrowsLastEnv} donne le numéro du dernier
+environnement de niveau~$0$ (c'est-à-dire non imbriqué dans un autre environnement de
+\pkg{witharrows}) ;
-\item un nom peut être donné à un environnement avec l'option |name| et, dans ce cas, les nœuds créés dans
-l'environnement auront des alias construits en utilisant ce nom ;
+\item un nom peut être donné à un environnement avec l'option \Definition{name} et, dans
+ce cas, les nœuds créés dans l'environnement auront des alias construits en utilisant ce
+nom ;
-\item le style Tikz |WithArrows/arrow| est le style utilisé par \pkg{witharrows} pour dessiner une
-flèche\footnote{Plus précisément, ce style est passé à Tikz via l'option «|every path|» avant le dessin de la
+\item le style Tikz \Definition{WithArrows/arrow} est le style utilisé par
+\pkg{witharrows} pour dessiner une flèche\footnote{Plus précisément, ce style est passé à Tikz via l'option «|every path|» avant le dessin de la
flèche (qui se fait avec l'instruction Tikz stockée dans |tikz-code|). Ce style est modifié par l'option
|tikz| de \pkg{witharrows} (avec une portée correspondant au groupe TeX courant).} ;
-\item le style Tikz |WithArrows/arrow/tips| est le style utilisé pour la pointe de flèche (ce style est
-lui-même chargé par le style |WithArrows/arrow|).
+\item le style Tikz \Definition{WithArrows/arrow/tips} est le style utilisé pour la pointe
+de flèche (ce style est lui-même chargé par le style |WithArrows/arrow|).
\end{itemize}
Par exemple, nous pouvons tracer une flèche allant de \texttt{wa-\WithArrowsLastEnv-2-1-2-r.south}
@@ -1383,32 +1478,32 @@ P & \vartriangleleft Q
\]
\medskip
-Dans le cas présent, il aurait été plus facile d'utiliser une commande |\Arrow| dans le |code-after| mais
-c'était seulement un exemple pour illustrer comment les nœuds Tikz créés par \pkg{witharrows} peuvent être
-utilisés.
+Dans le cas présent, il aurait été plus facile d'utiliser une commande |\Arrow| dans le
+|code-after| mais c'était seulement un exemple pour illustrer comment les nœuds Tikz créés
+par \pkg{witharrows} peuvent être utilisés.
\bigskip
-Dans l'exemple suivant, on crée des environnements |{WithArrows}| nommés «|premier|» et «|second|» et on dessine
-une flèche entre un nœud du premier et un nœud du second.
+Dans l'exemple suivant, on crée des environnements |{WithArrows}| nommés «|premier|» et
+«|second|» et on dessine une flèche entre un nœud du premier et un nœud du second.
-\begin{Verbatim}
-$\begin{WithArrows}[~emphase#name=premier@]
+\begin{Code}
+$\begin{WithArrows}[\emph{name=premier}]
A & = B \\
& = C
\end{WithArrows}$
\bigskip
-$\begin{WithArrows}[~emphase#name=second@]
+$\begin{WithArrows}[\emph{name=second}]
A' & = B' \\
& = C'
\end{WithArrows}$
\begin{tikzpicture}[remember picture,overlay]
\draw [WithArrows/arrow]
- ([xshift=3mm]~emphase#premier@-1-r.south)
- to ([xshift=3mm]~emphase#second@-1-r.north) ;
+ ([xshift=3mm]\emph{premier}-1-r.south)
+ to ([xshift=3mm]\emph{second}-1-r.north) ;
\end{tikzpicture}
-\end{Verbatim}
+\end{Code}
\begin{center}
@@ -1433,39 +1528,42 @@ A' & = B' \\
\section{L'environnement \{DispWithArrows\}}
\label{DispWithArrows}
-Comme dit précédemment, l'environnement |{WithArrows}| présente des similitudes avec l'environnement |{aligned}| de
-l'\pkg{amsmath} (et de |mathtools|). L'extension \pkg{witharrows} fournit aussi un environnement |{DispWithArrows}|
-qui est similaire aux environnements |{align}| et |{flalign}| de l'\pkg{amsmath}.
+Comme dit précédemment, l'environnement |{WithArrows}| présente des similitudes avec
+l'environnement |{aligned}| de l'extension \pkg{amsmath} (et de |mathtools|). L'extension
+\pkg{witharrows} fournit aussi un environnement \Definition{\{DispWithArrows\}} qui est
+similaire aux environnements |{align}| et |{flalign}| de l'extension \pkg{amsmath}.
\medskip
-L'environnement |{DispWithArrows}| doit être utilisé \emph{hors} du mode mathématique. Comme
-|{align}|, il doit être utilisé en mode horizontal.
-\begin{Verbatim}
-\begin{~emphase#DispWithArrows@}
+L'environnement |{DispWithArrows}| doit être utilisé \emph{hors} du mode mathématique.
+Comme |{align}|, il doit être utilisé en mode horizontal.
+\begin{Code}
+\begin{\emph{DispWithArrows}}
A & = (a+1)^2 \Arrow{on développe} \\
& = a^2 + 2a + 1
-\end{~emphase#DispWithArrows@}
-\end{Verbatim}
+\end{\emph{DispWithArrows}}
+\end{Code}
\begin{DispWithArrows}
A & = (a+1)^2 \Arrow{on développe} \\
& = a^2 + 2a + 1
\end{DispWithArrows}
\medskip
-Il est possible d'utiliser la commande |\notag| (ou |\nonumber|) pour supprimer un numéro d'équation.
+Il est possible d'utiliser la commande \DefinitionCommande{notag} (ou
+\DefinitionCommande{nonumber}) pour supprimer un numéro d'équation.
-Il est possible d'utiliser la commande |\tag| pour placer une étiquette spéciale (par ex. $\star$).
+Il est possible d'utiliser la commande \DefinitionCommande{tag} pour placer une étiquette
+spéciale (par ex. $\star$).
-Il est aussi possible de placer un label pour une ligne de l'environnement avec la commande
-|\label|.
+Il est aussi possible de placer un label pour une ligne de l'environnement avec la
+commande \DefinitionCommande{label}.
Ces commandes doivent être utilisées dans la dernière colonne de l'environnement.
-\begin{Verbatim}
+\begin{Code}
\begin{DispWithArrows}
-A & = (a+1)^2 \Arrow{on développe} ~emphase#\notag@ \\
- & = a^2 + 2a + 1 ~emphase#\tag{$\star$} \label{mon-équation}@
+A & = (a+1)^2 \Arrow{on développe} \emph{\notag} \\
+ & = a^2 + 2a + 1 \emph{\tag{$\star$} \label{mon-équation}}
\end{DispWithArrows}
-\end{Verbatim}
+\end{Code}
\begin{DispWithArrows}
A & = (a+1)^2 \Arrow{on développe} \notag \\
& = a^2 + 2a + 1 \tag{$\star$} \label{mon-équation}
@@ -1475,52 +1573,55 @@ références ont été personnalisées avec |\labelformat{equation}{(#1)}|}
\medskip
-Si \pkg{amsmath} (ou \pkg{mathtools}) est chargée, il est possible d'utiliser |\tag*| qui compose le label
-sans les parenthèses. Par exemple, il est possible de l'utiliser pour mettre le symbole |\square| de
-\pkg{amssymb}. Ce symbole est souvent utilisé pour marquer la fin d'une démonstration.\footnote{Signalons que
- l'environnement |{DispWithArrows}| est compatible avec la commande |\qedhere| de \pkg{amsthm}.}
-\begin{Verbatim}
+Si \pkg{amsmath} (ou \pkg{mathtools}) est chargée, il est possible d'utiliser |\tag*| qui
+compose le label sans les parenthèses. Par exemple, il est possible de l'utiliser pour
+mettre le symbole |\square| de \pkg{amssymb}. Ce symbole est souvent utilisé pour marquer
+la fin d'une démonstration.\footnote{Signalons que l'environnement |{DispWithArrows}| est
+ compatible avec la commande |\qedhere| de \pkg{amsthm}.}
+\begin{Code}
\begin{DispWithArrows}
A & = (a+1)^2 \Arrow{on développe} \notag \\
- & = a^2 + 2a + 1 ~emphase#\tag*{$\square$}@
+ & = a^2 + 2a + 1 \emph{\tag*{$\square$}}
\end{DispWithArrows}
-\end{Verbatim}
+\end{Code}
\begin{DispWithArrows}
A & = (a+1)^2 \Arrow{on développe} \notag \\
& = a^2 + 2a + 1 \tag*{$\square$}
\end{DispWithArrows}
\medskip
-Il est également possible de supprimer tous les numéros d'équations avec l'option booléenne |notag| (ou
-|nonumber|), au niveau global ou bien au niveau d'un environnement.
-
-Enfin, il existe aussi
-un environnement |{DispWithArrows*}| qui supprime tous les numéros.\footnote{Même dans ce cas, il est possible
-de mettre une étiquette manuellement avec la commande |\tag|.}
-\begin{Verbatim}
-\begin{~emphase#DispWithArrows*@}
+Il est également possible de supprimer tous les numéros d'équations avec l'option
+booléenne \Definition{notag} (ou \Definition{nonumber}), au niveau global ou bien au niveau d'un
+environnement.
+
+Enfin, il existe aussi un environnement \Definition{\{DispWithArrows*\}} qui supprime tous
+les numéros.\footnote{Même dans ce cas, il est possible de mettre une étiquette
+ manuellement avec la commande |\tag|.}
+\begin{Code}
+\begin{\emph{DispWithArrows*}}
A & = (a+1)^2 \Arrow{on développe} \\
& = a^2 + 2a + 1
-\end{~emphase#DispWithArrows*@}
-\end{Verbatim}
+\end{\emph{DispWithArrows*}}
+\end{Code}
\begin{DispWithArrows*}
A & = (a+1)^2 \Arrow{on développe} \\
& = a^2 + 2a + 1
\end{DispWithArrows*}
\medskip
-En fait, il y a une autre option, nommée |tagged-lines|, qui peut être utilisée pour contrôler quelles lignes
-seront numérotées. La valeur de cette option est la liste des numéros de lignes (dans l'environnement) qui seront
-numérotées (par le système de numérotage des équations). Par exemple, avec l'option
-|tagged-lines = {first,3,last}|, seulement la première, la troisième et la dernière lignes seront numérotées.
-Il y a aussi une valeur spéciale |all| qui signifie que toutes les lignes doivent être numérotées.
-\begin{Verbatim}
-\begin{DispWithArrows}[~emphase#tagged-lines = last@]
+En fait, il y a une autre option, nommée \Definition{tagged-lines}, qui peut être utilisée
+pour contrôler quelles lignes seront numérotées. La valeur de cette option est la liste
+des numéros de lignes (dans l'environnement) qui seront numérotées (par le système de
+numérotage des équations). Par exemple, avec l'option |tagged-lines = {first,3,last}|,
+seulement la première, la troisième et la dernière lignes seront numérotées. Il y a aussi
+une valeur spéciale |all| qui signifie que toutes les lignes doivent être numérotées.
+\begin{Code}
+\begin{DispWithArrows}[\emph{tagged-lines = last}]
A & = A_1 \Arrow{première étape} \\
& = A_2 \Arrow{deuxième étape} \\
& = A_3
\end{DispWithArrows}
-\end{Verbatim}
+\end{Code}
\begin{DispWithArrows}[tagged-lines = last]
A & = A_1 \Arrow{première étape} \\
& = A_2 \Arrow{deuxième étape} \\
@@ -1528,49 +1629,54 @@ A & = A_1 \Arrow{première étape} \\
\end{DispWithArrows}
\bigskip
-Avec l'option |fleqn|, l'environnement est composé calé à gauche (d'une manière similaire
-à l'option |fleqn| des classes standard de LaTeX). Dans ce cas, la marge gauche peut être réglée avec
-l'option |mathindent| (qui a un nom inspiré du paramètre |\mathindent| de LaTeX). La valeur initiale pour cette
-option est de 25~pt.
+Avec l'option \Definition{fleqn}, l'environnement est composé calé à gauche (d'une manière
+similaire à l'option |fleqn| des classes standard de LaTeX). Dans ce cas, la marge gauche
+peut être réglée avec l'option \Definition{mathindent} (qui a un nom inspiré du paramètre
+|\mathindent| de LaTeX). La valeur initiale pour cette option est de 25~pt. On peut y
+mettre comme valeur un ressort (= \emph{skip} = \emph{glue}).
-\begin{Verbatim}
-\begin{DispWithArrows}[~emphase#fleqn,mathindent = 1cm@]
+\begin{Code}
+\begin{DispWithArrows}[\emph{fleqn,mathindent = 1cm}]
A & = (a+1)^2 \Arrow{on développe} \\
& = a^2 + 2a + 1
\end{DispWithArrows}
-\end{Verbatim}
+\end{Code}
\begin{DispWithArrows}[fleqn,mathindent = 1cm]
A & = (a+1)^2 \Arrow{on développe} \\
& = a^2 + 2a + 1
\end{DispWithArrows}
\medskip
-\emph{Remarque} : Par conception, l'option |fleqn| de \pkg{witharrows} est
-indépendante de l'option de classe |fleqn| de LaTeX. En effet, puisque les environnement de
-\pkg{witharrows} sont conçus pour être utilisés avec des flèches sur le côté droit, l'utilisateur
-peut souhaiter utiliser \pkg{witharrows} avec l'option |fleqn| (de manière à avoir plus de place sur la droite
-des équations pour les flèches) tout en continuant à centrer les équations classiques.
+\emph{Remarque} : Par conception, l'option |fleqn| de \pkg{witharrows} est indépendante de
+l'option de classe |fleqn| de LaTeX. En effet, puisque les environnement de
+\pkg{witharrows} sont conçus pour être utilisés avec des flèches sur le côté droit,
+l'utilisateur peut souhaiter utiliser \pkg{witharrows} avec l'option |fleqn| (de manière à
+avoir plus de place sur la droite des équations pour les flèches) tout en continuant à
+centrer les équations classiques.
\medskip
-Si l'option |leqno| est utilisée comme option de classe, les labels seront composés
-à gauche également pour les environnements |{DispWithArrows}|.\footnote{L'extension \pkg{amsmath} a une option |leqno|
-mais \pkg{witharrows}, bien entendu, ne tient pas compte de cette option : \pkg{witharrows}
-vérifie seulement l'option |leqno| de la classe du document.}
+Si l'option |leqno| est utilisée comme option de classe, les labels seront composés à
+gauche également pour les environnements |{DispWithArrows}|.\footnote{L'extension
+ \pkg{amsmath} a une option |leqno| mais \pkg{witharrows}, bien entendu, ne tient pas
+ compte de cette option : \pkg{witharrows} vérifie seulement l'option |leqno| de la
+ classe du document.}
\medskip
-Si l'extension \pkg{amsmath} est chargée, il est possible d'utiliser la commande |\intertext| dans les
-environnements |{DispWithArrows}|. Il est également possible d'utiliser l'environnement |{subequations}|.
-Néanmoins, il existe pour les environnements |{DispWithArrows}| une option |subequations| qui demande
-d'encapsuler l'environnement dans un environnement |{subequations}|.
+Si l'extension \pkg{amsmath} est chargée, il est possible d'utiliser la commande
+|\intertext| dans les environnements |{DispWithArrows}|. Il est également possible
+d'utiliser l'environnement |{subequations}|. Néanmoins, il existe pour les environnements
+|{DispWithArrows}| une option \Definition{subequations} qui demande d'encapsuler
+l'environnement dans un environnement |{subequations}|.
\medskip
-Dans l'exemple suivant, l'option |subequations| est fixée via la commande |\WithArrowsOptions|. Chacun
-des environnements suivants sera alors sous-numéroté (dans la portée de la commande |WithArrowsOptions|).
+Dans l'exemple suivant, l'option |subequations| est fixée via la commande
+|\WithArrowsOptions|. Chacun des environnements suivants sera alors sous-numéroté (dans la
+portée de la commande |WithArrowsOptions|).
-\begin{Verbatim}
-~emphase#\WithArrowsOptions{subequations}@
+\begin{Code}
+\emph{\WithArrowsOptions{subequations}}
Premier environnement.
\begin{DispWithArrows}
A & = B \\
@@ -1581,7 +1687,7 @@ Deuxième environnement.
D & = E \\
& = F
\end{DispWithArrows}
-\end{Verbatim}
+\end{Code}
%
\begin{scope}
\WithArrowsOptions{subequations}
@@ -1598,21 +1704,23 @@ D & = E \\
\end{scope}
\bigskip
-S'il n'y a pas suffisamment de place pour faire appraraître le numéro d'équation à la fin de la ligne, il n'y a pas
-de positionnement automatique de ce numéro sur la ligne suivante (comme dans les environnements de
-l'\pkg{amsmath}) : il y aura surimpression de texte. Néanmoins, dans |{DispWithArrows}|, l'utilisateur peut
-utiliser la commande |\tagnextline| pour demander manuellement la composition du numéro sur la ligne suivante.
-\begin{Verbatim}
+S'il n'y a pas suffisamment de place pour faire appraraître le numéro d'équation à la fin
+de la ligne, il n'y a pas de positionnement automatique de ce numéro sur la ligne suivante
+(comme dans les environnements de l'extension \pkg{amsmath}) : il y aura surimpression de texte.
+Néanmoins, dans |{DispWithArrows}|, l'utilisateur peut utiliser la commande
+\DefinitionCommande{tagnextline} pour demander manuellement la composition du numéro sur
+la ligne suivante.
+\begin{Code}
\begin{DispWithArrows}[displaystyle]
S_{2(p+1)}
& =\sum_{k=1}^{2(p+1)} (-1)^k k^2 \\
& \smash[b]{=\sum_{k=1}^{2p}(-1)^kk²
- +(-1)^{2p+1}(2p+1)^2+(-1)^{2p+2}(2p+2)^2} ~emphase#\tagnextline@ \\
+ +(-1)^{2p+1}(2p+1)^2+(-1)^{2p+2}(2p+2)^2} \emph{\tagnextline} \\
&= S_{2p}-(2p+1)^2+(2p+2)^2\\
&=p(2p+1)-(2p+1)^2+(2p+2)^2\\
&= 2p^2+5p+3
\end{DispWithArrows}
-\end{Verbatim}
+\end{Code}
\begin{center}
\color{gray}\vrule%
\begin{minipage}{275pt}\color{black}
@@ -1632,28 +1740,29 @@ S_{2(p+1)}
\bigskip
-Les environnements |{DispWithArrows}| et |{DispWithArrows*}| fournissent également une option
-|wrap-lines|. Avec cette option, les lignes de l'étiquette sont automatiquement coupées à droite.
+Les environnements |{DispWithArrows}| et |{DispWithArrows*}| fournissent également une
+option \Definition{wrap-lines}. Avec cette option, les lignes de l'étiquette sont
+automatiquement coupées à droite.
-\begin{Verbatim}
-\begin{DispWithArrows*}[displaystyle,~emphase#wrap-lines@]
+\begin{Code}
+\begin{DispWithArrows*}[displaystyle,\emph{wrap-lines}]
S_n
-& = \frac1n \Re \left(\sum_{k=0}^{n-1}\bigl(e^{i\frac{\pi}{2n}}\bigr)^k\right)
-\Arrow{somme des termes d'une suite géométrique de raison $e^{i\frac{2\pi}n}$}\\
-& = \frac1n \Re \left( \frac{1-\bigl(e^{i\frac{\pi}{2n}}\bigr)^n}
+& = \frac{1}{n} \Re \left(\sum_{k=0}^{n-1}\bigl(e^{i\frac{\pi}{2n}}\bigr)^k\right)
+\Arrow{somme des termes d'une suite géométrique de raison $e^{i\frac{2\pi}{n}}$}\\
+& = \frac{1}{n} \Re \left( \frac{1-\bigl(e^{i\frac{\pi}{2n}}\bigr)^n}
{1-e^{i\frac{\pi}{2n}}}\right)
\Arrow{cette ligne de texte a été coupée automatiquement} \\
-& = \frac1n \Re \left(\frac{1-i}{1-e^{i\frac{\pi}{2n}}}\right)
+& = \frac{1}{n} \Re \left(\frac{1-i}{1-e^{i\frac{\pi}{2n}}}\right)
\end{DispWithArrows*}
-\end{Verbatim}
+\end{Code}
\begin{DispWithArrows*}[displaystyle,wrap-lines]
S_n
-& = \frac1n \Re \left(\sum_{k=0}^{n-1}\bigl(e^{i\frac{\pi}{2n}}\bigr)^k\right)
-\Arrow{somme des termes d'une suite géométrique de raison $e^{i\frac{2\pi}n}$}\\
-& = \frac1n \Re \left(
+& = \frac{1}{n} \Re \left(\sum_{k=0}^{n-1}\bigl(e^{i\frac{\pi}{2n}}\bigr)^k\right)
+\Arrow{somme des termes d'une suite géométrique de raison $e^{i\frac{2\pi}{n}}$}\\
+& = \frac{1}{n} \Re \left(
\frac{1-\bigl(e^{i\frac{\pi}{2n}}\bigr)^n}{1-e^{i\frac{\pi}{2n}}} \right)
\Arrow{cette ligne de texte a été coupée automatiquement} \\
-& = \frac1n \Re \left(\frac{1-i}{1-e^{i\frac{\pi}{2n}}}\right)
+& = \frac{1}{n} \Re \left(\frac{1-i}{1-e^{i\frac{\pi}{2n}}}\right)
\end{DispWithArrows*}
\bigskip
@@ -1663,57 +1772,63 @@ elle s'applique aux instructions |\Arrow| et |\MultiArrow| du |code-after|
de l'environnement englobant.
\vspace{1cm}
-Nous avons dit que les environnements |{DispWithArrows}| et |{DispWithArrows*}|
-devaient être utilisés en mode horizontal et non en mode vertical. Il y a néanmoins
-une exception. Ces environnements peuvent être utilisés directement après un |\item| d'une liste
-LaTeX. Dans ce cas, aucun espace vertical n'est ajouté avant l'environnement.\footnote{Il est possible de désactiver
- cette fonctionnalité avec l'option |standard-behaviour-with-items|.}
+Nous avons dit que les environnements |{DispWithArrows}| et |{DispWithArrows*}| devaient
+être utilisés en mode horizontal et non en mode vertical. Il y a néanmoins une exception.
+Ces environnements peuvent être utilisés directement après un |\item| d'une liste LaTeX.
+Dans ce cas, aucun espace vertical n'est ajouté avant l'environnement.\footnote{Il est
+ possible de désactiver cette fonctionnalité avec l'option
+ |standard-behaviour-with-items|.}
\medskip
-Voici un exemple où, avec |{DispWithArrows}|, on peut insérer l'équation dans un environnement
-|{enumerate}| tout en utilisant l'option |wrap-lines|.
+Voici un exemple où, avec |{DispWithArrows}|, on peut insérer l'équation dans un
+environnement |{enumerate}| tout en utilisant l'option |wrap-lines|.
-\begin{Verbatim}
-~emphase#\begin{enumerate}@
-~emphase#\item @
+\smallskip
+\begingroup
+\small
+\begin{Code}
+\emph{\begin{enumerate}
+\item }
\begin{DispWithArrows}%
[displaystyle, wrap-lines, tagged-lines = last, fleqn, mathindent = 0 pt]
S_n
-& = \frac1n \Re \left(\sum_{k=0}^{n-1}\bigl(e^{i\frac{\pi}{2n}}\bigr)^k\right)
+& = \frac{1}{n} \Re \left(\sum_{k=0}^{n-1}\bigl(e^{i\frac{\pi}{2n}}\bigr)^k\right)
\Arrow{on utilise la formule pour la somme de termes d'une suite géométrique de raison
$e^{i\frac{2\pi}n}$} \\
-& = \frac1n \Re \left( \frac{1-\bigl(e^{i\frac{\pi}{2n}}\bigr)^n}
+& = \frac{1}{n} \Re \left( \frac{1-\bigl(e^{i\frac{\pi}{2n}}\bigr)^n}
{1-e^{i\frac{\pi}{2n}}}\right)
-\Arrow{$\bigl(e^{i\frac{\pi}{2n}}\bigr)^n = e^{i\frac{\pi}2}=i$} \\
-& = \frac1n \Re \left(\frac{1-i}{1-e^{i\frac{\pi}{2n}}}\right)
+\Arrow{$\bigl(e^{i\frac{\pi}{2n}}\bigr)^n = e^{i\frac{\pi}{2}}=i$} \\
+& = \frac{1}{n} \Re \left(\frac{1-i}{1-e^{i\frac{\pi}{2n}}}\right)
\end{DispWithArrows}
-~emphase#\end{enumerate}@
-\end{Verbatim}
+\emph{\end{enumerate}}
+\end{Code}
+\endgroup
\begin{enumerate}
\item
-\begin{DispWithArrows}[displaystyle, wrap-lines, tagged-lines = last, fleqn, mathindent = 0 pt]
+\begin{DispWithArrows}%
+ [displaystyle, wrap-lines, tagged-lines = last, fleqn, mathindent = 0 pt]
S_n
-& = \frac1n \Re \left(\sum_{k=0}^{n-1}\bigl(e^{i\frac{\pi}{2n}}\bigr)^k\right)
-\Arrow{on utilise la formule pour la somme de termes d'une suite géométrique de raison
+& = \frac{1}{n} \Re \left(\sum_{k=0}^{n-1}\bigl(e^{i\frac{\pi}{2n}}\bigr)^k\right)
+\Arrow{on utilise la formule pour la somme de termes d'une suite géométrique de raison
$e^{i\frac{2\pi}n}$}\\
-& = \frac1n \Re \left(
+& = \frac{1}{n} \Re \left(
\frac{1-\bigl(e^{i\frac{\pi}{2n}}\bigr)^n}{1-e^{i\frac{\pi}{2n}}} \right)
-\Arrow{$\bigl(e^{i\frac{\pi}{2n}}\bigr)^n = e^{i\frac{\pi}2}=i$} \\
-& = \frac1n \Re \left(\frac{1-i}{1-e^{i\frac{\pi}{2n}}}\right)
+\Arrow{$\bigl(e^{i\frac{\pi}{2n}}\bigr)^n = e^{i\frac{\pi}{2}}=i$} \\
+& = \frac{1}{n} \Re \left(\frac{1-i}{1-e^{i\frac{\pi}{2n}}}\right)
\end{DispWithArrows}
\end{enumerate}
-\vspace{1cm}
+\vspace{1cm}
L'environnement |{DispWithArrows}| est similaire à l'environnement |{align}| de
-l'\pkg{amsmath}. Néanmoins, |{DispWithArrows}| n'est pas construit en utilisant |{align}|
-(en fait, il est possible d'utiliser \pkg{witharrows} sans \pkg{amsmath}).
+l'extension \pkg{amsmath}. Néanmoins, |{DispWithArrows}| n'est pas construit en utilisant
+|{align}| (en fait, il est possible d'utiliser \pkg{witharrows} sans \pkg{amsmath}).
Il y a quelques différences entre |{DispWithArrows}| et |{align}|.
\begin{itemize}
\item L'environnement |{DispWithArrows}| ne peut pas être inséré dans un environment
-|{gather}| de l'\pkg{amsmath}.
+|{gather}| de l'extension \pkg{amsmath}.
\item Un environment |{DispWithArrows}| est toujours insécable (même avec
-|\allowdisplaybreaks| de l'\pkg{amsmath}).
+|\allowdisplaybreaks| de l'extension \pkg{amsmath}).
\item Les commandes |\label|, |\tag|, |\notag| et |\nonumber| ne sont autorisées
que dans la dernière colonne.
\item Après un |\item| d'une liste LaTeX, aucun espace vertical n'est ajouté (cela peut être
@@ -1743,34 +1858,35 @@ Elle n'est pas compatible avec \pkg{showkeys} (certains labels ne sont pas affic
\subsection*{L'option <...> de DispWithArrows}
-L'environnement |{DispWithArrows}| propose une option |left-brace|. Si cette option est présente, son
-contenu est composé à gauche, suivi d'une accolade (d'où le nom) puis du corps de
-l'environnement.\footnote{L'option |left-brace| peut aussi être utilisée sans valeur: dans ce cas, seule
- l'accolade est tracée.}
+L'environnement |{DispWithArrows}| propose une option \Definition{left-brace}. Si cette
+option est présente, son contenu est composé à gauche, suivi d'une accolade (d'où le nom)
+puis du corps de l'environnement.\footnote{L'option |left-brace| peut aussi être utilisée
+ sans valeur: dans ce cas, seule l'accolade est tracée.}
-Pour la lisibilité, cette option |left-brace| est aussi disponible avec une syntaxe spéciale : on peut la
-rentrer en la mettant entre chevrons (|<| et |>|) juste après le |{DispWithArrows}| (et donc avant
-les éventuels arguments optionnels entre crochets).
+Pour la lisibilité, cette option |left-brace| est aussi disponible avec une syntaxe
+spéciale : on peut la rentrer en la mettant entre chevrons (|<| et |>|) juste après le
+|{DispWithArrows}| (et donc avant les éventuels arguments optionnels entre crochets).
\bigskip
On peut alors faire des constructions avec distinctions de cas, comme dans l'exemple
-suivant.\footnote{L'environnement |{cases}| de l'\pkg{amsmath} permet de réaliser de telles distinctions de
- cas mais on ne peut pas utiliser la numérotation automatique des équations. L'environnement |{numcases}| de
- l'extension \pkg{cases} (de Donald Arseneau) permet d'utiliser ces numéros d'équations, mais, bien entendu, il
- n'y a pas de composition de flèches.}
+suivant.\footnote{L'environnement |{cases}| de l'extension \pkg{amsmath} permet de réaliser de
+ telles distinctions de cas mais on ne peut pas utiliser la numérotation automatique des
+ équations. L'environnement |{numcases}| de l'extension \pkg{cases} (de Donald Arseneau)
+ permet d'utiliser ces numéros d'équations, mais, bien entendu, il n'y a pas de
+ composition de flèches.}
\medskip
-\begin{BVerbatim}
-\begin{DispWithArrows}~emphase#< \binom{n}{p} = >@[format = ll,fleqn,displaystyle]
+\begin{Code}
+\begin{DispWithArrows}\emph{< \binom{n}{p} = >}[format = ll,fleqn,displaystyle]
0 & \quad \text{si } p > n
\Arrow{ce cas peut en fait rentrer\\ dans le suivant} \\
\frac{n(n-1)\cdots(n-p+1)}{p!} & \quad \text{si } 0 \leq p \leq n \\
0 & \quad \text{si } p < 0
\end{DispWithArrows}
-\end{BVerbatim}
+\end{Code}
%
\begin{DispWithArrows}< \binom{n}{p} = >[format = ll,fleqn,displaystyle]
0 & \quad \text{si } p > n
@@ -1780,17 +1896,17 @@ suivant.\footnote{L'environnement |{cases}| de l'\pkg{amsmath} permet de réalis
\end{DispWithArrows}
\interitem
-Dans l'exemple suivant, on sous-numérote les équations d'un système avec l'option |subequations| (disponible
-quand l'|amsmath| est chargé).
+Dans l'exemple suivant, on sous-numérote les équations d'un système avec l'option
+|subequations| (disponible quand l'|amsmath| est chargé).
-\begin{Verbatim}
-\begin{DispWithArrows}~emphase#< \label{système} \ref*{système} \Leftrightarrow >@%
+\begin{Code}
+\begin{DispWithArrows}\emph{< \label{système} \ref*{système} \Leftrightarrow >}%
[format = l, subequations]
x+y+z = -3 \Arrow[tikz=-,jump=2]{3 equations} \\
xy+xz+yz=-2 \\
xyz = -15 \label{dernière-équation}
\end{DispWithArrows}
-\end{Verbatim}
+\end{Code}
%
\begin{DispWithArrows}< \label{système} \ref*{système} \Leftrightarrow >%
[format = l, subequations]
@@ -1800,24 +1916,40 @@ xyz = -15 \label{dernière-équation}
\end{DispWithArrows}
\bigskip
-Le système complet est l'équation \ref{système} (cette référence a été obtenue avec |\ref{système}|) et la
-dernière équation est l'équation \ref{dernière-équation} (référence obtenue avec
-|\ref{dernière-équation}|). Notons que |\ref*|, utilisé dans le code ci-dessus, est une variante de
-|ref| qui compose une référence sans créer de lien hypertexte (même quand \pkg{hyperref} est chargé).
+Le système complet est l'équation \ref{système} (cette référence a été obtenue avec
+|\ref{système}|) et la dernière équation est l'équation \ref{dernière-équation} (référence
+obtenue avec |\ref{dernière-équation}|). Notons que |\ref*|, utilisé dans le code
+ci-dessus, est une variante de |ref| qui compose une référence sans créer de lien
+hypertexte (même quand \pkg{hyperref} est chargé).
\bigskip
-On peut souhaiter remplacer l'accolade gauche par un autre délimiteur extensible (gauche). On peut le faire avec
-l'option |replace-left-brace-by|. Par exemple, «|replace-left-brace-by = [\enskip|» va composer avec un crochet et
-ajouter aussi un espace de 1~em après le crochet.
+On peut souhaiter remplacer l'accolade gauche par un autre délimiteur extensible (gauche).
+On peut le faire avec l'option \Definition{replace-left-brace-by}. Par exemple,
+«|replace-left-brace-by = [\enskip|» va composer avec un crochet et ajouter aussi un
+espace de 0.5~em après le crochet.
\bigskip
\section{Fonctionnalités avancées}
+\subsection{Utilisation avec Beamer}
+
+\colorbox{yellow!50}{\textbf{Nouveau 2.9}}\par\nobreak
+
+\smallskip
+Si l'extension \pkg{witharrows} est utilisée avec Beamer, la commande |\Arrow| accepte un
+argument entre chevrons (après l'argument optionnel entre crochets) pour indiquer les
+«\emph{overlays}» concernés (en interne, \pkg{witharrows} utilise simplement la commande
+|\only| de Beamer).
+
+\begin{Code}
+\Arrow[jump=2]\emph{<3->}{Exemple}
+\end{Code}
+
\subsection{Utilisation avec plain-TeX}
\label{plain-TeX}
-L'extension \pkg{witharrows} peut être utilisée avec plain-TeX. Pour cela, on doit charger l'extension avec
-|\input|:
+L'extension \pkg{witharrows} peut être utilisée avec plain-TeX. Pour cela, on doit charger
+l'extension avec |\input|:
%
\begin{Verbatim}
\input{witharrows.tex}
@@ -1838,17 +1970,19 @@ A & = (a+1)^2 \Arrow{on développe} \\
\end{Verbatim}
\medskip
-La version pour plain-TeX de \pkg{witharrows} ne propose pas toutes les fonctionnalités proposées pour la version
-LaTeX. En particulier, les fonctionnalités concernant les numéros d'équations ne sont pas disponibles (puisqu'elles
-reposent sur le système de numérotation de LaTeX).
+La version pour plain-TeX de \pkg{witharrows} ne propose pas toutes les fonctionnalités
+proposées pour la version LaTeX. En particulier, les fonctionnalités concernant les
+numéros d'équations ne sont pas disponibles (puisqu'elles reposent sur le système de
+numérotation de LaTeX).
\subsection{L'option tikz-code : comment changer la forme des flèches}
\label{tikz-code}
-L'option |tikz-code| permet à l'utilisateur de changer la forme des flèches.\footnote{Si l'option |wrap-lines|
- est utilisée dans un environnement |{DispWithArrows}| ou |{DispWithArrows*}|, l'option |tikz-code|
- n'aura pas d'effet sur les flèches de cet environnement mais uniquement sur les flèches des environnements
+L'option \Definition{tikz-code} permet à l'utilisateur de changer la forme des
+flèches.\footnote{Si l'option |wrap-lines| est utilisée dans un environnement
+ |{DispWithArrows}| ou |{DispWithArrows*}|, l'option |tikz-code| n'aura pas d'effet sur
+ les flèches de cet environnement mais uniquement sur les flèches des environnements
|{WithArrows}| imbriqués.}
\smallskip
@@ -1856,38 +1990,38 @@ Par exemple, les options «|up|» et «|down|» décrites précédemment (cf.
p.~\pageref{up-and-down}) sont programmées en interne avec |tikz-code|.
\smallskip
-La valeur de cette option doit être une instruction de tracé Tikz valide (avec le point-virgule final) où les trois
-marqueurs |#1|, |#2| et |#3| représentent le point de départ, le point d'arrivée et l'étiquette de
-la flèche.
+La valeur de cette option doit être une instruction de tracé Tikz valide (avec le
+point-virgule final) où les trois marqueurs |#1|, |#2| et |#3| représentent le point de
+départ, le point d'arrivée et l'étiquette de la flèche.
\bigskip
-Par défaut, la valeur de |tikz-code| est la suivante :
+La valeur initiale de |tikz-code| est la suivante :
\smallskip
\qquad |\draw (#1) to node {#3} (#2) ;|
\bigskip
-Dans l'exemple suivant, nous remplaçons le chemin par défaut par un chemin avec trois segments (et un
-nœud recouvrant le deuxième segment).
-\begin{Verbatim}
+Dans l'exemple suivant, nous remplaçons le chemin par défaut par un chemin avec trois
+segments (et un nœud recouvrant le deuxième segment).
+\begin{Code}
\begin{WithArrows}[format=c,ygap=5pt,interline=4mm,
- ~emphase#tikz-code = {\draw[rounded corners]@
- ~emphase# (~#1) -- ([xshift=5mm]~#1)@
- ~emphase# -- node[circle,@
- ~emphase# draw,@
- ~emphase# auto = false,@
- ~emphase# fill = gray!50,@
- ~emphase# inner sep = 1pt] {\tiny ~#3}@
- ~emphase# ([xshift=5mm]~#2)@
- ~emphase# -- (~#2) ; }@]
+ \emph{tikz-code = {\draw[rounded corners]
+ (#1) -- ([xshift=5mm]#1)
+ -- node[circle,
+ draw,
+ auto = false,
+ fill = gray!50,
+ inner sep = 1pt] {\tiny #3}
+ ([xshift=5mm]#2)
+ -- (#2) ; }}]
3 (2x+4) = 6 \Arrow{$\div 3$} \\
2x+4 = 2 \Arrow{$-4$} \\
2x = -2 \Arrow{$\div 2$} \\
x = -1
\end{WithArrows}
-\end{Verbatim}
+\end{Code}
\[\begin{WithArrows}[format=c,
@@ -1912,61 +2046,65 @@ nœud recouvrant le deuxième segment).
\end{WithArrows}\]
\bigskip
-L'environnement |{DispWithArrows}| et sa version étoilée |{DispWithArrows*}| fournissent une commande
-|\WithArrowsRightX| qui peut être utilisée dans l'option |tikz-code|. Cette commande fournit
-l'abscisse de la marge droite de la boîte de composition courante (en prenant en compte les éventuels numéros des
-équations). Pour un exemple d'utilisation, voir p.~\pageref{example-WithArrowsRightX}.
+L'environnement |{DispWithArrows}| et sa version étoilée |{DispWithArrows*}| fournissent
+une commande \DefinitionCommande{WithArrowsRightX} qui peut être utilisée dans l'option
+|tikz-code|. Cette commande fournit l'abscisse de la marge droite de la boîte de
+composition courante (en prenant en compte les éventuels numéros des équations). Pour un
+exemple d'utilisation, voir p.~\pageref{example-WithArrowsRightX}.
\bigskip
\subsection{La commande \textbackslash WithArrowsNewStyle}
-L'extension \pkg{witharrows} fournit une commande |\WithArrowsNewStyle| pour définir
-des styles d'une manière similaire aux «styles» de Tikz.
+L'extension \pkg{witharrows} fournit une commande \DefinitionCommande{WithArrowsNewStyle}
+pour définir des styles d'une manière similaire aux «styles» de Tikz.
\smallskip
-La commande |\WithArrowsNewStyle| prend deux arguments obligatoires. Le premier est
-le nom du style et le second est une liste de couples clé-valeur. La portée
-de la definition ainsi faite par |\WithArrowsNewStyle| est le groupe TeX courant.\footnote{On rappelle que, en
- particulier, tout environnement LaTeX est un groupe TeX.}
+La commande |\WithArrowsNewStyle| prend deux arguments obligatoires. Le premier est le nom
+du style et le second est une liste de couples clé-valeur. La portée de la definition
+ainsi faite par |\WithArrowsNewStyle| est le groupe TeX courant.\footnote{On rappelle que,
+ en particulier, tout environnement LaTeX est un groupe TeX.}
+
\smallskip
-Le style peut être utilisé comme une clé au niveau du document (avec |\WithArrowsOptions|), au niveau d'un
-environnement (via les arguments optionnels) ou bien encore dans une autre commande |\WithArrowsNewStyle|.
+Le style peut être utilisé comme une clé au niveau du document (avec
+|\WithArrowsOptions|), au niveau d'un environnement (via les arguments optionnels) ou bien
+encore dans une autre commande |\WithArrowsNewStyle|.
\smallskip
Pour un exemple d'utilisation, voir p.~\pageref{example-WithArrowsRightX}.
\bigskip
-Il n'existe pas de style pour les flèches individuelles. Néanmoins, il reste possible de définir de nouvelles
-commandes s'appuyant sur la commande |\Arrow|. Par exemple :
+Il n'existe pas de style pour les flèches individuelles. Néanmoins, il reste possible de
+définir de nouvelles commandes s'appuyant sur la commande |\Arrow|. Par exemple :
\begin{Verbatim}
\newcommand{\ThickArrow}{\Arrow[tikz=thick]}
\end{Verbatim}
-Cette nouvelle commande |\ThickArrow| garde la possibilité\footnote{Dans la version de \pkg{witharrows} pour LaTeX
- mais pas dans la version pour plain-TeX.} d'accepter des clés entre crochets. On peut écrire
-|\ThickArrow[jump=2]| car en fait, |\Arrow[tikz=thick][jump=2]| est une syntaxe autorisée pour la commande |\Arrow|
-(on peut mettre un nombre arbitraire d'arguments optionnels entre crochets après la commande |\Arrow|).
+Cette nouvelle commande |\ThickArrow| garde la possibilité\footnote{Dans la version de
+ \pkg{witharrows} pour LaTeX mais pas dans la version pour plain-TeX.} d'accepter des
+clés entre crochets. On peut écrire |\ThickArrow[jump=2]| car en fait,
+|\Arrow[tikz=thick][jump=2]| est une syntaxe autorisée pour la commande |\Arrow| (on peut
+mettre un nombre arbitraire d'arguments optionnels entre crochets après la commande
+|\Arrow|).
\bigskip
\subsection{La clé right-overlap}
-\colorbox{yellow!50}{\textbf{Nouveau 2.8}}
-
-La clé |right-overlap| est une clé booléenne dont la valeur initiale est |true|. Elle concerne uniquement les
-environnements |{WithArrows}|.
+La clé \Definition{right-overlap} est une clé booléenne dont la valeur initiale est
+|true|. Elle concerne uniquement les environnements |{WithArrows}|.
-Quand la clé |right-overlap| est active, les flèches (et leurs étiquettes) sont tracées en débordement et n'entrent
-donc pas dans le calcul de la boîte TeX contenant l'environnement |{WithArrows}|.
+Quand la clé |right-overlap| est active, les flèches (et leurs étiquettes) sont tracées en
+débordement et n'entrent donc pas dans le calcul de la boîte TeX contenant l'environnement
+|{WithArrows}|.
-Quand la clé |right-overlap| est mise à |false| (dans |\WithArrowsOptions| ou bien dans un environnement
-|{WithArrows}| individuel) le débord vers la droite est pris en compte dans le calcul des dimensions de la boîte
-englobante.
+Quand la clé |right-overlap| est mise à |false| (dans |\WithArrowsOptions| ou bien dans un
+environnement |{WithArrows}| individuel) le débord vers la droite est pris en compte dans
+le calcul des dimensions de la boîte englobante.
-\begin{Verbatim}
-$\left\{\begin{WithArrows}[c,format = rCrCl,~emphase#right-overlap=false@]
+\begin{Code}
+$\left\{\begin{WithArrows}[c,format = rCrCl,\emph{right-overlap=false}]
2x & + & 3y & = & 5 \Arrow{on ajoute $L_1$ à $L_2$}\\
-2x & - & 5y & = & 2
\end{WithArrows}\right.$\quad
@@ -1974,7 +2112,7 @@ $\left\{\begin{WithArrows}[c,format = rCrCl]
2x & + & 3y & = & 5 \\
& - & 2y & = & 7
\end{WithArrows}\right.$
-\end{Verbatim}
+\end{Code}
\medskip
$\left\{\begin{WithArrows}[c,format = rCrCl,right-overlap=false]
@@ -1987,17 +2125,19 @@ $\left\{\begin{WithArrows}[c,format = rCrCl]
\end{WithArrows}\right.$
\bigskip
-Le réglage |right-overlap = false| peut aussi être utile en conjonction avec la classe |standalone|.
+Le réglage |right-overlap = false| peut aussi être utile en conjonction avec la classe
+|standalone|.
\bigskip
\subsection{Positionnement vertical des flèches}
Il y a quatre paramètres pour ajuster finement la position verticale des flèches :
-|ygap|, |ystart|, |start-adjust| et |end-adjust|.
+\Definition{ygap}, \Definition{ystart}, \Definition{start-adjust} et
+\Definition{end-adjust}.
\medskip
-Nous expliquons d'abord le comportement quand les paramètres |start-adjust| et |end-adjust| sont égaux à
-zéro:
+Nous expliquons d'abord le comportement quand les paramètres |start-adjust| et
+|end-adjust| sont égaux à zéro:
\begin{itemize}
\item l'option |ystart| représente la distance verticale entre la ligne de base du
texte et le début de la flèche (valeur initiale : $0.4$~ex);
@@ -2037,12 +2177,12 @@ est |end-adjust| sont égaux à $0.4$~ex.
\bigskip
Voici par exemple le comportement sans le mécanisme de |start-adjust| et
|end-adjust| :
-\begin{Verbatim}
-$\begin{WithArrows}~emphase#[start-adjust=0pt, end-adjust=0pt]@
+\begin{Code}
+$\begin{WithArrows}\emph{[start-adjust=0pt, end-adjust=0pt]}
A & = (a+1)^2 \Arrow{on développe} \\
& = a^2 + 2a + 1
\end{WithArrows}$
-\end{Verbatim}
+\end{Code}
$\begin{WithArrows}[start-adjust=0pt, end-adjust=0pt]
A & = (a+1)^2 \Arrow{on développe} \\
@@ -2051,9 +2191,9 @@ A & = (a+1)^2 \Arrow{on développe} \\
\bigskip
-Voici le comportement par défaut depuis la version 1.13 (les paramètres
-|start-adjust| et |end-ajust| sont utilisés avec la valeur initiale $0.4$~ex). La flèche
-est plus longue et le résultat est plus esthétique.
+Voici le comportement par défaut (les paramètres |start-adjust| et |end-ajust| sont
+utilisés avec la valeur initiale $0.4$~ex). La flèche est plus longue et le résultat est
+plus esthétique.
\medskip
$\begin{WithArrows}
@@ -2063,25 +2203,18 @@ A & = (a+1)^2 \Arrow{on développe} \\
\bigskip
-Il est possible d'utiliser l'option |adjust| qui fixe à la fois |start-adjust| et |end-ajust|.
-
-\bigskip
-Puisque le mécanisme de |start-adjust| et |end-ajust| a été ajouté dans la
-version 1.13 of \pkg{witharrows}, cette version n'est pas strictement compatible avec
-les versions précédentes. Néanmoins, il est possible de retrouver le comportement précédent
-en fixant simplement |start-adjust| et |end-adjust| à $0$~pt:
-\begin{Verbatim}
-\WithArrowsOptions{adjust = 0pt}
-\end{Verbatim}
+Il est possible d'utiliser l'option \Definition{adjust} qui fixe à la fois |start-adjust|
+et |end-ajust|.
\bigskip
-Depuis la version 2.1 de \pkg{witharrows}, une flèche de |jump| égal à~$1$ a une longueur\footnote{On appelle
- \emph{longueur} de la flèche la différence entre l'ordonnée du point de départ et l'ordonnée du point d'arrivée.}
-maximale égale au paramètre |max-length-of-arrow|. La valeur initiale de ce paramètre est égale à~$2$~cm.
+Une flèche de |jump| égal à~$1$ a une longueur\footnote{On appelle \emph{longueur} de la
+ flèche la différence entre l'ordonnée du point de départ et l'ordonnée du point
+ d'arrivée.} maximale égale au paramètre \Definition{max-length-of-arrow}. La valeur
+initiale de ce paramètre est égale à~$2$~cm.
Dans l'exemple suivant, la valeur de |max-length-of-arrow| a été fixée à $1.5$~cm.
-\begin{Verbatim}
-\[\begin{WithArrows}[~emphase#max-length-of-arrow = 1.5cm@]
+\begin{Code}
+\[\begin{WithArrows}[\emph{max-length-of-arrow = 1.5cm}]
A
& =
\begin{vmatrix}
@@ -2106,7 +2239,7 @@ $L_5 \gets L_5-L_1$ % ne pas mettre de \\ ici
0 & e-a & e^2-a^2 & e^3-a^3 & e^4-a^4
\end{vmatrix}
\end{WithArrows}\]
-\end{Verbatim}
+\end{Code}
\bigskip
@@ -2144,28 +2277,30 @@ Si vous voulez mettre des notes de pied de page dans un environnement de \pkg{wi
vous pouvez utiliser une paire |\footnotemark|--|\footnotetext|.
\smallskip
-Il est aussi possible d'extraire les notes de pieds de page avec l'extension \pkg{footnote} ou bien l'extension
-\pkg{footnotehyper}.
+Il est aussi possible d'extraire les notes de pieds de page avec l'extension
+\pkg{footnote} ou bien l'extension \pkg{footnotehyper}.
\smallskip
-Si \pkg{witharrows} est chargée avec l'option |footnote| (avec |\usepackage[footnote]{witharrows}| ou
-avec |\PassOptionsToPackage|), l'extension \pkg{footnote} est chargée (si elle ne l'est pas déjà) et elle est
-utilisée pour extraire les notes de pied de page.
+Si \pkg{witharrows} est chargée avec l'option \Definition{footnote} (avec
+|\usepackage[footnote]{witharrows}| ou avec |\PassOptionsToPackage|), l'extension
+\pkg{footnote} est chargée (si elle ne l'est pas déjà) et elle est utilisée pour extraire
+les notes de pied de page.
\smallskip
-Si \pkg{witharrows} est chargée avec l'option |footnotehyper|, l'extension \pkg{footnotehyper} est chargée (si
-elle ne l'est pas déjà) et elle est utilisée pour extraire les notes de pied de page.
+Si \pkg{witharrows} est chargée avec l'option \Definition{footnotehyper}, l'extension
+\pkg{footnotehyper} est chargée (si elle ne l'est pas déjà) et elle est utilisée pour
+extraire les notes de pied de page.
\smallskip
Attention : Les extensions \pkg{footnote} et \pkg{footnotehyper} sont incompatibles.
-L'extension \pkg{footnotehyper} est le successeur de l'extension \pkg{footnote}
-et devrait être utilisée préférentiellement. L'extension \pkg{footnote} a quelques défauts ;
-en particulier, elle doit être chargée après l'extension \pkg{xcolor} et elle n'est pas parfaitement
-compatible avec \pkg{hyperref}.
+L'extension \pkg{footnotehyper} est le successeur de l'extension \pkg{footnote} et devrait
+être utilisée préférentiellement. L'extension \pkg{footnote} a quelques défauts ; en
+particulier, elle doit être chargée après l'extension \pkg{xcolor} et elle n'est pas
+parfaitement compatible avec \pkg{hyperref}.
\medskip
-Dans ce document, l'extension \pkg{witharrows} a été chargée avec l'option |footnotehyper| et nous donnons un
-exemple avec une note de pied de page dans l'étiquette d'une flèche :
+Dans ce document, l'extension \pkg{witharrows} a été chargée avec l'option |footnotehyper|
+et nous donnons un exemple avec une note de pied de page dans l'étiquette d'une flèche :
\smallskip
@@ -2178,20 +2313,22 @@ A & = (a+b)^2
\bigskip
\subsection{L'option no-arrows}
-L'option |no-arrows| est une facilité donnée à l'utilisateur. Avec cette option,
-les flèches ne sont pas tracées. Néanmoins, une analyse des flèches est effectuée et certaines erreurs sont
-détectées (par exemple, si une flèche arrive après la dernière ligne de l'environnement).
+L'option \Definition{no-arrows} est une facilité donnée à l'utilisateur. Avec cette
+option, les flèches ne sont pas tracées. Néanmoins, une analyse des flèches est effectuée
+et certaines erreurs sont détectées (par exemple, si une flèche arrive après la dernière
+ligne de l'environnement).
\bigskip
\subsection{Note pour les utilisateurs de AUCTeX}
-Dans un éditeur de texte paramétré pour éditer du LaTeX, les environnements |{DispWithArrows}| et
-|{DispWithArrows*}| devraient être formatés comme l'environnement |{equation}| de LaTeX c'est-à-dire avec un
-formatage adapté au mode mathématique.
+Dans un éditeur de texte paramétré pour éditer du LaTeX, les environnements
+|{DispWithArrows}| et |{DispWithArrows*}| devraient être formatés comme l'environnement
+|{equation}| de LaTeX c'est-à-dire avec un formatage adapté au mode mathématique.
-Dans l'éditeur Emacs avec AUCTeX, cela se fait en ajoutant les chaînes |"DispWithArrows"| et |"DispWithArrows*"| à
-la variable |font-latex-math-environments|. On peut le faire en utilisant l'interface de personnalisation de Emacs :
+Dans l'éditeur Emacs avec AUCTeX, cela se fait en ajoutant les chaînes |"DispWithArrows"|
+et |"DispWithArrows*"| à la variable |font-latex-math-environments|. On peut le faire en
+utilisant l'interface de personnalisation de Emacs :
|M-x customize| > |[Text]| > |[TeX]| > |[Font LaTeX]|
@@ -2204,17 +2341,20 @@ Si vous définissez un environnement s'appuyant sur un environnement de
non |\begin{WithArrows}|--|\end{WithArrows}|, etc.).
\smallskip
-En faisant ainsi, les messages d'erreur affichés par \pkg{witharrows} mentionneront (le cas échéant) le nom de
-votre environnement et seront plus faciles à comprendre pour l'utilisateur final.
+En faisant ainsi, les messages d'erreur affichés par \pkg{witharrows} mentionneront (le
+cas échéant) le nom de votre environnement et seront plus faciles à comprendre pour
+l'utilisateur final.
\smallskip
-Par exemple, vous pouvez définir un environnement |{DWA}| qui va être un alias de |{DispWithArrows}|:
+Par exemple, vous pouvez définir un environnement |{DWA}| qui va être un alias de
+|{DispWithArrows}|:
\begin{BVerbatim}
\NewDocumentEnvironment {DWA} {} {\DispWithArrows}{\endDispWithArrows}
\end{BVerbatim}
\smallskip
-Si vous utilisez cet environnement |{DWA}| en mode mathématique, vous aurez le message d'erreur suivant :
+Si vous utilisez cet environnement |{DWA}| en mode mathématique, vous aurez le message
+d'erreur suivant :
\begin{BVerbatim}
The environment {DWA} should be used only outside math mode.
@@ -2236,51 +2376,52 @@ dans l'extension \pkg{witharrows} avec le code suivant:
\subsection{\textbackslash MoveEqLeft}
-Il est possible d'utiliser |\MoveEqLeft| de \pkg{mathtools}. Dans ce cas, on doit se souvenir que la commande
-|\MoveEqLeft| a aussi la valeur d'une esperluette (|&|). Il faut en tenir compte pour le positionnement
-d'une éventuelle commande |\Arrow|.
-
+Il est possible d'utiliser |\MoveEqLeft| de \pkg{mathtools}. Dans ce cas, on doit se
+souvenir que la commande |\MoveEqLeft| a aussi la valeur d'une esperluette (|&|). Il faut
+en tenir compte pour le positionnement d'une éventuelle commande |\Arrow|.
-%
-\begin{Verbatim}[formatcom=\small\color{gray}]
+\begingroup
+\small
+\begin{Code}
$\begin{WithArrows}[interline=0.5ex]
-~emphase#\MoveEqLeft@ \arccos(x) = \arcsin \frac45 + \arcsin \frac5{13}
-\Arrow{parce que les deux sont dans $[-\frac{\pi}2,\frac{\pi}2]$} \\
-& \Leftrightarrow x = \sin\left(\arcsin\frac45 + \arcsin\frac5{13}\right) \\
-& \Leftrightarrow x = \frac45\cos\arcsin\frac5{13} + \frac5{13} \cos\arcsin\frac45
+\emph{\MoveEqLeft} \arccos(x) = \arcsin \frac{4}{5} + \arcsin \frac{5}{13}
+\Arrow{parce que les deux sont dans $[-\frac{\pi}{2},\frac{\pi}{2}]$} \\
+& \Leftrightarrow x = \sin\left(\arcsin\frac{4}{5} + \arcsin\frac{5}{13}\right) \\
+& \Leftrightarrow x = \frac{4}{5}\cos\arcsin\frac{5}{13}+\frac{5}{13}\cos\arcsin\frac{4}{5}
\Arrow{$\forall x \in [-1,1], \cos(\arcsin x) = \sqrt{1-x^2}$} \\
-& \Leftrightarrow x = \frac45\sqrt{1-\bigl(\frac5{13}\bigr)^2}
-+ \frac5{13}\sqrt{1-\bigl(\frac45\bigr)^2}
+& \Leftrightarrow x = \frac{4}{5}\sqrt{1-\bigl(\frac{5}{13}\bigr)^2}
++ \frac{5}{13}\sqrt{1-\bigl(\frac{4}{5}\bigr)^2}
\end{WithArrows}$
-\end{Verbatim}
-
+\end{Code}
+\endgroup
\medskip
$\begin{WithArrows}[interline=0.5ex]
-\MoveEqLeft \arccos(x) = \arcsin \frac45 + \arcsin \frac5{13}
-\Arrow{parce que les deux sont dans \([-\frac{\pi}2,\frac{\pi}2]\)} \\
-& \Leftrightarrow x = \sin\left(\arcsin\frac45 + \arcsin\frac5{13}\right) \\
-& \Leftrightarrow x = \frac45\cos\arcsin\frac5{13} + \frac5{13} \cos\arcsin\frac45
+\MoveEqLeft \arccos(x) = \arcsin \frac{4}{5} + \arcsin \frac{5}{13}
+\Arrow{parce que les deux sont dans \([-\frac{\pi}{2},\frac{\pi}{2}]\)} \\
+& \Leftrightarrow x = \sin\left(\arcsin\frac{4}{5} + \arcsin\frac{5}{13}\right) \\
+& \Leftrightarrow x = \frac{4}{5}\cos\arcsin\frac{5}{13} + \frac{5}{13} \cos\arcsin\frac{4}{5}
\Arrow{\(\forall x \in [-1,1], \cos(\arcsin x) = \sqrt{1-x^2}\)} \\
-& \Leftrightarrow x = \frac45\sqrt{1-\bigl(\frac5{13}\bigr)^2}
-+ \frac5{13}\sqrt{1-\bigl(\frac45\bigr)^2}
+& \Leftrightarrow x = \frac{4}{5}\sqrt{1-\bigl(\frac{5}{13}\bigr)^2}
++ \frac{5}{13}\sqrt{1-\bigl(\frac{4}{5}\bigr)^2}
\end{WithArrows}$
\bigskip
\subsection{Une commande \textbackslash DoubleArrow}
-En utilisant l'option |o| (cf. p. \pageref{option-o}) disponible au niveau local, on peut facilement écrire une
-commande |\DoubleArrow| pour deux flèches allant en sens inverse l'une de l'autre.
+En utilisant l'option |o| (cf. p. \pageref{option-o}) disponible au niveau local, on peut
+facilement écrire une commande |\DoubleArrow| pour deux flèches allant en sens inverse
+l'une de l'autre.
\bigskip
-\begin{Verbatim}
+\begin{Code}
\NewDocumentCommand \DoubleArrow { O {} m m }
{
- \Arrow[tikz=->,~#1]{~#2}%
- \Arrow[o,tikz=<-,~#1]{~#3}
+ \Arrow[tikz=->,#1]{#2}%
+ \Arrow[o,tikz=<-,#1]{#3}
}
-\end{Verbatim}
+\end{Code}
\NewDocumentCommand \DoubleArrow { O {} m m }
@@ -2293,12 +2434,12 @@ commande |\DoubleArrow| pour deux flèches allant en sens inverse l'une de l'aut
\bigskip
Exemple d'utilisation :
-\begin{Verbatim}
+\begin{Code}
$\begin{WithArrows}[groups]
A & = (a+b)^2 \DoubleArrow[tikz={font=\bfseries}]{développement}{factorisation} \\
& = a^2 + 2ab+b^2
\end{WithArrows}$
-\end{Verbatim}
+\end{Code}
\bigskip
$\begin{WithArrows}[groups]
@@ -2315,22 +2456,22 @@ A & = (a+b)^2 \DoubleArrow[tikz={font=\bfseries}]{développement}{factorisation}
Il est possible de changer la forme des étiquettes, qui sont des nœuds Tikz, en
modifiant la clé «|every node|» de Tikz.
-\begin{Verbatim}
+\begin{Code}
\begin{WithArrows}%
[format = c,
interline = 4mm,
- tikz = {~emphase#every node/.style = {circle,@
- ~emphase# draw,@
- ~emphase# auto = false,@
- ~emphase# fill = gray!50,@
- ~emphase# inner sep = 1pt,@
- ~emphase# font = \tiny}@}]
+ tikz = {\emph{every node/.style = {circle,
+ draw,
+ auto = false,
+ fill = gray!50,
+ inner sep = 1pt,
+ font = \tiny}}}]
3 (2x+4) = 6 \Arrow{$\div 3$} \\
2x+4 = 2 \Arrow{$-4$} \\
2x = -2 \Arrow{$\div 2$} \\
2x = -1
\end{WithArrows}
-\end{Verbatim}
+\end{Code}
\[\begin{WithArrows}[%
format = c,
@@ -2358,9 +2499,9 @@ pour tracer les flèches.\footnote{Si un environnement |{DispWithArrows}| ou
environnements imbriqués à l'intérieur).}
\smallskip
-La valeur initiale de |tikz-code| est |\draw (#1) to node {#3} (#2) ;|
-où les trois marqueurs |#1|, |#2| et |#3| représentent le point de départ, le point d'arrivée
-et l'étiquette de la flèche.
+La valeur initiale de |tikz-code| est |\draw (#1) to node {#3} (#2) ;| où les trois
+marqueurs |#1|, |#2| et |#3| représentent le point de départ, le point d'arrivée et
+l'étiquette de la flèche.
\bigskip
@@ -2369,18 +2510,18 @@ Dans l'exemple suivant, nous définissons la valeur de |tikz-code| avec deux
instructions |\path| : la première instruction trace la flèche elle-même et la seconde
place l'étiquette dans un nœud Tikz dans le rectangle délimité par la flèche.
-\begin{Verbatim}
+\begin{Code}
\begin{DispWithArrows*}%
[displaystyle,
ygap = 2mm,
ystart = 0mm,
- ~emphase#tikz-code = {\draw (~#1) -- ++(4.5cm,0) |- (~#2) ;@
- ~emphase# \path (~#1) -- (~#2) @
- ~emphase# node[text width = 4.2cm, right, midway] {~#3} ;}@]
+ \emph{tikz-code = {\draw (#1) -- ++(4.5cm,0) |- (#2) ;
+ \path (#1) -- (#2)
+ node[text width = 4.2cm, right, midway] {#3} ;}}]
S_n
-& = \frac1n \sum_{k=0}^{n-1}\cos\bigl(\tfrac{\pi}2\cdot\tfrac kn\bigr)
+& = \frac{1}{n} \sum_{k=0}^{n-1}\cos\bigl(\tfrac{\pi}{2}\cdot\tfrac{k}{n}\bigr)
...........
-\end{Verbatim}
+\end{Code}
\bigskip
@@ -2392,49 +2533,50 @@ S_n
\path (#1) -- (#2)
node[text width = 4.2cm, right, midway] {#3} ;}]
S_n
-& = \frac1n \sum_{k=0}^{n-1}\cos\bigl(\tfrac{\pi}2\cdot\tfrac kn\bigr)
+& = \frac{1}{n} \sum_{k=0}^{n-1}\cos\bigl(\tfrac{\pi}{2}\cdot\tfrac kn\bigr)
\Arrow{$\cos x = \Re(e^{ix})$}\\
-& = \frac1n\sum_{k=0}^{n-1} \Re\left(e^{i\frac{k\pi}{2n}}\right)
+& = \frac{1}{n} \sum_{k=0}^{n-1} \Re\left(e^{i\frac{k\pi}{2n}}\right)
\Arrow{$\Re(z+z')=\Re(z)+\Re(z')$}\\
-& = \frac1n \Re\left(\sum_{k=0}^{n-1} e^{i\frac{k\pi}{2n}}\right)
+& = \frac{1}{n} \Re\left(\sum_{k=0}^{n-1} e^{i\frac{k\pi}{2n}}\right)
\Arrow{$\exp$ est un morphisme pour $\times$ et $+$} \\
-& = \frac1n \Re \left(\sum_{k=0}^{n-1}\bigl(e^{i\frac{\pi}{2n}}\bigr)^k\right)
+& = \frac{1}{n} \Re \left(\sum_{k=0}^{n-1}\bigl(e^{i\frac{\pi}{2n}}\bigr)^k\right)
\Arrow{somme de termes d'une suite géométrique de raison $e^{i\frac{2\pi}n}$}\\
-& = \frac1n \Re \left( \frac{1-\bigl(e^{i\frac{\pi}{2n}}\bigr)^n}{1-e^{i\frac{\pi}{2n}}}\right)\\
-& = \frac1n \Re \left(\frac{1-i}{1-e^{i\frac{\pi}{2n}}}\right)
+& = \frac{1}{n} \Re \left( \frac{1-\bigl(e^{i\frac{\pi}{2n}}\bigr)^n}{1-e^{i\frac{\pi}{2n}}}\right)\\
+& = \frac{1}{n} \Re \left(\frac{1-i}{1-e^{i\frac{\pi}{2n}}}\right)
\end{DispWithArrows*}
\bigskip
\subsubsection{Exemple 2}
\label{example-WithArrowsRightX}
-Il est possible de modifier l'exemple précédent pour avoir «|text width|» calculé automatiquement en fonction
-de la marge droite (d'une manière similaire à l'option |wrap-lines|) dans les environnements
-|{DispWithArrows}| et |{DispWithArrows*}|. Dans la définition de |tikz-code|, nous utilisons la commande
-|\WithArrowsRightX| qui donne l'abscisse de la marge droite de la boîte de composition (pour TeX, il s'agit d'une commande
-et non d'une dimension). Pour la lisibilité, nous avons utilisé un style de \pkg{witharrows}. Cet exemple nécessite
-l'extension Tikz \pkg{calc}.
-
-\begin{Verbatim}
+Il est possible de modifier l'exemple précédent pour avoir «|text width|» calculé
+automatiquement en fonction de la marge droite (d'une manière similaire à l'option
+|wrap-lines|) dans les environnements |{DispWithArrows}| et |{DispWithArrows*}|. Dans la
+définition de |tikz-code|, nous utilisons la commande |\WithArrowsRightX| qui donne
+l'abscisse de la marge droite de la boîte de composition (pour TeX, il s'agit d'une
+commande et non d'une dimension). Pour la lisibilité, nous avons utilisé un style de
+\pkg{witharrows}. Cet exemple nécessite l'extension Tikz \pkg{calc}.
+
+\begin{Code}
\WithArrowsNewStyle{MonStyle}
{displaystyle,
ygap = 2mm,
xoffset = 0pt,
ystart = 0mm,
- tikz-code = {\path let \p1 = (~#~#1)
- in (~#~#1)
+ tikz-code = {\path let \p1 = (#1)
+ in (#1)
-- node [anchor = west,
- text width = {~emphase#\WithArrowsRightX@ - \x1 - 0.5 em}]
- {~#~#3}
- (~#~#2) ;
- \draw let \p1 = (~#~#1)
- in (~#~#1) -- ++(~emphase#\WithArrowsRightX@ - \x1,0) |- (~#~#2) ; }}
-\end{Verbatim}
+ text width = {\emph{\WithArrowsRightX} - \x1 - 0.5 em}]
+ {#3}
+ (#2) ;
+ \draw let \p1 = (#1)
+ in (#1) -- ++(\emph{\WithArrowsRightX} - \x1,0) |- (#2) ; }}
+\end{Code}
\begin{Verbatim}
\begin{DispWithArrows}[MonStyle]
S_n
- & = \frac1n \sum_{k=0}^{n-1}\cos\bigl(\tfrac{\pi}2\cdot\tfrac kn\bigr)
+ & = \frac{1}{n} \sum_{k=0}^{n-1}\cos\bigl(\tfrac{\pi}{2}\cdot\tfrac{k}{n}\bigr)
\Arrow{$\cos x = \Re(e^{ix})$}\\
...........
\end{Verbatim}
@@ -2444,26 +2586,26 @@ l'extension Tikz \pkg{calc}.
ygap = 2mm,
xoffset = 0pt,
ystart = 0mm,
- tikz-code = {\path let \p1 = (##1)
- in (##1)
+ tikz-code = {\path let \p1 = (#1)
+ in (#1)
-- node [anchor = west,
- text width = {\WithArrowsRightX - \x1 - 0.5 em}] {##3}
- (##2) ;
- \draw let \p1 = (##1)
- in (##1) -- ++(\WithArrowsRightX - \x1,0) |- (##2) ; }}
+ text width = {\WithArrowsRightX - \x1 - 0.5 em}] {#3}
+ (#2) ;
+ \draw let \p1 = (#1)
+ in (#1) -- ++(\WithArrowsRightX - \x1,0) |- (#2) ; }}
\begin{DispWithArrows}[MonStyle]
S_n
-& = \frac1n \sum_{k=0}^{n-1}\cos\bigl(\tfrac{\pi}2\cdot\tfrac kn\bigr)
+& = \frac{1}{n} \sum_{k=0}^{n-1}\cos\bigl(\tfrac{\pi}{2}\cdot\tfrac{k}{n}\bigr)
\Arrow{$\cos x = \Re(e^{ix})$}\\
-& = \frac1n\sum_{k=0}^{n-1} \Re\left(e^{i\frac{k\pi}{2n}}\right)
+& = \frac{1}{n} \sum_{k=0}^{n-1} \Re\left(e^{i\frac{k\pi}{2n}}\right)
\Arrow{$\Re(z+z')=\Re(z)+\Re(z')$}\\
-& = \frac1n \Re\left(\sum_{k=0}^{n-1} e^{i\frac{k\pi}{2n}}\right)
+& = \frac{1}{n} \Re\left(\sum_{k=0}^{n-1} e^{i\frac{k\pi}{2n}}\right)
\Arrow{$\exp$ est un morphisme pour $\times$ et $+$} \\
-& = \frac1n \Re \left(\sum_{k=0}^{n-1}\bigl(e^{i\frac{\pi}{2n}}\bigr)^k\right)
+& = \frac{1}{n} \Re \left(\sum_{k=0}^{n-1}\bigl(e^{i\frac{\pi}{2n}}\bigr)^k\right)
\Arrow{somme de termes d'une suite géométrique $e^{i\frac{2\pi}n}$}\\
-& = \frac1n \Re \left( \frac{1-\bigl(e^{i\frac{\pi}{2n}}\bigr)^n}{1-e^{i\frac{\pi}{2n}}}\right)\\
-& = \frac1n \Re \left(\frac{1-i}{1-e^{i\frac{\pi}{2n}}}\right)
+& = \frac{1}{n} \Re \left( \frac{1-\bigl(e^{i\frac{\pi}{2n}}\bigr)^n}{1-e^{i\frac{\pi}{2n}}}\right)\\
+& = \frac{1}{n} \Re \left(\frac{1-i}{1-e^{i\frac{\pi}{2n}}}\right)
\end{DispWithArrows}
@@ -2471,27 +2613,28 @@ S_n
\bigskip
\subsubsection{Exemple 3}
-Dans l'exemple suivant, nous changeons la forme de la flèche selon que la rangée de départ est plus longue ou
-plus courte que la rangée d'arrivée. Cet exemple nécessite l'extension \pkg{calc} de Tikz.
+Dans l'exemple suivant, nous changeons la forme de la flèche selon que la rangée de départ
+est plus longue ou plus courte que la rangée d'arrivée. Cet exemple nécessite l'extension
+\pkg{calc} de Tikz.
-\begin{Verbatim}
+\begin{Code}
\begin{WithArrows}[ll,interline=5mm,xoffset=5mm,
- ~emphase#tikz-code = {\draw[rounded corners,@
- ~emphase# every node/.style = {circle,@
- ~emphase# draw,@
- ~emphase# auto = false,@
- ~emphase# inner sep = 1pt,@
- ~emphase# fill = gray!50,@
- ~emphase# font = \tiny }]@
- ~emphase# let \p1 = (~#1),@
- ~emphase# \p2 = (~#2)@
- ~emphase# and \ifdim \x1 > \x2@
- ~emphase# (\p1) -- node {~#3} (\x1,\y2) -- (\p2)@
- ~emphase# \else@
- ~emphase# (\p1) -- (\x2,\y1) -- node {~#3} (\p2)@
- ~emphase# \fi ;}@]
-E & \Longleftrightarrow \frac{(x+4)}3 + \frac{5x+3}5 = 7
+ \emph{tikz-code = {\draw[rounded corners,
+ every node/.style = {circle,
+ draw,
+ auto = false,
+ inner sep = 1pt,
+ fill = gray!50,
+ font = \tiny }]
+ let \p1 = (#1),
+ \p2 = (#2)
+ and \ifdim \x1 > \x2
+ (\p1) -- node {#3} (\x1,\y2) -- (\p2)
+ \else
+ (\p1) -- (\x2,\y1) -- node {#3} (\p2)
+ \fi ;}}]
+E & \Longleftrightarrow \frac{(x+4)}{3} + \frac{5x+3}{5} = 7
\Arrow{$\times 15$}\\
& \Longleftrightarrow 5(x+4) + 3(5x+3) = 105 \\
& \Longleftrightarrow 5x+20 + 15x+9 = 105 \\
@@ -2501,7 +2644,7 @@ E & \Longleftrightarrow \frac{(x+4)}3 + \frac{5x+3}5 = 7
\Arrow{$\div 20$}\\
& \Longleftrightarrow x = \frac{38}{10}
\end{WithArrows}
-\end{Verbatim}
+\end{Code}
\[\begin{WithArrows}[ll,interline=5mm,xoffset=5mm,
@@ -2519,7 +2662,7 @@ E & \Longleftrightarrow \frac{(x+4)}3 + \frac{5x+3}5 = 7
\else
(\p1) -- (\x2,\y1) -- node {#3} (\p2)
\fi ;}]
-E & \Longleftrightarrow \frac{(x+4)}3 + \frac{5x+3}5 = 7
+E & \Longleftrightarrow \frac{(x+4)}{3} + \frac{5x+3}{5} = 7
\Arrow{$\times 15$}\\
& \Longleftrightarrow 5(x+4) + 3(5x+3) = 105 \\
& \Longleftrightarrow 5x+20 + 15x+9 = 105 \\
@@ -2534,10 +2677,10 @@ E & \Longleftrightarrow \frac{(x+4)}3 + \frac{5x+3}5 = 7
\subsection{Boucle numérotée automatique}
-Supposons que nous voulions tracer une boucle avec des flèches numérotées. Dans ce but, il est
-possible d'écrire une commande dédiée |\NumberedLoop| qui fera le travail quand elle
-sera utilisée dans le |code-after|. Dans l'exemple suivant, nous avons écrit cette commande avec
-|\foreach| de \pkg{pgffor} (cette extension est chargée quand \pkg{witharrows} est chargé.).
+Supposons que nous voulions tracer une boucle avec des flèches numérotées. Dans ce but, il
+est possible d'écrire une commande dédiée |\NumberedLoop| qui fera le travail quand elle
+sera utilisée dans le |code-after|. Dans l'exemple suivant, nous avons écrit cette
+commande avec |\foreach| de \pkg{pgffor} (cette extension est chargée quand \pkg{witharrows} est chargé.).
\begin{Verbatim}
\NewDocumentCommand \NomberedLoop {}
@@ -2548,20 +2691,20 @@ sera utilisée dans le |code-after|. Dans l'exemple suivant, nous avons écrit c
\end{Verbatim}
La commande |\WithArrowsNbLines| est une commande disponible dans le |code-after| qui donne
-le nombre total de lignes (=rangées) dans l'environnement courant (pour TeX, il s'agit d'une commande et non d'un
-compteur).
+le nombre total de lignes (=rangées) dans l'environnement courant (pour TeX, il s'agit
+d'une commande et non d'un compteur).
-\bigskip
-\begin{Verbatim}
-$\begin{WithArrows}[~emphase#code-after = \NumberedLoop@]
+\medskip
+\begin{Code}
+$\begin{WithArrows}[\emph{code-after = \NumberedLoop}]
a.\;& f \text{ est continue sur } E \\
b.\;& f \text{ est continue en } 0 \\
c.\;& f \text{ est bornée sur la sphère unité} \\
d.\;& \exists K > 0\quad \forall x \in E\quad \|f(x)\| \le K \|x\| \\
e.\;& f \text{ est lipschitzienne}
\end{WithArrows}$
-\end{Verbatim}
+\end{Code}
\bigskip
\begin{scope}
@@ -2587,9 +2730,9 @@ avec l'option |tikz|. Néanmoins, si nous voulons changer le style pour avoir, p
exemple, les numéros entre parenthèses, le moyen le plus rapide est de changer la valeur de
|tikz-code|:
-\begin{Verbatim}
-tikz-code = {\draw (~#1) to node {\footnotesize (~#3)} (~#2) ;}
-\end{Verbatim}
+\begin{Code}
+tikz-code = {\draw (#1) to node {\footnotesize (#3)} (#2) ;}
+\end{Code}
\WithArrowsOptions{tikz-code = {\draw (#1) to node {\footnotesize (#3)} (#2) ;}}
@@ -2606,9 +2749,9 @@ e.\;& f \text{ est lipschitzienne}
\section*{Autre documentation}
-Le document |witharrows.pdf| (fourni avec l'extension \pkg{witharrows}) contient une traduction anglaise de la
-documentation ici présente, ainsi que le code source commenté et un historique des versions.
-
+Le document |witharrows.pdf| (fourni avec l'extension \pkg{witharrows}) contient une
+traduction anglaise de la documentation ici présente, ainsi que le code source commenté et
+un historique des versions.
\tableofcontents
diff --git a/macros/generic/witharrows/witharrows.dtx b/macros/generic/witharrows/witharrows.dtx
index 6f6ea4bf0e..301f44da3c 100644
--- a/macros/generic/witharrows/witharrows.dtx
+++ b/macros/generic/witharrows/witharrows.dtx
@@ -1,6 +1,6 @@
%\iffalse meta-comment
%
-% Copyright (C) 2017-2023 by F. Pantigny
+% Copyright (C) 2017-2024 by F. Pantigny
% -----------------------------------
%
% This file may be distributed and/or modified under the
@@ -15,8 +15,8 @@
%
% \fi
% \iffalse
-\def\myfileversion{2.8b}
-\def\myfiledate{2023/08/24}
+\def\myfileversion{2.9a}
+\def\myfiledate{2024/10/19}
%
%
%<*batchfile>
@@ -26,7 +26,7 @@
\usedir{tex/latex/witharrows}
\preamble
-Copyright (C) 2017-2023 by F. Pantigny
+Copyright (C) 2017-2024 by F. Pantigny
-----------------------------------
This file may be distributed and/or modified under the
@@ -47,18 +47,72 @@ version 2005/12/01 or later.
%<*driver>
\documentclass[dvipsnames]{l3doc}% dvipsnames is for xcolor (loaded by Tikz)
\VerbatimFootnotes
-\usepackage{xltxtra}
-\usepackage[xetex]{geometry}
+\usepackage{geometry}
\geometry{left=2.8cm,right=2.8cm,top=2.5cm,bottom=2.5cm,papersize={21cm,29.7cm}}
\usepackage[hyperfootnotes=false]{footnotehyper}
+\usepackage{fontspec}
\usepackage[footnotehyper]{witharrows}
\usetikzlibrary{calc}
\usepackage{mathtools}
\usepackage{amssymb}
\usepackage[only,llbracket,rrbracket]{stmaryrd}
\usepackage{varwidth}
+\usepackage{upquote}
\labelformat{equation}{(#1)}
\NewDocumentEnvironment {scope} {} {} {}
+
+\NewDocumentCommand{\Definition}{m}
+ {{\setlength{\fboxsep}{1pt}\colorbox{gray!20}{\ttfamily \vphantom{gl}#1}}}
+
+\NewDocumentCommand{\DefinitionCommand}{m}
+ {{\setlength{\fboxsep}{1pt}\colorbox{gray!20}{\ttfamily
+ \vphantom{gl}\textbackslash #1}}}
+
+
+\usepackage{piton}
+\PitonOptions
+ {
+ language = verbatim ,
+ detected-commands = {emph,textsl} ,
+ splittable = 4
+ }
+
+\SetPitonStyle{ Number = , Comment = }
+
+\ExplSyntaxOn
+
+\dim_new:N \l__pantigny_width_dim
+
+\keys_define:nn { pantigny }
+ { width .dim_set:N = \l__pantigny_width_dim }
+
+\NewPitonEnvironment { Code } { O { } }
+ {
+ \medskip
+ \char_set_catcode_other:N |
+ \cs_set_eq:NN \emph \emphase
+ \dim_zero:N \l__pantigny_width_dim
+ \keys_set:nn { pantigny } { #1 }
+ \color{gray}
+ \PitonOptions { gobble = 2 }
+ \dim_compare:nNnT \l__pantigny_width_dim > \c_zero_dim
+ {
+ \PitonOptions { width = \l__pantigny_width_dim }
+ \begin{minipage}[c]{\l__pantigny_width_dim}
+ }
+ }
+ {
+ \dim_compare:nNnT \l__pantigny_width_dim > \c_zero_dim
+ { \end{minipage} }
+ \medskip
+ }
+
+\ExplSyntaxOff
+
+
+
+
+
\def\interitem{\vspace{7mm plus 2 mm minus 3mm}}
\def\emphase{\bgroup\color{RoyalPurple}\let\next=}
\fvset{commandchars=\~\#\@,formatcom={\color{gray}}}
@@ -72,9 +126,10 @@ version 2005/12/01 or later.
%</driver>
% \fi
% \VerbatimFootnotes
-% \title{The package \pkg{witharrows} for plain-TeX and LaTeX\thanks{This document corresponds to the
-% version~\myfileversion\space of \pkg{witharrows}, at the date
-% of~\myfiledate.}} \author{F. Pantigny \\ \texttt{fpantigny@wanadoo.fr}}
+% \title{The package \pkg{witharrows} for plain-TeX and LaTeX\thanks{This
+% document corresponds to the version~\myfileversion\space of \pkg{witharrows},
+% at the date of~\myfiledate.}} \author{F. Pantigny \\
+% \texttt{fpantigny@wanadoo.fr}}
%
% \maketitle
%
@@ -110,11 +165,14 @@ version 2005/12/01 or later.
% follows, we describe the LaTeX package.
%
% \medskip
+
% This package can be used with |xelatex|, |lualatex|, |pdflatex| but also by
-% the classical workflow |latex|-|dvips|-|ps2pdf| (or Adobe Distiller). This
-% package loads the packages \pkg{l3keys2e}, \pkg{varwidth}, \pkg{tikz} and the
-% Tikz libraries \pkg{arrows.meta} and \pkg{bending}. The final user only has to
-% load the package with the classical instruction: |\usepackage{witharrows}|.
+% the classical workflow |latex|-|dvips|-|ps2pdf| (or Adobe Distiller).
+% \textsl{However, the file witharrows.dtx of the present documentation should
+% be compiled with LuaLaTeX.} This package loads the packages \pkg{l3keys2e},
+% \pkg{varwidth}, \pkg{tikz} and the Tikz libraries \pkg{arrows.meta} and
+% \pkg{bending}. The final user only has to load the package with the classical
+% instruction: |\usepackage{witharrows}|.
%
% \medskip
% The arrows are drawn with Tikz and that's why \textbf{several compilations may
@@ -122,15 +180,15 @@ version 2005/12/01 or later.
% a number compilations sufficient (by using |latexmk|).}
%
% \bigskip
-% This package provides an environment |{WithArrows}| to construct alignments of
-% equations with arrows for the explanations on the right side:
+% This package provides an environment \Definition{\{WithArrows\}} to construct
+% alignments of equations with arrows for the explanations on the right side:
%
-% \begin{Verbatim}
+% \begin{Code}
% $\begin{WithArrows}
-% A & = (a+1)^2 ~emphase#\Arrow{we expand}@ \\
+% A & = (a+1)^2 \emph{\Arrow{we expand}} \\
% & = a^2 + 2a + 1 % <------- don't put \\ here
% \end{WithArrows}$
-% \end{Verbatim}
+% \end{Code}
%
% $\begin{WithArrows}
% A & = (a+1)^2 \Arrow{we expand} \\
@@ -140,16 +198,17 @@ version 2005/12/01 or later.
%
%
% \medskip
-% The arrow has been drawn with the command |\Arrow| on the row from which it
-% starts. The command |\Arrow| must be used in the second column (the best way
-% is to put it at the end of the second cell of the row as in the previous
-% example).
+% The arrow has been drawn with the command \DefinitionCommand{Arrow} on the row
+% from which it starts. The command |\Arrow| must be used in the second column
+% (the best way is to put it at the end of the second cell of the row as in the
+% previous example).
%
% \medskip
% The environment |{WithArrows}| bears similarities with the environment
% |{aligned}| of \pkg{amsmath} (and |mathtools|). The extension \pkg{witharrows}
-% also provides an environment |{DispWithArrows}| which is similar to the
-% environment |{align}| of \pkg{amsmath}: cf. p. \pageref{DispWithArrows}.
+% also provides two environments |{DispWithArrows}| and |{DispWithArrows*}|
+% which are similar to the environments |{align}| and |{align*}| of the package
+% \pkg{amsmath}: cf. p. \pageref{DispWithArrows}.
%
%
% \section{Options for the shape of the arrows}
@@ -157,19 +216,20 @@ version 2005/12/01 or later.
% The command |\Arrow| has several options. These options can be put between
% square brackets, before, or after the mandatory argument.
%
-% The option |jump| gives the number\footnote{It's not possible to give a
-% non-positive value to |jump|. See below (p.~\pageref{Backwards}) the way to
-% draw an arrow which goes backwards.} of rows the arrow must jump (the default
-% value is, of course,~$1$).
+% \medskip
+% The option \Definition{jump} gives the number\footnote{It's not possible to
+% give a non-positive value to |jump|. See below (p.~\pageref{Backwards}) the
+% way to draw an arrow which goes backwards.} of rows the arrow must jump (the
+% default value is, of course,~$1$).
%
%
-% \begin{Verbatim}
+% \begin{Code}
% $\begin{WithArrows}
-% A & = \bigl((a+b)+1\bigr)^2 \Arrow[~emphase#jump=2@]{we expand} \\
+% A & = \bigl((a+b)+1\bigr)^2 \Arrow[\emph{jump=2}]{we expand} \\
% & = (a+b)^2 + 2(a+b) +1 \\
% & = a^2 + 2ab + b^2 + 2a + 2b +1
% \end{WithArrows}$
-% \end{Verbatim}
+% \end{Code}
%
% $\begin{WithArrows}
% A & = \bigl((a+b)+1\bigr)^2 \Arrow[jump=1+1]{we expand} \\
@@ -179,13 +239,13 @@ version 2005/12/01 or later.
%
% \interitem
% It's possible to put several arrows starting from the same row.
-% \begin{Verbatim}
+% \begin{Code}
% $\begin{WithArrows}
-% A & = \bigl((a+b)+1\bigr)^2 ~emphase#\Arrow{}\Arrow{}[jump=2]@ \\
+% A & = \bigl((a+b)+1\bigr)^2 \emph{\Arrow{}\Arrow{}[jump=2]} \\
% & = (a+b)^2 + 2(a+b) +1 \\
% & = a^2 + 2ab + b^2 + 2a + 2b +1
% \end{WithArrows}$
-% \end{Verbatim}
+% \end{Code}
%
% $\begin{WithArrows}
% A & = \bigl((a+b)+1\bigr)^2 \Arrow{}\Arrow{}[jump=2] \\
@@ -194,15 +254,16 @@ version 2005/12/01 or later.
% \end{WithArrows}$
%
% \interitem
-% The option |xoffset| shifts the arrow to the right (we usually don't want the
-% arrows to be stucked on the text). The initial value of |xoffset| is $3$~mm.
-% \begin{Verbatim}
+% The option \Definition{xoffset} shifts the arrow to the right (we usually
+% don't want the arrows to be stucked on the text). The initial value of
+% |xoffset| is $3$~mm.
+% \begin{Code}
% $\begin{WithArrows}
% A & = \bigl((a+b)+1\bigr)^2
-% \Arrow[~emphase#xoffset=1cm@]{with \texttt{xoffset=1cm}} \\
+% \Arrow[\emph{xoffset=1cm}]{with \texttt{xoffset=1cm}} \\
% & = (a+b)^2 + 2(a+b) +1
% \end{WithArrows}$
-% \end{Verbatim}
+% \end{Code}
%
% $\begin{WithArrows}
% A & = \bigl((a+b)+1\bigr)^2
@@ -213,15 +274,15 @@ version 2005/12/01 or later.
%
% \interitem
% The arrows are drawn with Tikz. That's why the command |\Arrow| has an option
-% |tikz| which can be used to give to the arrow (in fact, the command |\path| of
-% Tikz) the options proposed by Tikz for such an arrow. The following example
-% gives an thick arrow.
-% \begin{Verbatim}
+% \Definition{tikz} which can be used to give to the arrow (in fact, the command
+% |\path| of Tikz) the options proposed by Tikz for such an arrow. The following
+% example gives an thick arrow.
+% \begin{Code}
% $\begin{WithArrows}
-% A & = (a+1)^2 \Arrow[~emphase#tikz=thick@]{we expand} \\
+% A & = (a+1)^2 \Arrow[\emph{tikz=thick}]{we expand} \\
% & = a^2 + 2a + 1
% \end{WithArrows}$
-% \end{Verbatim}
+% \end{Code}
%
% $\begin{WithArrows}
% A & = (a+1)^2 \Arrow[tikz=thick]{we expand} \\
@@ -233,12 +294,12 @@ version 2005/12/01 or later.
% which goes backwards with the Tikz option~|<-|.
% \label{Backwards}
%
-% \begin{Verbatim}
+% \begin{Code}
% $\begin{WithArrows}
-% A & = (a+1)^2 \Arrow~emphase#[tikz=<-]@{we factorize} \\
+% A & = (a+1)^2 \Arrow\emph{[tikz=<-]}{we factorize} \\
% & = a^2 + 2a + 1
% \end{WithArrows}$
-% \end{Verbatim}
+% \end{Code}
%
% $\begin{WithArrows}
% A & = (a+1)^2 \Arrow[tikz=<-]{we factorize} \\
@@ -248,12 +309,12 @@ version 2005/12/01 or later.
% \interitem
% It's also possible to suppress both tips of the arrow with the Tikz option
% ``|-|''.
-% \begin{Verbatim}
+% \begin{Code}
% $\begin{WithArrows}
-% A & = (a+1)^2 \Arrow[~emphase#tikz=-@]{very classical} \\
+% A & = (a+1)^2 \Arrow[\emph{tikz=-}]{very classical} \\
% & = a^2 + 2a + 1
% \end{WithArrows}$
-% \end{Verbatim}
+% \end{Code}
%
% $\begin{WithArrows}
% A & = (a+1)^2 \Arrow[tikz=-]{very classical} \\
@@ -263,12 +324,12 @@ version 2005/12/01 or later.
% \interitem
% In order to have straight arrows instead of curved ones, we must use the Tikz
% option ``|bend left = 0|''.
-% \begin{Verbatim}
+% \begin{Code}
% $\begin{WithArrows}
-% A & = (a+1)^2 \Arrow~emphase#[tikz={bend left=0}]@{we expand} \\
+% A & = (a+1)^2 \Arrow\emph{[tikz={bend left=0}]}{we expand} \\
% & = a^2 + 2a + 1
% \end{WithArrows}$
-% \end{Verbatim}
+% \end{Code}
%
% $\begin{WithArrows}
% A & = (a+1)^2 \Arrow[tikz={bend left=0}]{we expand} \\
@@ -286,14 +347,14 @@ version 2005/12/01 or later.
% \setcounter{fnnohyphen}{\thefootnote}
%
% %
-% \begin{Verbatim}
+% \begin{Code}
% $\begin{WithArrows}
% A & = \bigl((a+b)+1\bigr)^2
-% \Arrow[jump=2,~emphase#tikz={text width=5.3cm}@]{We have done...} \\
+% \Arrow[jump=2,\emph{tikz={text width=5.3cm}}]{We have done...} \\
% & = (a+b)^2 + 2(a+b) +1 \\
% & = a^2 + 2ab + b^2 + 2a + 2b +1
% \end{WithArrows}$
-% \end{Verbatim}
+% \end{Code}
%
% $\begin{WithArrows}
% A & = \bigl((a+b)+1\bigr)^2
@@ -318,12 +379,12 @@ version 2005/12/01 or later.
% beginning of the text, we won't suppress the |\small| and the |\itshape| and
% we will consequently have a text in a bold, italic and small font.
% %
-% \begin{Verbatim}
+% \begin{Code}
% $\begin{WithArrows}
-% A & = (a+1)^2 \Arrow{~emphase#\bfseries@ we expand} \\
+% A & = (a+1)^2 \Arrow{\emph{\bfseries} we expand} \\
% & = a^2 + 2a + 1
% \end{WithArrows}$
-% \end{Verbatim}
+% \end{Code}
%
% $\begin{WithArrows}
% A & = (a+1)^2 \Arrow{\bfseries we expand} \\
@@ -336,17 +397,17 @@ version 2005/12/01 or later.
% the nodes are created with the option |align=left|, and, thus, it becomes
% possible.}. However, if we put a |\\| , a command of font placed in the
% beginning of the text will have effect only until the first command |\\| (like
-% in an environment |{tabular}|). That's why Tikz gives an option |font| to
-% modify the font of the whole text. Nevertheless, if we use the option
-% |tikz={font={\bfseries}}|, the default specification of |\small| and
-% |\itshape| will be overwritten.
+% in an environment |{tabular}|). That's why Tikz provides an option
+% \Definition{font} to modify the font of the whole text. Nevertheless, if we
+% use the option |tikz={font={\bfseries}}|, the default specification of
+% |\small| and |\itshape| will be overwritten.
% %
-% \begin{Verbatim}
+% \begin{Code}
% $\begin{WithArrows}
-% A & = (a+1)^2 \Arrow[~emphase#tikz={font={\bfseries}}@]{we expand} \\
+% A & = (a+1)^2 \Arrow[\emph{tikz={font={\bfseries}}}]{we expand} \\
% & = a^2 + 2a + 1
% \end{WithArrows}$
-% \end{Verbatim}
+% \end{Code}
%
% $\begin{WithArrows}
% A & = (a+1)^2 \Arrow[tikz={font={\bfseries}}]{we expand} \\
@@ -366,13 +427,13 @@ version 2005/12/01 or later.
% nested environments |{WithArrows}| (with the logical exceptions of
% |interline|, |code-before| and |code-after|).}
% %
-% \begin{Verbatim}
-% $\begin{WithArrows}[~emphase#tikz=blue@]
+% \begin{Code}
+% $\begin{WithArrows}[\emph{tikz=blue}]
% A & = \bigl((a+b)+1\bigr)^2 \Arrow{first expansion.} \\
% & = (a+b)^2 + 2(a+b) +1 \Arrow{second expansion.} \\
% & = a^2 + 2ab + b^2 + 2a + 2b +1
% \end{WithArrows}$
-% \end{Verbatim}
+% \end{Code}
%
% $\begin{WithArrows}[tikz=blue]
% A & = \bigl((a+b)+1\bigr)^2 \Arrow{first expansion.} \\
@@ -382,9 +443,9 @@ version 2005/12/01 or later.
%
%
% \interitem
-% The environment |{WithArrows}| has an option |displaystyle|. With this option,
-% all the elements are composed in |\displaystyle| (like in an environment
-% |{aligned}| of \pkg{amsmath}).
+% The environment |{WithArrows}| has an option \Definition{displaystyle}. With
+% this option, all the elements are composed in |\displaystyle| (like in an
+% environment |{aligned}| of \pkg{amsmath}).
%
% \medskip
% Without the option |displaystyle|:
@@ -395,8 +456,8 @@ version 2005/12/01 or later.
% & = \int_0^1 (x^2+2x+1) dx
% \Arrow{linearity of integration} \\
% & = \int_0^1 x^2 dx + 2 \int_0^1 x dx + \int_0^1 dx \\
-% & = \frac13 + 2\frac12 + 1 \\
-% & = \frac73
+% & = \frac{1}{3} + 2\frac{1}{2} + 1 \\
+% & = \frac{7}{3}
% \end{WithArrows}$
% \end{Verbatim}
%
@@ -405,8 +466,8 @@ version 2005/12/01 or later.
% & = \int_0^1 (x^2+2x+1) dx
% \Arrow{linearity of integration} \\
% & = \int_0^1 x^2 dx + 2 \int_0^1 x dx + \int_0^1 dx \\
-% & = \frac13 + 2\frac12 + 1 \\
-% & = \frac73
+% & = \frac{1}{3} + 2\frac{1}{2} + 1 \\
+% & = \frac{7}{3}
% \end{WithArrows}$
%
%
@@ -418,33 +479,33 @@ version 2005/12/01 or later.
% & = \int_0^1 (x^2+2x+1) dx
% \Arrow{linearity of integration} \\
% & = \int_0^1 x^2 dx + 2 \int_0^1 x dx + \int_0^1 dx \\
-% & = \frac13 + 2\frac12 + 1 \\
-% & = \frac73
+% & = \frac{1}{3} + 2\frac{1}{2} + 1 \\
+% & = \frac{7}{3}
% \end{WithArrows}$
%
%
%
% \interitem
% Almost all the options can also be set at the document level with the command
-% |\WithArrowsOptions|. In this case, the scope of the declarations is the
-% current TeX group (these declarations are ``semi-global''). For example, if we
-% want all the environments |{WithArrows}| composed in |\displaystyle| with blue
-% arrows, we can write
+% \DefinitionCommand{WithArrowsOptions}. In this case, the scope of the
+% declarations is the current TeX group (these declarations are
+% ``semi-global''). For example, if we want all the environments |{WithArrows}|
+% composed in |\displaystyle| with blue arrows, we can write
% |\WithArrowsOptions{displaystyle,tikz=blue}|.\footnote{It's also possible to
% configure \pkg{witharrows} by modifying the Tikz style |WithArrows/arrow|
% which is the style used by \pkg{witharrows} when drawing an arrow. For
% example, to have the labels in blue with roman (upright) types, one can use
% the following instruction:
-% |\tikzset{WithArrows/arrow/.append style = {blue,font = {}}}|.}
+% |\tikzset{WithArrows/arrow/.append style = {blue,font = {}}}|.}
%
-% \begin{Verbatim}
-% ~emphase#\WithArrowsOptions{displaystyle,tikz=blue}@
+% \begin{Code}
+% \emph{\WithArrowsOptions{displaystyle,tikz=blue}}
% $\begin{WithArrows}
% \sum_{i=1}^n (x_i+1)^2
% & = \sum_{i=1}^n (x_i^2+2x_i+1) \Arrow{by linearity}\\
% & = \sum_{i=1}^n x_i^2 + 2\sum_{i=1}^nx_i+ n
% \end{WithArrows}$
-% \end{Verbatim}
+% \end{Code}
%
% \begin{scope}
% \WithArrowsOptions{displaystyle,tikz=blue}
@@ -464,18 +525,18 @@ version 2005/12/01 or later.
% However, a previouly defined command |\Arrow| may still be useful in an
% environment |{WithArrows}|. If we want to use it in such an environment, it's
% possible to change the name of the command |\Arrow| of the package
-% \pkg{witharrows}: there is an option |command-name| for this purpose.
-% The new name of the command must be given to the option \emph{without} the
-% leading backslash.
+% \pkg{witharrows}: there is an option \Definition{command-name} for this
+% purpose. The new name of the command must be given to the option
+% \emph{without} the leading backslash.
% %
-% \begin{Verbatim}
+% \begin{Code}
% \NewDocumentCommand {\Arrow} {} {\longmapsto}
-% $\begin{WithArrows}[~emphase#command-name=Explanation@]
+% $\begin{WithArrows}[\emph{command-name=Explanation}]
% f & = \bigl(x \Arrow (x+1)^2\bigr)
-% ~emphase#\Explanation{we work directly on fonctions}@\\
+% \emph{\Explanation{we work directly on fonctions}}\\
% & = \bigl(x \Arrow x^2+2x+1\bigr)
% \end{WithArrows}$
-% \end{Verbatim}
+% \end{Code}
% %
% \begin{scope}
% \NewDocumentCommand {\Arrow} {} {\longmapsto}
@@ -488,18 +549,18 @@ version 2005/12/01 or later.
%
%
% \interitem
-% The environment |{WithArrows}| provides also two options |code-before| and
-% |code-after| for LaTeX code that will be executed at the beginning and at the
-% end of the environment. These options are not designed to be hooks (they are
-% available only at the environment level and they do not apply to the nested
-% environments).
+% The environment |{WithArrows}| provides also two options
+% \Definition{code-before} and \Definition{code-after} for LaTeX code that will
+% be executed at the beginning and at the end of the environment. These options
+% are not designed to be hooks (they are available only at the environment level
+% and they do not apply to the nested environments).
% %
-% \begin{Verbatim}
-% $\begin{WithArrows}[~emphase#code-before = \color{blue}@]
+% \begin{Code}
+% $\begin{WithArrows}[\emph{code-before = \color{blue}}]
% A & = (a+b)^2 \Arrow{we expand} \\
% & = a^2 + 2ab + b^2
% \end{WithArrows}$
-% \end{Verbatim}
+% \end{Code}
%
% $\begin{WithArrows}[code-before = \color{blue}]
% A & = (a+b)^2 \Arrow{we expand} \\
@@ -507,20 +568,21 @@ version 2005/12/01 or later.
% \end{WithArrows}$
%
% \medskip
-% Special commands are available in |code-after|: a command |\WithArrowsNbLines|
-% which gives the number of lines (=rows) of the current environment (this is a
-% command and not a counter), a special form of the command |\Arrow| and the
-% command |\MultiArrow|: these commands are described in the section concerning
-% the nested environments, p.~\pageref{NestedEnv}.
+% Special commands are available in |code-after|: a command
+% \DefinitionCommand{WithArrowsNbLines} which gives the number of lines (=rows)
+% of the current environment (this is a command and not a counter), a special
+% form of the command |\Arrow| and the command |\MultiArrow|: the latter two
+% commands are described in the section concerning the nested environments,
+% p.~\pageref{NestedEnv}.
%
% \interitem
% \section{Numbers of columns}
%
% So far, we have used the environment |{WithArrows}| with two columns. However,
% it's possible to use the environment with an arbitrary number of columns with
-% the option |format|. The value given to this option is like the preamble of an
-% environment |{array}|, that is to say a sequence of letters |r|, |c| and |l|,
-% but also |R|, |C| and |L|.
+% the option \Definition{format}. The value given to this option is like the
+% preamble of an environment |{array}|, that is to say a sequence of letters
+% |r|, |c| and |l|, but also |R|, |C| and |L|.
%
% \smallskip
% The letters |R|, |C| and |L| add empty groups |{}| which provide correct
@@ -532,14 +594,15 @@ version 2005/12/01 or later.
% The initial value of the parameter |format| is, in fact, |rL|.
%
% \bigskip
-% For exemple, if we want only one column left-aligned, we use the option |format=l|.
-% \begin{Verbatim}
-% $\begin{WithArrows}[~emphase#format = l@]
+% For exemple, if we want only one column left-aligned, we use the option
+% |format=l|.
+% \begin{Code}
+% $\begin{WithArrows}\emph{[format = l]}
% f(x) \ge g(x) \Arrow{by squaring both sides} \\
% f(x)^2 \ge g(x)^2 \Arrow{by moving to left side} \\
% f(x)^2 - g(x)^2 \ge 0
% \end{WithArrows}$
-% \end{Verbatim}
+% \end{Code}
%
% $\begin{WithArrows}[format = l]
% f(x) \ge g(x) \Arrow{by squaring both sides} \\
@@ -551,8 +614,8 @@ version 2005/12/01 or later.
% In the following example, we use five columns all centered (the environment
% |{DispWithArrows*}| is presented p.~\pageref{DispWithArrows}).
%
-% \begin{Verbatim}
-% \begin{DispWithArrows*}[~emphase#format = cCcCc@,
+% \begin{Code}
+% \begin{DispWithArrows*}[\emph{format = cCcCc},
% wrap-lines,
% interline=1mm]
% k & \;\le\; & t & \;\le\; & k+1 \\
@@ -563,7 +626,7 @@ version 2005/12/01 or later.
% & \le & \int\limits_k^{k+1} \frac{dt}{k} \\
% \frac{1}{k+1} & \le & \ln(k+1)-\ln(k) & \le & \frac{1}{k}
% \end{DispWithArrows*}
-% \end{Verbatim}
+% \end{Code}
% \begin{DispWithArrows*}[format = cCcCc,
% wrap-lines,
% interline=1mm]
@@ -583,22 +646,22 @@ version 2005/12/01 or later.
%
% The environment |{WithArrows}| defines, during the composition of the array,
% two series of nodes materialized in red in the following example.\footnote{The
-% option |show-nodes| can be used to materialize the nodes. The nodes are in
-% fact Tikz nodes of shape ``rectangle'', but with zero width. An arrow between
-% two nodes starts at the \emph{south} anchor of the first node and arrives at
-% the \emph{north} anchor of the second node.}
+% option \Definition{show-nodes} can be used to materialize the nodes. The nodes
+% are in fact Tikz nodes of shape ``rectangle'', but with zero width. An arrow
+% between two nodes starts at the \emph{south} anchor of the first node and
+% arrives at the \emph{north} anchor of the second node.}
%
% \smallskip
% $\begin{WithArrows}[displaystyle,show-nodes]
% I
-% & = \int_{\frac{\pi}4}^0 \ln\Bigl(1+\tan\left(\tfrac{\pi}4-u\right)\Bigr)(-d u) \\
-% & = \int_0^{\frac{\pi}4} \ln\Bigl(1+\tan\left(\tfrac{\pi}4-u\right)\Bigr)d u \\
-% & = \int_0^{\frac{\pi}4}\ln\left(1+\frac{1-\tan u}{1+\tan u}\right)\, d u \\
-% & =\int_0^{\frac{\pi}4}\ln\left(\frac{1+\tan u+1-\tan u}{1+\tan u}\right) d u \\
-% & =\int_0^{\frac{\pi}4} \ln\left(\frac2{1+\tan u}\right)\, d u\\
-% & =\int_0^{\frac{\pi}4}\bigl(\ln2-\ln(1+\tan u)\bigr)\, d u \\
-% & =\frac{\pi}4\ln2-\int_0^{\frac{\pi}4}\ln(1+\tan u)\, d u \\
-% & =\frac{\pi}4\ln2-I
+% & = \int_{\frac{\pi}{4}}^0 \ln\Bigl(1+\tan\left(\tfrac{\pi}{4}-u\right)\Bigr)(-d u) \\
+% & = \int_0^{\frac{\pi}{4}} \ln\Bigl(1+\tan\left(\tfrac{\pi}{4}-u\right)\Bigr)d u \\
+% & = \int_0^{\frac{\pi}{4}}\ln\left(1+\frac{1-\tan u}{1+\tan u}\right)\, d u \\
+% & =\int_0^{\frac{\pi}{4}}\ln\left(\frac{1+\tan u+1-\tan u}{1+\tan u}\right) d u \\
+% & =\int_0^{\frac{\pi}{4}} \ln\left(\frac{2}{1+\tan u}\right)\, d u\\
+% & =\int_0^{\frac{\pi}{4}}\bigl(\ln2-\ln(1+\tan u)\bigr)\, d u \\
+% & =\frac{\pi}{4}\ln2-\int_0^{\frac{\pi}{4}}\ln(1+\tan u)\, d u \\
+% & =\frac{\pi}{4}\ln2-I
% \end{WithArrows}$
%
% \bigskip
@@ -606,47 +669,49 @@ version 2005/12/01 or later.
% called \emph{left nodes}. The nodes of the right side are aligned vertically
% on the right side of the array. These nodes will be called \emph{right nodes}.
%
-% By default, the arrows use the right nodes. We will say that they are in |rr|
-% mode ($r$ for \emph{right}). These arrows are vertical (we will say that an
-% arrow is \emph{vertical} when its two ends have the same abscissa).
+% By default, the arrows use the right nodes. We will say that they are in
+% \Definition{rr} mode ($r$ for \emph{right}). These arrows are vertical (we
+% will say that an arrow is \emph{vertical} when its two ends have the same
+% abscissa).
%
%
% \smallskip
% However, it's possible to use the left nodes, or a combination of left and
-% right nodes, with one of the options |lr|, |rl| and |ll| ($l$ for
-% \emph{left}). Those arrows are, usually, not vertical.
+% right nodes, with one of the options \Definition{lr}, \Definition{rl} and
+% \Definition{ll} ($l$ for \emph{left}). Those arrows are, usually, not vertical.
%
%
% Therefore
% $\begin{WithArrows}[displaystyle]
% I
-% & = \int_{\frac{\pi}4}^0 \ln\Bigl(1+\tan\left(\tfrac{\pi}4-u\right)\Bigr)(-d u)
+% & = \int_{\frac{\pi}{4}}^0 \ln\Bigl(1+\tan\left(\tfrac{\pi}{4}-u\right)\Bigr)(-d u)
% \Arrow[lr]{This arrow uses the |lr| option.}\\
-% & = \int_0^{\frac{\pi}4} \ln\Bigl(1+\tan\left(\tfrac{\pi}4-u\right)\Bigr)d u \\
-% & = \int_0^{\frac{\pi}4}\ln\left(1+\frac{1-\tan u}{1+\tan u}\right)\, d u \\
-% & =\int_0^{\frac{\pi}4}\ln\left(\frac{1+\tan u+1-\tan u}{1+\tan u}\right) d u
+% & = \int_0^{\frac{\pi}{4}} \ln\Bigl(1+\tan\left(\tfrac{\pi}{4}-u\right)\Bigr)d u \\
+% & = \int_0^{\frac{\pi}{4}}\ln\left(1+\frac{1-\tan u}{1+\tan u}\right)\, d u \\
+% & =\int_0^{\frac{\pi}{4}}\ln\left(\frac{1+\tan u+1-\tan u}{1+\tan u}\right) d u
% \Arrow[ll,jump=2,tikz={text width = 5cm}]{This arrow uses a |ll| option
% and a |jump| equal to $2$}\\
-% & =\int_0^{\frac{\pi}4} \ln\left(\frac2{1+\tan u}\right)\, d u\\
-% & =\int_0^{\frac{\pi}4}\bigl(\ln2-\ln(1+\tan u)\bigr)\, d u \\
-% & =\frac{\pi}4\ln2-\int_0^{\frac{\pi}4}\ln(1+\tan u)\, d u \\
-% & =\frac{\pi}4\ln2-I
+% & =\int_0^{\frac{\pi}{4}} \ln\left(\frac{2}{1+\tan u}\right)\, d u\\
+% & =\int_0^{\frac{\pi}{4}}\bigl(\ln2-\ln(1+\tan u)\bigr)\, d u \\
+% & =\frac{\pi}{4}\ln2-\int_0^{\frac{\pi}{4}}\ln(1+\tan u)\, d u \\
+% & =\frac{\pi}{4}\ln2-I
% \end{WithArrows}$
%
%
%
% \interitem
-% There is also an option called |i| (\emph{i} for \emph{intermediate}). With
-% this option, the arrow is vertical and at the leftmost position.
+% There is also an option called \Definition{i} (\emph{i} for
+% \emph{intermediate}). With this option, the arrow is vertical and at the
+% leftmost position.
%
-% \begin{Verbatim}
+% \begin{Code}
% $\begin{WithArrows}
% (a+b)(a+ib)(a-b)(a-ib)
% & = (a+b)(a-b)\cdot(a+ib)(a-ib) \\
-% & = (a^2-b^2)(a^2+b^2) \Arrow~emphase#[i]@{because $(x-y)(x+y)=x^2-y^2$}\\
+% & = (a^2-b^2)(a^2+b^2) \Arrow\emph{[i]}{because $(x-y)(x+y)=x^2-y^2$}\\
% & = a^4-b^4
% \end{WithArrows}$
-% \end{Verbatim}
+% \end{Code}
%
% $\begin{WithArrows}
% (a+b)(a+ib)(a-b)(a-ib)
@@ -657,35 +722,37 @@ version 2005/12/01 or later.
%
%
% \interitem
-% The environment |{WithArrows}| gives also a |group| option. With this option,
-% \emph{all} the arrows of the environment are grouped on a same vertical line
-% and at a leftmost position.
+% The environment |{WithArrows}| gives also a \Definition{group} option. With
+% this option, \emph{all} the arrows of the environment are grouped on a same
+% vertical line and at a leftmost position.
% \label{group}
% %
-% \begin{Verbatim}[formatcom=\small\color{gray}]
-% $\begin{WithArrows}[~emphase#displaystyle,group@]
-% 2xy'-3y=\sqrt x
-% & \Longleftrightarrow 2x(K'y_0+Ky_0')-3Ky_0 = \sqrt x \\
-% & \Longleftrightarrow 2xK'y_0 + K(2xy_0'-3y_0) = \sqrt x \\
-% & \Longleftrightarrow 2x K'y_0 = \sqrt x \Arrow{...}\\
+% \begin{Code}
+% $\begin{WithArrows}[\emph{displaystyle,group}]
+% 2xy'-3y=\sqrt{x}
+% & \Longleftrightarrow 2x(K'y_0+Ky_0')-3Ky_0 = \sqrt{x} \\
+% & \Longleftrightarrow 2xK'y_0 + K(2xy_0'-3y_0) = \sqrt{x} \\
+% & \Longleftrightarrow 2x K'y_0 = \sqrt{x} \Arrow{...}\\
% ...
% \end{WithArrows}$
-% \end{Verbatim}
+% \end{Code}
%
%
% $\begin{WithArrows}[displaystyle,group]
-% 2xy'-3y=\sqrt x
-% & \Longleftrightarrow 2x(K'y_0+Ky_0')-3Ky_0 = \sqrt x \\
-% & \Longleftrightarrow 2xK'y_0 + K(2xy_0'-3y_0) = \sqrt x \\
-% & \Longleftrightarrow 2x K'y_0 = \sqrt x \Arrow{we replace $y_0$ by its value}\\
-% & \Longleftrightarrow 2xK'x^{\frac32} = x^{\frac12} \Arrow{simplification of the $x$}\\
-% & \Longleftrightarrow K' = \tfrac1{2x^2} \Arrow{antiderivation}\\
-% & \Longleftrightarrow K = -\tfrac1{2x}
+% 2xy'-3y=\sqrt{x}
+% & \Longleftrightarrow 2x(K'y_0+Ky_0')-3Ky_0 = \sqrt{x} \\
+% & \Longleftrightarrow 2xK'y_0 + K(2xy_0'-3y_0) = \sqrt{x} \\
+% & \Longleftrightarrow 2x K'y_0 = \sqrt{x}
+% \Arrow{we replace $y_0$ by its value}\\
+% & \Longleftrightarrow 2xK'x^{\frac{3}{2}} = x^{\frac{1}{2}}
+% \Arrow{simplification of the $x$}\\
+% & \Longleftrightarrow K' = \tfrac{1}{2x^2} \Arrow{antiderivation} \\
+% & \Longleftrightarrow K = -\tfrac{1}{2x}
% \end{WithArrows}$
%
%
% \bigskip
-% The environment |{WithArrows}| gives also a |groups| option (with a \emph{s}
+% The environment |{WithArrows}| gives also a \Definition{groups} option (with a \emph{s}
% in the name). With this option, the arrows are divided into several
% ``groups''. Each group is a set of connected\footnote{More precisely: for each
% arrow $a$, we note $i(a)$ the number of its initial row and $f(a)$ the number
@@ -712,7 +779,7 @@ version 2005/12/01 or later.
% to an individual arrow\footnote{Such arrow will be called
% \emph{independent} in the technical documentation}. Such arrow will be drawn
% irrespective of the groups. It's also possible to start a new group by
-% applying the option |new-group| to an given arrow.
+% applying the option \Definition{new-group} to an given arrow.
%
% \bigskip
% If desired, the option |group| or the option |groups| can be given to the
@@ -726,6 +793,7 @@ version 2005/12/01 or later.
% and the option |new-group| for the last arrow (that's why the last arrow is not
% aligned with the others).
%
+% \bigskip
% $\begin{WithArrows}[interline=1mm,groups]
% \sum\limits_{k=0}^n\frac{\cos kx}{\cos^k x}
% & = \sum\limits_{k=0}^n \frac{\Re (e^{ikx})}{(\cos x)^k}
@@ -764,7 +832,8 @@ version 2005/12/01 or later.
% \le f_b \le f_a$. We will also say that the arrow $a$ is \emph{over} the arrow~$b$.
%
% \bigskip
-% \parbox{8cm}{In the exemple on the right, the red arrow covers the blue one.}\hspace{3cm}
+% \parbox{8cm}{In the exemple on the right, the red arrow covers the blue
+% one.}\hspace{3cm}
% $\begin{WithArrows}[c]
% A & = B \Arrow[tikz=red,jump=3]{}\\
% & = C \Arrow[tikz=blue]{}\\
@@ -773,8 +842,9 @@ version 2005/12/01 or later.
% \end{WithArrows}$
%
% \medskip
-% On the local level, there exists a key |o|. This key is available only when
-% the option |group| or the option |groups| is in force (cf.~p.~\pageref{group}).
+% On the local level, there exists a key \Definition{o}. This key is available
+% only when the option |group| or the option |groups| is in force
+% (cf.~p.~\pageref{group}).
%
% An arrow of type |o| is drawn with an horizontal shift (such as those set by
% |xoffset|) automatically computed by taking into account the arrows covered by
@@ -783,15 +853,15 @@ version 2005/12/01 or later.
% taken into account in the computation of the value of |xoffset|.}
%
% \bigskip
-% \begin{BVerbatim}[boxwidth=10cm,baseline=c]
+% \begin{Code}[width=10cm]
% $\begin{WithArrows}[groups]
-% A & = B \Arrow{one}\Arrow[~emphase#o@,jump=3]{direct} \\
+% A & = B \Arrow{one}\Arrow[\emph{o},jump=3]{direct} \\
% & = C + C \Arrow{two} \\
% & = D + D + D \Arrow{three} \\
% & = E + E \\
% & = F + F
% \end{WithArrows}$
-% \end{BVerbatim}
+% \end{Code}
% $\begin{WithArrows}[c,groups]
% A & = B \Arrow{one}\Arrow[o,jump=3]{direct} \\
% & = C + C \Arrow{two} \\
@@ -802,17 +872,18 @@ version 2005/12/01 or later.
%
%
% \interitem
-% Arrows of type |o| may themselves be covered by other arrows of type~|o|.\par\nobreak
+% Arrows of type |o| may themselves be covered by other arrows of
+% type~|o|.\par\nobreak
%
% \bigskip
-% \begin{BVerbatim}
+% \begin{Code}
% $\begin{WithArrows}[groups]
-% A & = B \Arrow{one}\Arrow[~emphase#o@,jump=2]{two}\Arrow[~emphase#o@,jump=3]{three}\\
+% A & = B \Arrow{one}\Arrow[\emph{o},jump=2]{two}\Arrow[\emph{o},jump=3]{three}\\
% & = C \\
% & = D \\
% & = E + E + E + E + E + E + E
% \end{WithArrows}$
-% \end{BVerbatim}
+% \end{Code}
%
%
% \bigskip
@@ -825,8 +896,8 @@ version 2005/12/01 or later.
%
% \bigskip
% The horizontal space between an arrow of type |o| and the arrows immediately
-% covered is fixed by the dimension |xoffset-for-o-arrows| which can be set
-% which the command |\WithArrowsOptions| (initial value: 2~mm).
+% covered is fixed by the dimension \Definition{xoffset-for-o-arrows} which can
+% be set with the command |\WithArrowsOptions| (initial value: 2~mm).
%
%
% \interitem
@@ -836,19 +907,19 @@ version 2005/12/01 or later.
%
% \label{up-and-down}
% At the local level, there are also two options for individual arrows, called
-% ``|up|'' and ``|down|''. The following example illustrates these types of
-% arrows:
+% \Definition{up} and \Definition{down}. The following example illustrates these
+% types of arrows:
%
-% \begin{Verbatim}
+% \begin{Code}
% \(\begin{WithArrows}
% A & = B
-% \Arrow~emphase#[up]@{an arrow of type \texttt{up}} \\
+% \Arrow\emph{[up]}{an arrow of type \texttt{up}} \\
% & = C + C + C + C + C + C + C + C \\
% & = C + C + C + C + C + C + C + C
-% \Arrow~emphase#[down]@{an arrow of type \texttt{down}} \\
+% \Arrow\emph{[down]}{an arrow of type \texttt{down}} \\
% & = E + E
% \end{WithArrows}\)
-% \end{Verbatim}
+% \end{Code}
%
% \vspace{1cm}
% \(\begin{WithArrows}
@@ -869,29 +940,30 @@ version 2005/12/01 or later.
% In fact, the options |up| and |down| may be used with a value which is a list
% of couples key-value.
% \begin{itemize}
-% \item The key |radius| is the radius of the rounded corner of the
+% \item The key \Definition{radius} is the radius of the rounded corner of the
% arrow.\footnote{The initial value of this parameter is $4$~pt, which is the
% default value of the ``|rounded corners|'' of Tikz.}
-% \item The key |width| is the width of the (horizontal part of) the arrow:
+% \item The key \Definition{width} is the width of the (horizontal part of) the
+% arrow:
% \begin{itemize}
-% \item with the value |max|, the width of the arrow is ajusted with respect of
-% the position of the nodes (that's the behaviour by default of the arrows |up|
-% and |down| as shown in the previous example);
+% \item with the value \Definition{max}, the width of the arrow is ajusted with
+% respect of the position of the nodes (that's the behaviour by default of the
+% arrows |up| and |down| as shown in the previous example);
% \item with a numerical value, the width of the arrow is directly fixed to that
% numerical value;
-% \item with the value |min|, the width of the arrow is adjusted with respect to
-% the contents of the label of the arrow.
+% \item with the value \Definition{min}, the width of the arrow is adjusted with
+% respect to the contents of the label of the arrow.
% \end{itemize}
% \end{itemize}
%
% \vspace{1cm}
-% \begin{Verbatim}
+% \begin{Code}
% $\begin{WithArrows}
% A & = B
-% \Arrow[~emphase#up={radius=0pt,width=2cm}@]{we try} \\
+% \Arrow[\emph{up={radius=0pt,width=2cm}}]{we try} \\
% & = C + C + C + C + C + C + C + C
% \end{WithArrows}$
-% \end{Verbatim}
+% \end{Code}
%
% \medskip
% $\begin{WithArrows}
@@ -902,13 +974,13 @@ version 2005/12/01 or later.
%
%
% \vspace{1cm}
-% \begin{Verbatim}
+% \begin{Code}
% $\begin{WithArrows}
% A & = B
-% \Arrow[~emphase#up={width=min}@]{we try} \\
+% \Arrow[\emph{up={width=min}}]{we try} \\
% & = C + C + C + C + C + C + C + C
% \end{WithArrows}$
-% \end{Verbatim}
+% \end{Code}
%
% \medskip
% $\begin{WithArrows}
@@ -919,8 +991,8 @@ version 2005/12/01 or later.
%
% \vspace{1cm}
% The options relative to the arrows |up| and |down| can be fixed at the global
-% or environment level with the key |up-and-down|. This key may also be used as
-% prefix as illustrated now.
+% or environment level with the key \Definition{up-and-down}. This key may also
+% be used as prefix as illustrated now.
% %
% \begin{Verbatim}
% \WithArrowsOptions{up-and-down/width=min}
@@ -943,12 +1015,12 @@ version 2005/12/01 or later.
% since an environment |{WithArrows}| is always unbreakable). This option is
% designed to be used with positive values only.
% %
-% \begin{Verbatim}
+% \begin{Code}
% $\begin{WithArrows}
-% A & = (a+1)^2 \Arrow{we expand} ~emphase#\\[2ex]@
+% A & = (a+1)^2 \Arrow{we expand} \emph{\\[2ex]}
% & = a^2 + 2a + 1
% \end{WithArrows}$
-% \end{Verbatim}
+% \end{Code}
%
% $\begin{WithArrows}
% A & = (a+1)^2 \Arrow{we expand} \\*[2ex]
@@ -960,23 +1032,24 @@ version 2005/12/01 or later.
% \interitem
% In the environments of \pkg{amsmath} (or \pkg{mathtools}), the spacing between
% rows is fixed by a parameter called |\jot| (it's a dimension and not a skip).
-% That's also the case for the environment |{WithArrows}|. An option |jot| has
-% been given to the environment |{WithArrows}| in order to change the value of
-% this parameter |\jot| for a given environment.\footnote{It's also possible to
-% change |\jot| with the environment |{spreadlines}| of \pkg{mathtools}.}
+% That's also the case for the environment |{WithArrows}|. An option
+% \Definition{jot} has been given to the environment |{WithArrows}| in order to
+% change the value of this parameter |\jot| for a given
+% environment.\footnote{It's also possible to change |\jot| with the environment
+% |{spreadlines}| of \pkg{mathtools}.}
% %
-% \begin{Verbatim}
-% $\begin{WithArrows}[displaystyle,~emphase#jot=2ex@]
-% F & = \frac12G \Arrow{we expand}\\
-% & = H + \frac12K \Arrow{we go on}\\
+% \begin{Code}
+% $\begin{WithArrows}[displaystyle,\emph{jot=2ex}]
+% F & = \frac{1}{2}G \Arrow{we expand}\\
+% & = H + \frac{1}{2}K \Arrow{we go on}\\
% & = K
% \end{WithArrows}$
-% \end{Verbatim}
+% \end{Code}
%
%
% $\begin{WithArrows}[displaystyle,jot=2ex]
-% F & = \frac12G \Arrow{we expand}\\
-% & = H + \frac12K \Arrow{we go on}\\
+% F & = \frac{1}{2}G \Arrow{we expand}\\
+% & = H + \frac{1}{2}K \Arrow{we go on}\\
% & = K
% \end{WithArrows}$
%
@@ -985,8 +1058,8 @@ version 2005/12/01 or later.
% However, this new value of |\jot| will also be used in other alignments
% included in the environment~|{WithArrows}|:
% %
-% \begin{Verbatim}
-% $\begin{WithArrows}[jot=2ex]
+% \begin{Code}
+% $\begin{WithArrows}[\emph{jot=2ex}]
% \varphi(x,y) = 0 & \Leftrightarrow (x+y)^2 + (x+2y)^2 = 0
% \Arrow{$x$ and $y$ are real}\\
% & \Leftrightarrow \left\{
@@ -996,7 +1069,7 @@ version 2005/12/01 or later.
% \end{aligned}
% \right.
% \end{WithArrows}$
-% \end{Verbatim}
+% \end{Code}
%
%
% $\begin{WithArrows}[jot=2ex]
@@ -1012,10 +1085,10 @@ version 2005/12/01 or later.
%
% \bigskip
% Maybe this doesn't correspond to the desired outcome. That's why an option
-% |interline| is proposed. It's possible to use a skip (=glue) for this option.
-% %
-% \begin{Verbatim}
-% $\begin{WithArrows}[~emphase#interline=2ex@]
+% \Definition{interline} is proposed. It's possible to use a skip (=glue) for
+% this option.
+% \begin{Code}
+% $\begin{WithArrows}[\emph{interline=2ex}]
% \varphi(x,y) = 0 & \Leftrightarrow (x+y)^2 + (x+2y)^2 = 0
% \Arrow{$x$ and $y$ are real}\\
% & \Leftrightarrow \left\{
@@ -1025,7 +1098,7 @@ version 2005/12/01 or later.
% \end{aligned}
% \right.
% \end{WithArrows}$
-% \end{Verbatim}
+% \end{Code}
%
%
% $\begin{WithArrows}[interline=2ex]
@@ -1042,9 +1115,10 @@ version 2005/12/01 or later.
%
% \interitem
% Like the environment |{aligned}|, |{WithArrows}| has an option of placement
-% which can assume the values |t|, |c| or |b|. However, the initial value is not
-% |c| but |t|. If desired, it's possible to have the |c| value as the default
-% with the command |\WithArrowsOptions{c}| at the beginning of the document.
+% which can assume the values \Definition{t}, \Definition{c} or \Definition{b}.
+% However, the initial value is not |c| but |t|. If desired, it's possible to
+% have the |c| value as the default with the command |\WithArrowsOptions{c}| at
+% the beginning of the document.
% %
% \begin{Verbatim}
% So\enskip
@@ -1090,7 +1164,8 @@ version 2005/12/01 or later.
%
% Once again, it's possible to change this behaviour with |\WithArrowsOptions|:
%
-% \quad |\WithArrowsOptions{displaystyle}|.
+% \smallskip
+% |\WithArrowsOptions{displaystyle}|.
%
%
% \smallskip
@@ -1108,10 +1183,7 @@ version 2005/12/01 or later.
%
% \medskip
% The following is composed with |{WithArrows}[c,displaystyle]|. The results are
-% strictly identical.\footnote{In versions of \pkg{amsmath} older than the
-% 5~nov.~2016, a thin space was added on the left of an environment |{aligned}|.
-% The new versions do not add this space and neither do
-% |{WithArrows}|.}\par\nobreak
+% strictly identical.\par\nobreak
%
% \smallskip
% $\left\{
@@ -1130,26 +1202,26 @@ version 2005/12/01 or later.
%
% The environments |{WithArrows}| can be nested. In this case, the options given
% to the encompassing environment applies also to the inner ones (with logical
-% exceptions for |interline|, |code-before| and |code-after|). The command |Arrow|
-% can be used as usual in each environment |{WithArrows}|.
+% exceptions for |interline|, |code-before| and |code-after|). The command
+% |\Arrow| can be used as usual in each environment |{WithArrows}|.
%
-% \begin{Verbatim}[formatcom=\small\color{gray}]
-% $~emphase#\begin{WithArrows}@
+% \begin{Code}
+% $\emph{\begin{WithArrows}}
% \varphi(x,y)=0
% & \Leftrightarrow (x+2y)^2+(2x+4y)^2 = 0 \Arrow{the numbers are real}\\
% & \Leftrightarrow
-% \left\{~emphase#\begin{WithArrows}@[c]
+% \left\{\emph{\begin{WithArrows}}[c]
% x+2y & = 0 \\
% 2x+4y & = 0
-% ~emphase#\end{WithArrows}@\right. \\
+% \emph{\end{WithArrows}}\right. \\
% & \Leftrightarrow
-% \left\{~emphase#\begin{WithArrows}@[c]
+% \left\{\emph{\begin{WithArrows}}[c]
% x+2y & = 0 \Arrow[tikz=-]{the same equation}\\
% x+2y & = 0
-% ~emphase#\end{WithArrows}@\right. \\
+% \emph{\end{WithArrows}}\right. \\
% & \Leftrightarrow x+2y=0
-% ~emphase#\end{WithArrows}@$
-% \end{Verbatim}
+% \emph{\end{WithArrows}}$
+% \end{Code}
%
% $\begin{WithArrows}
% \varphi(x,y)=0
@@ -1169,7 +1241,8 @@ version 2005/12/01 or later.
%
% \bigskip
% However, one may want to draw an arrow between rows that are not in the same
-% environment. For example, one may want to draw the following arrow :\par\nobreak
+% environment. For example, one may want to draw the following arrow
+% :\par\nobreak
%
% \bigskip
% $\begin{WithArrows}[code-after = \Arrow[v]{1-2}{2-2}{division by $2$} ]
@@ -1234,13 +1307,13 @@ version 2005/12/01 or later.
% number~$1$ (and therefore, the specification is |1-2|) and ends in the row~$2$
% of the sub-environment number~$2$ (and therefore, the specification is |2-2|).
% We can draw the arrow with the following command |\Arrow| in |code-after| :
-% \begin{Verbatim}
-% $\begin{WithArrows}[~emphase#code-after = \Arrow{1-2}{2-2}{division by $2$}@ ]
+% \begin{Code}
+% $\begin{WithArrows}[\emph{code-after = \Arrow{1-2}{2-2}{division by $2$}}]
% \varphi(x,y)=0
% & \Leftrightarrow (x+2y)^2+(2x+4y)^2 = 0 \\
% .........
% \end{WithArrows}$
-% \end{Verbatim}
+% \end{Code}
%
% $\begin{WithArrows}[code-after = \Arrow{1-2}{2-2}{division by $2$} ]
% \varphi(x,y)=0
@@ -1269,13 +1342,13 @@ version 2005/12/01 or later.
% account unlike with the option |i|. Currently, the option |i| is not available
% for the command~|\Arrow| in |code-after|. However, it's always possible to
% translate an arrow with |xoffset| (or |xshift| of Tikz).
-% \begin{Verbatim}
-% $\begin{WithArrows}[code-after=\Arrow~emphase#[v]@{1-2}{2-2}{division by $2$}]
+% \begin{Code}
+% $\begin{WithArrows}[code-after=\Arrow\emph{[v]}{1-2}{2-2}{division by $2$}]
% \varphi(x,y)=0
% & \Leftrightarrow (x+2y)^2+(2x+4y)^2 = 0 \\
% .........
% \end{WithArrows}$
-% \end{Verbatim}
+% \end{Code}
%
% $\begin{WithArrows}[code-after = \Arrow[v]{1-2}{2-2}{division by $2$} ]
% \varphi(x,y)=0
@@ -1295,23 +1368,23 @@ version 2005/12/01 or later.
%
%
% \interitem
-% The package \pkg{witharrows} gives also another command available only in
-% |code-after|: the command |\MultiArrow|. This command draws a ``rak''. The list
-% of the rows of the environment concerned by this rak are given in the first
-% argument of the command |\MultiArrow|. This list is given with the syntax of
-% the list in a |\foreach| command of \pkg{pgffor}.
+% The package \pkg{witharrows} provides also another command available only in
+% |code-after|: the command \DefinitionCommand{MultiArrow}. This command draws a
+% ``rak''. The list of the rows of the environment concerned by this rak are
+% given in the first argument of the command |\MultiArrow|. This list is given
+% with the syntax of the list in a |\foreach| command of \pkg{pgffor}.
%
%
-% \begin{Verbatim}
+% \begin{Code}
% $\begin{WithArrows}[tikz = rounded corners,
-% code-after = {~emphase#\MultiArrow{1,...,4}{text}@} ]
+% code-after = {\emph{\MultiArrow{1,...,4}{text}}} ]
% A & = B \\
% & = C \\
% & = D \\
% & = E \\
% & = F
% \end{WithArrows}$
-% \end{Verbatim}
+% \end{Code}
%
%
% $\begin{WithArrows}[tikz = rounded corners,
@@ -1342,8 +1415,8 @@ version 2005/12/01 or later.
% \smallskip
% For illustrative purposes, we give an example of nested environments
% |{WithArrows}|, and, for each ``right node'', the name of that
-% node.\footnote{There is an option |show-node-names| to show the names of these
-% nodes.}
+% node.\footnote{There is an option \Definition{show-node-names} to show the
+% names of these nodes.}
%
% \medskip
% \[\begin{WithArrows}[show-nodes,show-node-names]
@@ -1380,26 +1453,27 @@ version 2005/12/01 or later.
% The package \pkg{witharrows} provides some tools facilitating the use of these
% nodes:
% \begin{itemize}[beginpenalty=10000]
-% \item the command |\WithArrowsLastEnv| gives the number of the last
-% environment of level~$0$ (\emph{i.e.} which is not included in another
-% environment of the package \pkg{witharrows});
-%
-% \item a name can be given to a given environment with the option |name| and,
-% in this case, the nodes created in the environment will have aliases
-% constructed with this name;
-%
-% \item the Tikz style |WithArrows/arrow| is the style used by \pkg{witharrows}
-% when drawing an arrow\footnote{More precisely, this style is given to the Tikz
-% option ``|every path|'' before drawing the arrow with the code of the option
-% |tikz-code|. This style is modified (in TeX scopes) by the option |tikz| of
-% \pkg{witharrows}.};
-%
-% \item the Tikz style |WithArrows/arrow/tips| is the style for the tip of the
-% arrow (loaded by |WithArrows/arrow|).
+% \item the command \DefinitionCommand{WithArrowsLastEnv} gives the number of
+% the last environment of level~$0$ (\emph{i.e.} which is not included in
+% another environment of the package \pkg{witharrows});
+%
+% \item a name can be given to a given environment with the option
+% \Definition{name} and, in this case, the nodes created in the environment will
+% have aliases constructed with this name;
+%
+% \item the Tikz style \Definition{WithArrows/arrow} is the style used by
+% \pkg{witharrows} when drawing an arrow\footnote{More precisely, this style is
+% given to the Tikz option ``|every path|'' before drawing the arrow with the
+% code of the option |tikz-code|. This style is modified (in TeX scopes) by the
+% option |tikz| of \pkg{witharrows}.};
+%
+% \item the Tikz style \Definition{WithArrows/arrow/tips} is the style for the
+% tip of the arrow (loaded by |WithArrows/arrow|).
% \end{itemize}
%
-% For example, we can draw an arrow from \texttt{wa-\WithArrowsLastEnv-2-1-2-r.south}
-% to \texttt{wa-\WithArrowsLastEnv-3-2-r.north} with the following Tikz command.
+% For example, we can draw an arrow from
+% \texttt{wa-\WithArrowsLastEnv-2-1-2-r.south} to
+% \texttt{wa-\WithArrowsLastEnv-3-2-r.north} with the following Tikz command.
%
% \begin{Verbatim}
% \begin{tikzpicture}[remember picture,overlay]
@@ -1454,24 +1528,24 @@ version 2005/12/01 or later.
% ``|first|'' and ``|second|'' and we draw a line between a node of the first
% and a node of the second.
%
-% \begin{Verbatim}
-% $\begin{WithArrows}[~emphase#name=first@]
+% \begin{Code}
+% $\begin{WithArrows}[\emph{first}]
% A & = B \\
% & = C
% \end{WithArrows}$
%
% \bigskip
-% $\begin{WithArrows}[~emphase#name=second@]
+% $\begin{WithArrows}[\emph{second}]
% A' & = B' \\
% & = C'
% \end{WithArrows}$
%
% \begin{tikzpicture}[remember picture,overlay]
% \draw [WithArrows/arrow]
-% ([xshift=3mm]~emphase#first@-1-r.south)
-% to ([xshift=3mm]~emphase#second@-1-r.north) ;
+% ([xshift=3mm]\emph{first}-1-r.south)
+% to ([xshift=3mm]\emph{second}-1-r.north) ;
% \end{tikzpicture}
-% \end{Verbatim}
+% \end{Code}
%
%
% \begin{center}
@@ -1498,39 +1572,41 @@ version 2005/12/01 or later.
% \label{DispWithArrows}
%
% As previously said, the environment |{WithArrows}| bears similarities with the
-% environment |{aligned}| of \pkg{amsmath} (and |mathtools|). This extension also
-% provides an environment |{DispWithArrows}| which is similar to the
-% environments |{align}| and |{flalign}| of \pkg{amsmath}.
+% environment |{aligned}| of \pkg{amsmath} (and |mathtools|). This extension
+% also provides an environment \Definition{\{DispWithArrows\}} which is similar
+% to the environments |{align}| and |{flalign}| of \pkg{amsmath}.
%
% \medskip
% The environment |{DispWithArrows}| must be used \emph{outside} math mode. Like
% |{align}|, it should be used in horizontal mode.
-% \begin{Verbatim}
-% \begin{~emphase#DispWithArrows@}
+% \begin{Code}
+% \emph{\begin{DispWithArrows}}
% A & = (a+1)^2 \Arrow{we expand} \\
% & = a^2 + 2a + 1
-% \end{~emphase#DispWithArrows@}
-% \end{Verbatim}
+% \emph{\end{DispWithArrows}}
+% \end{Code}
% \begin{DispWithArrows}
% A & = (a+1)^2 \Arrow{we expand} \\
% & = a^2 + 2a + 1
% \end{DispWithArrows}
%
% \medskip
-% It's possible to use the command |\notag| (or |\nonumber|) to suppress a tag.
+% It's possible to use the command \DefinitionCommand{notag} (or
+% \DefinitionCommand{nonumber}) to suppress a tag.
%
-% It's possible to use the command |\tag| to put a special tag (e.g. $\star$).
+% It's possible to use the command \DefinitionCommand{tag} to put a special tag
+% (e.g. $\star$).
%
% It's also possible to put a label to the line of an equation with the command
-% |\label|.
+% \DefinitionCommand{label}.
%
% These commands must be in the second column of the environment.
-% \begin{Verbatim}
+% \begin{Code}
% \begin{DispWithArrows}
-% A & = (a+1)^2 \Arrow{we expand} ~emphase#\notag@ \\
-% & = a^2 + 2a + 1 ~emphase#\tag{$\star$} \label{my-equation}@
+% A & = (a+1)^2 \Arrow{we expand} \emph{\notag} \\
+% & = a^2 + 2a + 1 \emph{\tag{$\star$} \label{my-equation}}
% \end{DispWithArrows}
-% \end{Verbatim}
+% \end{Code}
% \begin{DispWithArrows}
% A & = (a+1)^2 \Arrow{we expand} \notag \\
% & = a^2 + 2a + 1 \tag{$\star$} \label{my-equation}
@@ -1546,12 +1622,12 @@ version 2005/12/01 or later.
% \pkg{amssymb}. This symbol is often used to mark the end of a
% proof.\footnote{Notice that the environment |{DispWithArrows}| is compatible
% with the command |\qedhere| of \pkg{amsthm}.}
-% \begin{Verbatim}
+% \begin{Code}
% \begin{DispWithArrows}
% A & = (a+1)^2 \Arrow{we expand} \notag \\
-% & = a^2 + 2a + 1 ~emphase#\tag*{$\square$}@
+% & = a^2 + 2a + 1 \emph{\tag*{$\square$}}
% \end{DispWithArrows}
-% \end{Verbatim}
+% \end{Code}
% \begin{DispWithArrows}
% A & = (a+1)^2 \Arrow{we expand} \notag \\
% & = a^2 + 2a + 1 \tag*{$\square$}
@@ -1559,35 +1635,36 @@ version 2005/12/01 or later.
%
% \medskip
% It's also possible to suppress all the autogenerated numbers with the boolean
-% option |notag| (or |nonumber|), at the global or environment level. There is
-% also an environment |{DispWithArrows*}| which suppresses all these
-% numbers.\footnote{Even in this case, it's possible to put a ``manual tag''
+% option \Definition{notag} (or \Definition{nonumber}), at the global or
+% environment level. There is also an environment
+% \Definition{\{DispWithArrows*\}} which suppresses all these
+% numbers.\footnote{Even in this case, it's possible to put a ``manual tag''
% with the command |\tag|.}
-% \begin{Verbatim}
-% \begin{~emphase#DispWithArrows*@}
+% \begin{Code}
+% \emph{\begin{DispWithArrows*}}
% A & = (a+1)^2 \Arrow{we expand} \\
% & = a^2 + 2a + 1
-% \end{~emphase#DispWithArrows*@}
-% \end{Verbatim}
+% \emph{\end{DispWithArrows*}}
+% \end{Code}
% \begin{DispWithArrows*}
% A & = (a+1)^2 \Arrow{we expand} \\
% & = a^2 + 2a + 1
% \end{DispWithArrows*}
%
% \medskip
-% In fact, there is also another option |tagged-lines| which can be used to
+% In fact, there is also another option \Definition{tagged-lines} which can be used to
% control the lines that will be tagged. The value of this option is a list of
% the numbers of the lines that must to be tagged. For example, with the option
% |tagged-lines = {first,3,last}|, only the first, the third and the last line
% of the environment will be tagged. There is also the special value |all| which
% means that all the lines will be tagged.
-% \begin{Verbatim}
-% \begin{DispWithArrows}[~emphase#tagged-lines = last@]
+% \begin{Code}
+% \begin{DispWithArrows}[tagged-lines = last]
% A & = A_1 \Arrow{first stage} \\
% & = A_2 \Arrow{second stage} \\
% & = A_3
% \end{DispWithArrows}
-% \end{Verbatim}
+% \end{Code}
% \begin{DispWithArrows}[tagged-lines = last]
% A & = A_1 \Arrow{first stage} \\
% & = A_2 \Arrow{second stage} \\
@@ -1595,18 +1672,19 @@ version 2005/12/01 or later.
% \end{DispWithArrows}
%
% \bigskip
-% With the option |fleqn|, the environment is composed flush left (in a way
-% similar to the option |fleqn| of the standard classes of LaTeX). In this case,
-% the left margin can be controlled with the option |mathindent| (with a name
-% inspired by the parameter |\mathindent| of standard LaTeX. The initial value
-% of this parameter is 25~pt.
+% With the option \Definition{fleqn}, the environment is composed flush left (in
+% a way similar to the option |fleqn| of the standard classes of LaTeX). In this
+% case, the left margin can be controlled with the option
+% \Definition{mathindent} (with a name inspired by the parameter |\mathindent|
+% of standard LaTeX. The initial value of this parameter is 25~pt. It's possible
+% to use as value for that key a \emph{skip} (=\emph{glue}).
%
-% \begin{Verbatim}
-% \begin{DispWithArrows}[~emphase#fleqn,mathindent = 1cm@]
+% \begin{Code}
+% \begin{DispWithArrows}\emph{[fleqn,mathindent = 1cm]}
% A & = (a+1)^2 \Arrow{we expand} \\
% & = a^2 + 2a + 1
% \end{DispWithArrows}
-% \end{Verbatim}
+% \end{Code}
% \begin{DispWithArrows}[fleqn,mathindent = 1cm]
% A & = (a+1)^2 \Arrow{we expand} \\
% & = a^2 + 2a + 1
@@ -1631,15 +1709,15 @@ version 2005/12/01 or later.
% If the package \pkg{amsmath} is loaded, it's possible to use the command
% |\intertext| in the environments |{DispWithArrows}|. It's also possible to use
% the environment |{subequations}|. However, there is, for the environments
-% |{DispWithArrows}|, an option |subequations| to encapsulate the environment in
-% an environment |{subequations}|.
+% |{DispWithArrows}|, an option \Definition{subequations} to encapsulate the
+% environment in an environment |{subequations}|.
%
% \medskip
% In the following example, the key |{subequations}| is fixed by the command
% |\WithArrowsOptions|. Each environment |{DispWithArrows}| will be subnumerated
% (in the scope of |\WithArrowsOptions|)
-% \begin{Verbatim}
-% ~emphase#\WithArrowsOptions{subequations}@
+% \begin{Code}
+% \emph{\WithArrowsOptions{subequations}}
% First environment.
% \begin{DispWithArrows}
% A & = B \\
@@ -1650,7 +1728,7 @@ version 2005/12/01 or later.
% D & = E \\
% & = F
% \end{DispWithArrows}
-% \end{Verbatim}
+% \end{Code}
% %
% \begin{scope}
% \WithArrowsOptions{subequations}
@@ -1670,19 +1748,19 @@ version 2005/12/01 or later.
% If there is not enough space to put the tag at the end of a line, there is no
% automatic positioning of the label on the next line (as in the environments of
% \pkg{amsmath}). However, in |{DispWithArrows}|, the user can use the command
-% |\tagnextline| to manually require the composition of the tag on the following
-% line.
-% \begin{Verbatim}
+% \DefinitionCommand{tagnextline} to manually require the composition of the tag
+% on the following line.
+% \begin{Code}
% \begin{DispWithArrows}[displaystyle]
% S_{2(p+1)}
% & =\sum_{k=1}^{2(p+1)} (-1)^k k^2 \\
% & \smash[b]{=\sum_{k=1}^{2p}(-1)^kk
-% +(-1)^{2p+1}(2p+1)^2+(-1)^{2p+2}(2p+2)^2} ~emphase#\tagnextline@ \\
+% +(-1)^{2p+1}(2p+1)^2+(-1)^{2p+2}(2p+2)^2} \emph{\tagnextline} \\
% &= S_{2p}-(2p+1)^2+(2p+2)^2\\
% &=p(2p+1)-(2p+1)^2+(2p+2)^2\\
% &= 2p^2+5p+3
% \end{DispWithArrows}
-% \end{Verbatim}
+% \end{Code}
% \begin{center}
% \color{gray}\vrule%
% \begin{minipage}{275pt}\color{black}
@@ -1703,28 +1781,29 @@ version 2005/12/01 or later.
%
% \bigskip
% The environments |{DispWithArrows}| and |{DispWithArrows*}| provide an option
-% |wrap-lines|. With this option, the lines of the label are automatically
-% wrapped on the right.\footnotemark[\thefnnohyphen]\label{wrap-lines}
+% \Definition{wrap-lines}. With this option, the lines of the labels are
+% automatically wrapped on the
+% right.\footnotemark[\thefnnohyphen]\label{wrap-lines}
%
-% \begin{Verbatim}
-% \begin{DispWithArrows*}[displaystyle,~emphase#wrap-lines@]
+% \begin{Code}
+% \begin{DispWithArrows*}\emph{[displaystyle,wrap-lines]}
% S_n
-% & = \frac1n \Re \left(\sum_{k=0}^{n-1}\bigl(e^{i\frac{\pi}{2n}}\bigr)^k\right)
+% & = \frac{1}{n} \Re \left(\sum_{k=0}^{n-1}\bigl(e^{i\frac{\pi}{2n}}\bigr)^k\right)
% \Arrow{sum of terms of a geometric progression of ratio $e^{i\frac{2\pi}n}$}\\
-% & = \frac1n \Re \left( \frac{1-\bigl(e^{i\frac{\pi}{2n}}\bigr)^n}
+% & = \frac{1}{n} \Re \left( \frac{1-\bigl(e^{i\frac{\pi}{2n}}\bigr)^n}
% {1-e^{i\frac{\pi}{2n}}}\right)
% \Arrow{This line has been wrapped automatically.} \\
-% & = \frac1n \Re \left(\frac{1-i}{1-e^{i\frac{\pi}{2n}}}\right)
+% & = \frac{1}{n} \Re \left(\frac{1-i}{1-e^{i\frac{\pi}{2n}}}\right)
% \end{DispWithArrows*}
-% \end{Verbatim}
+% \end{Code}
% \begin{DispWithArrows*}[displaystyle,wrap-lines]
% S_n
-% & = \frac1n \Re \left(\sum_{k=0}^{n-1}\bigl(e^{i\frac{\pi}{2n}}\bigr)^k\right)
+% & = \frac{1}{n} \Re \left(\sum_{k=0}^{n-1}\bigl(e^{i\frac{\pi}{2n}}\bigr)^k\right)
% \Arrow{sum of terms of a geometric progression of ratio $e^{i\frac{2\pi}n}$}\\
-% & = \frac1n \Re \left(
+% & = \frac{1}{n} \Re \left(
% \frac{1-\bigl(e^{i\frac{\pi}{2n}}\bigr)^n}{1-e^{i\frac{\pi}{2n}}} \right)
% \Arrow{This line has been wrapped automatically.} \\
-% & = \frac1n \Re \left(\frac{1-i}{1-e^{i\frac{\pi}{2n}}}\right)
+% & = \frac{1}{n} \Re \left(\frac{1-i}{1-e^{i\frac{\pi}{2n}}}\right)
% \end{DispWithArrows*}
%
% \bigskip
@@ -1744,33 +1823,33 @@ version 2005/12/01 or later.
% Here is an example. The use of |{DispWithArrows}| gives the ability to tag an
% equation (and also to use |wrap-lines|).
%
-% \begin{Verbatim}
-% ~emphase#\begin{enumerate}@
-% ~emphase#\item @
+% \begin{Code}
+% \emph{\begin{enumerate}
+% \item }
% \begin{DispWithArrows}%
% [displaystyle, wrap-lines, tagged-lines = last, fleqn, mathindent = 0 pt]
% S_n
-% & = \frac1n \Re \left(\sum_{k=0}^{n-1}\bigl(e^{i\frac{\pi}{2n}}\bigr)^k\right)
+% & = \frac{1}{n} \Re \left(\sum_{k=0}^{n-1}\bigl(e^{i\frac{\pi}{2n}}\bigr)^k\right)
% \Arrow{we use the formula for a sum of terms of a geometric progression of
% ratio $e^{i\frac{2\pi}n}$}\\
-% & = \frac1n \Re \left( \frac{1-\bigl(e^{i\frac{\pi}{2n}}\bigr)^n}
+% & = \frac{1}{n} \Re \left( \frac{1-\bigl(e^{i\frac{\pi}{2n}}\bigr)^n}
% {1-e^{i\frac{\pi}{2n}}}\right)
-% \Arrow{$\bigl(e^{i\frac{\pi}{2n}}\bigr)^n = e^{i\frac{\pi}2}=i$} \\
-% & = \frac1n \Re \left(\frac{1-i}{1-e^{i\frac{\pi}{2n}}}\right)
+% \Arrow{$\bigl(e^{i\frac{\pi}{2n}}\bigr)^n = e^{i\frac{\pi}{2}}=i$} \\
+% & = \frac{1}{n} \Re \left(\frac{1-i}{1-e^{i\frac{\pi}{2n}}}\right)
% \end{DispWithArrows}
-% ~emphase#\end{enumerate}@
-% \end{Verbatim}
+% \emph{\end{enumerate}}
+% \end{Code}
% \begin{enumerate}
% \item
% \begin{DispWithArrows}[displaystyle, wrap-lines, tagged-lines = last, fleqn, mathindent = 0 pt]
% S_n
-% & = \frac1n \Re \left(\sum_{k=0}^{n-1}\bigl(e^{i\frac{\pi}{2n}}\bigr)^k\right)
+% & = \frac{1}{n} \Re \left(\sum_{k=0}^{n-1}\bigl(e^{i\frac{\pi}{2n}}\bigr)^k\right)
% \Arrow{we use the formula for a sum of terms of a geometric progression of
% ratio $e^{i\frac{2\pi}n}$}\\
-% & = \frac1n \Re \left(
+% & = \frac{1}{n} \Re \left(
% \frac{1-\bigl(e^{i\frac{\pi}{2n}}\bigr)^n}{1-e^{i\frac{\pi}{2n}}} \right)
-% \Arrow{$\bigl(e^{i\frac{\pi}{2n}}\bigr)^n = e^{i\frac{\pi}2}=i$} \\
-% & = \frac1n \Re \left(\frac{1-i}{1-e^{i\frac{\pi}{2n}}}\right)
+% \Arrow{$\bigl(e^{i\frac{\pi}{2n}}\bigr)^n = e^{i\frac{\pi}{2}}=i$} \\
+% & = \frac{1}{n} \Re \left(\frac{1-i}{1-e^{i\frac{\pi}{2n}}}\right)
% \end{DispWithArrows}
% \end{enumerate}
%
@@ -1814,10 +1893,11 @@ version 2005/12/01 or later.
%
% \subsection{The option <...> of DispWithArrows}
%
-% The environment |{DispWithArrows}| provides an option |left-brace|. When present,
-% the value of this option is composed on the left, followed by a curly brace
-% (hence the name) and the body of the environment.\footnote{The option
-% |left-brace| can also be used without value: in this case, only the brace is drawn...}
+% The environment |{DispWithArrows}| provides an option \Definition{left-brace}.
+% When present, the value of this option is composed on the left, followed by a
+% curly brace (hence the name) and the body of the environment.\footnote{The
+% option |left-brace| can also be used without value: in this case, only the
+% brace is drawn...}
%
% For lisibility, this option |left-brace| is also available with a special
% syntax: it's possible to give this option between angle brackets
@@ -1834,14 +1914,14 @@ version 2005/12/01 or later.
%
% \medskip
%
-% \begin{BVerbatim}
-% \begin{DispWithArrows}~emphase#< \binom{n}{p} = >@[format = ll,fleqn,displaystyle]
+% \begin{Code}
+% \begin{DispWithArrows}\emph{< \binom{n}{p} = >}[format = ll,fleqn,displaystyle]
% 0 & \quad \text{if } p > n
% \Arrow{if fact, it's a special case\\ of the following one} \\
% \frac{n(n-1)\cdots(n-p+1)}{p!} & \quad \text{if } 0 \leq p \leq n \\
% 0 & \quad \text{if } p < 0
% \end{DispWithArrows}
-% \end{BVerbatim}
+% \end{Code}
% %
% \begin{DispWithArrows}< \binom{n}{p} = >[format = ll,fleqn,displaystyle]
% 0 & \quad \text{if } p > n
@@ -1854,14 +1934,14 @@ version 2005/12/01 or later.
% In the following example, we subnumerate the equations with the option
% |subequations| (available when the package \pkg{amsmath} is loaded).
%
-% \begin{Verbatim}
-% \begin{DispWithArrows}~emphase#< \label{system} \ref*{system} \Leftrightarrow >@[
+% \begin{Code}
+% \begin{DispWithArrows}\emph{< \label{system} \ref*{system} \Leftrightarrow >}[
% format = l, subequations ]
% x+y+z = -3 \Arrow[tikz=-,jump=2]{3 equations} \\
% xy+xz+yz=-2 \\
% xyz = -15 \label{last-equation}
% \end{DispWithArrows}
-% \end{Verbatim}
+% \end{Code}
% %
% \begin{DispWithArrows}< \label{system} \ref*{system} \Leftrightarrow >[
% format = l, subequations]
@@ -1880,14 +1960,28 @@ version 2005/12/01 or later.
% \pkg{hyperref} is loaded).
%
% \bigskip
-% With the option |replace-left-brace-by|, it's possible to replace the
+% With the option \Definition{replace-left-brace-by}, it's possible to replace the
% left curly brace by another extensible delimiter. For example,
-% ``|replace-left-brace-by = [\enskip|'' will compose with a bracket and add also a
-% |\enskip| after this bracket.
+% ``|replace-left-brace-by = [\enskip|'' will compose with a bracket and add
+% also a |\enskip| after this bracket.
%
% \interitem
% \section{Advanced features}
%
+% \subsection{Utilisation with Beamer}
+%
+% \colorbox{yellow!50}{\textbf{New 2.9}}\par\nobreak
+%
+% \smallskip
+% If \pkg{witharrows} is used with Beamer, the command |\Arrow| takes in as
+% argument between angular brackets (after the optional argument in square
+% brackets) to specify the \emph{overlays} which are implied (internally,
+% \pkg{witharrows} merely uses the command |\only| of Beamer).
+%
+% \begin{Code}
+% \Arrow[jump=2]\emph{<3->}{Example}
+% \end{Code}
+%
% \subsection{Use with plain-TeX}
% \label{plain-TeX}
%
@@ -1921,7 +2015,8 @@ version 2005/12/01 or later.
%
% \label{tikz-code}
%
-% The option |tikz-code| allows the user to change the shape of the arrows.\footnote{If the option |wrap-lines| is used in an environment
+% The option \Definition{tikz-code} allows the user to change the shape of the
+% arrows.\footnote{If the option |wrap-lines| is used in an environment
% |{DispWithArrows}| or |{DispWithArrows*}|, the option |tikz-code| will have no
% effect for the arrows of this environment but only for the arrows in the
% nested environments |{WithArrows}|.}
@@ -1936,7 +2031,7 @@ version 2005/12/01 or later.
% the end point and the label of the arrow.
%
% \bigskip
-% By default, the value is the following:
+% The initial value is the following:
%
% \smallskip
% \qquad |\draw (#1) to node {#3} (#2) ;|
@@ -1945,23 +2040,23 @@ version 2005/12/01 or later.
% \bigskip
% In the following example, we replace this default path by a path with three
% segments (and the node overwriting the second segment).
-% \begin{Verbatim}
+% \begin{Code}
% \begin{WithArrows}[format=c,ygap=5pt,interline=4mm,
-% ~emphase#tikz-code = {\draw[rounded corners]@
-% ~emphase# (~#1) -- ([xshift=5mm]~#1)@
-% ~emphase# -- node[circle,@
-% ~emphase# draw,@
-% ~emphase# auto = false,@
-% ~emphase# fill = gray!50,@
-% ~emphase# inner sep = 1pt] {\tiny ~#3}@
-% ~emphase# ([xshift=5mm]~#2)@
-% ~emphase# -- (~#2) ; }@]
+% \emph{tikz-code = {\draw[rounded corners]
+% (#1) -- ([xshift=5mm]#1)
+% -- node[circle,
+% draw,
+% auto = false,
+% fill = gray!50,
+% inner sep = 1pt] {\tiny #3}
+% ([xshift=5mm]#2)
+% -- (#2) ; }}]
% 3 (2x+4) = 6 \Arrow{$\div 3$} \\
% 2x+4 = 2 \Arrow{$-4$} \\
% 2x = -2 \Arrow{$\div 2$} \\
% x = -1
% \end{WithArrows}
-% \end{Verbatim}
+% \end{Code}
%
%
% \[\begin{WithArrows}[format=c,
@@ -1987,10 +2082,11 @@ version 2005/12/01 or later.
%
% \bigskip
% The environments |{DispWithArrows}| and its starred version
-% |{DispWithArrows*}| provide a command |\WithArrowsRightX| which can be used in
-% a definition of |tikz-code|. This command gives the $x$-value of the right side
-% of the composition box (taking into account the eventual tags of the
-% equations). For an example of use, see p.~\pageref{example-WithArrowsRightX}.
+% |{DispWithArrows*}| provide a command \DefinitionCommand{WithArrowsRightX}
+% which can be used in a definition of |tikz-code|. This command gives the
+% $x$-value of the right side of the composition box (taking into account the
+% eventual tags of the equations). For an example of use, see
+% p.~\pageref{example-WithArrowsRightX}.
%
%
% \bigskip
@@ -2031,10 +2127,9 @@ version 2005/12/01 or later.
%
% \subsection{The key right-overlap}
%
-% \colorbox{yellow!50}{\textbf{New 2.8}}
%
-% The key |right-overlap| is a boolean key whose initial value is |true|. It
-% deals with the environments |{WithArrows}| only.
+% The key \Definition{right-overlap} is a boolean key whose initial value is
+% |true|. It deals with the environments |{WithArrows}| only.
%
% When the key |right-overlap| is in force, the arrows (and their labels) are
% drawn in an overlapping position and are not relevant for the computation of
@@ -2045,8 +2140,8 @@ version 2005/12/01 or later.
% right is taken into account in the dimensions of the encompassing box.
%
%
-% \begin{Verbatim}
-% $\left\{\begin{WithArrows}[c,format = rCrCl,~emphase#right-overlap=false@]
+% \begin{Code}
+% $\left\{\begin{WithArrows}[c,format = rCrCl,\emph{right-overlap=false}]
% 2x & + & 3y & = & 5 \Arrow{we add $L_1$ to $L_2$}\\
% -2x & - & 5y & = & 2
% \end{WithArrows}\right.$\quad
@@ -2054,7 +2149,7 @@ version 2005/12/01 or later.
% 2x & + & 3y & = & 5 \\
% & - & 2y & = & 7
% \end{WithArrows}\right.$
-% \end{Verbatim}
+% \end{Code}
%
% \medskip
% $\left\{\begin{WithArrows}[c,format = rCrCl,right-overlap=false]
@@ -2067,14 +2162,16 @@ version 2005/12/01 or later.
% \end{WithArrows}\right.$
%
% \bigskip
-% The tuning |right-overlap = false| may also be useful in conjunction with the class |standalone|.
+% The tuning |right-overlap = false| may also be useful in conjunction with the
+% class |standalone|.
%
%
% \bigskip
% \subsection{Vertical positioning of the arrows}
%
% There are four parameters for fine tuning of the vertical positioning of the
-% arrows : |ygap|, |ystart|, |start-adjust| and |end-adjust|.
+% arrows : \Definition{ygap}, \Definition{ystart}, \Definition{start-adjust} and
+% \Definition{end-adjust}.
%
% \medskip
% We first explain the behaviour when the parameters |start-adjust| and
@@ -2089,7 +2186,9 @@ version 2005/12/01 or later.
%
% \bigskip
% $\begin{WithArrows}[interline=1mm, adjust = 0pt]
-% (\cos x + \sin x)^2 & = \cos^2 x +2 \cos x \sin x + \sin^2 x\Arrow{}\tikz[remember picture] \coordinate (A) ; \\
+% (\cos x + \sin x)^2 &
+% = \cos^2 x +2 \cos x \sin x
+% + \sin^2 x\Arrow{}\tikz[remember picture] \coordinate (A) ; \\
% & = \cos^2x + \sin^2x + 2\sin x\cos x \Arrow{} \\
% & = 1 + \sin(2x)
% \end{WithArrows}$
@@ -2118,12 +2217,12 @@ version 2005/12/01 or later.
% \bigskip
% Here is for example the behaviour without the mechanism of |start-adjust| and
% |end-adjust|:
-% % \begin{Verbatim}
-% $\begin{WithArrows}~emphase#[start-adjust=0pt, end-adjust=0pt]@
+% \begin{Code}
+% $\begin{WithArrows}\emph{[start-adjust=0pt, end-adjust=0pt]}
% A & = (a+1)^2 \Arrow{we expand} \\
% & = a^2 + 2a + 1
% \end{WithArrows}$
-% \end{Verbatim}
+% \end{Code}
%
% $\begin{WithArrows}[start-adjust=0pt, end-adjust=0pt]
% A & = (a+1)^2 \Arrow{we expand} \\
@@ -2131,10 +2230,10 @@ version 2005/12/01 or later.
% \end{WithArrows}$
%
%
-% \bigskip
-% Here is the standard behaviour since version 1.13 (the parameters
-% |start-adjust| and |end-ajust| are used with the initial value $0.4$~ex). The
-% arrow is longer and the result is more aesthetic.
+% \bigskip
+% Here is the standard behaviour (the parameters |start-adjust| and |end-ajust|
+% are used with the initial value $0.4$~ex). The arrow is longer and the result
+% is more aesthetic.
%
% \medskip
% $\begin{WithArrows}
@@ -2144,20 +2243,20 @@ version 2005/12/01 or later.
%
%
% \bigskip
-% It's also possible to use the option |adjust| which sets both |start-adjust|
-% and |end-ajust|.
+% It's also possible to use the option \Definition{adjust} which sets both
+% |start-adjust| and |end-ajust|.
%
% \interitem
-% Since the version 2.1 of \pkg{witharrows}, an arrow of |jump| equal to~$1$ has
-% a maximal length\footnote{We call \emph{length} of an arrow the difference
-% between the $y$-value of its start point and the $y$~value of its end point.}
-% equal to the parameter |max-length-of-arrow|. The initial value of this
-% parameter is $2$~cm.
+% An arrow of |jump| equal to~$1$ has a maximal length\footnote{We call
+% \emph{length} of an arrow the difference between the $y$-value of its start
+% point and the $y$~value of its end point.} equal to the parameter
+% \Definition{max-length-of-arrow}. The initial value of this parameter is
+% $2$~cm.
%
% In the following example, the value of |max-length-of-arrow| has been fixed to
% $1.5$~cm.
-% \begin{Verbatim}
-% \[\begin{WithArrows}[~emphase#max-length-of-arrow = 1.5cm@]
+% \begin{Code}
+% \[\begin{WithArrows}[\emph{max-length-of-arrow = 1.5cm}]
% A
% & =
% \begin{vmatrix}
@@ -2182,7 +2281,7 @@ version 2005/12/01 or later.
% 0 & e-a & e^2-a^2 & e^3-a^3 & e^4-a^4
% \end{vmatrix}
% \end{WithArrows}\]
-% \end{Verbatim}
+% \end{Code}
%
%
% \bigskip
@@ -2224,15 +2323,15 @@ version 2005/12/01 or later.
% \pkg{footnote} or the package \pkg{footnotehyper}.
%
% \smallskip
-% If \pkg{witharrows} is loaded with the option |footnote| (with
+% If \pkg{witharrows} is loaded with the option \Definition{footnote} (with
% |\usepackage[footnote]{witharrows}| or with |\PassOptionsToPackage|), the
% package \pkg{footnote} is loaded (if it is not yet loaded) and it is used to
% extract the footnotes.
%
% \smallskip
-% If \pkg{witharrows} is loaded with the option |footnotehyper|, the package
-% \pkg{footnotehyper} is loaded (if it is not yet loaded) ant it is used to
-% extract footnotes.
+% If \pkg{witharrows} is loaded with the option \Definition{footnotehyper}, the
+% package \pkg{footnotehyper} is loaded (if it is not yet loaded) ant it is used
+% to extract footnotes.
%
% \smallskip
% Caution: The packages \pkg{footnote} and \pkg{footnotehyper} are incompatible.
@@ -2256,10 +2355,10 @@ version 2005/12/01 or later.
% \bigskip
% \subsection{Option no-arrows}
%
-% The option |no-arrows| is a convenience given to the user. With this option
-% the arrows are not drawn. However, an analyse of the arrows is done and some
-% errors can be raised, for example if an arrow would arrive after the last row
-% of the environment.
+% The option \Definition{no-arrows} is a convenience given to the user. With
+% this option the arrows are not drawn. However, an analyse of the arrows is
+% done and some errors can be raised, for example if an arrow would arrive after
+% the last row of the environment.
%
% \bigskip
% \subsection{Note for the users of AUCTeX}
@@ -2277,12 +2376,12 @@ version 2005/12/01 or later.
% |M-x customize| > |[Text]| > |[TeX]| > |[Font LaTeX]|
%
% \bigskip
-% \subsection{Note for developpers}
+% \subsection{Note for the developpers}
%
% If you want to construct an environment upon an environment of
% \pkg{witharrows}, we recommand to call the environment with the construction
-% |\WithArrows|-|\endWithArrows| or |\DispWithArrows|-|\endDispWithArrows| (and
-% not |\begin{WithArrows}|-|\end{WithArrows}|, etc.).
+% |\WithArrows|-|\endWithArrows| (and not |\begin{WithArrows}| and
+% |\end{WithArrows}|).
%
% \smallskip
% By doing so, the error messages generated by \pkg{witharrows} will (usually)
@@ -2326,29 +2425,33 @@ version 2005/12/01 or later.
% placement of an eventual command |\Arrow|.
%
%
-%
-% \begin{Verbatim}[formatcom=\small\color{gray}]
+% \begingroup
+% \small
+% \begin{Code}
% $\begin{WithArrows}[interline=0.5ex]
-% ~emphase#\MoveEqLeft@ \arccos(x) = \arcsin \frac45 + \arcsin \frac5{13}
-% \Arrow{because both are in $[-\frac{\pi}2,\frac{\pi}2]$} \\
-% & \Leftrightarrow x = \sin\left(\arcsin\frac45 + \arcsin\frac5{13}\right) \\
-% & \Leftrightarrow x = \frac45\cos\arcsin\frac5{13} + \frac5{13} \cos\arcsin\frac45
+% \emph{\MoveEqLeft} \arccos(x) = \arcsin \frac{4}{5} + \arcsin \frac{5}{13}
+% \Arrow{because both are in $[-\frac{\pi}{2},\frac{\pi}{2}]$} \\
+% & \Leftrightarrow x = \sin\left(\arcsin\frac{4}{5} + \arcsin\frac{5}{13}\right) \\
+% & \Leftrightarrow x
+% = \frac{4}{5}\cos\arcsin\frac{5}{13}+\frac{5}{13}\cos\arcsin\frac{4}{5}
% \Arrow{$\forall x \in [-1,1], \cos(\arcsin x) = \sqrt{1-x^2}$} \\
-% & \Leftrightarrow x = \frac45\sqrt{1-\bigl(\frac5{13}\bigr)^2}
-% + \frac5{13}\sqrt{1-\bigl(\frac45\bigr)^2}
+% & \Leftrightarrow x = \frac{4}{5}\sqrt{1-\bigl(\frac{5}{13}\bigr)^2}
+% + \frac{5}{13}\sqrt{1-\bigl(\frac{4}{5}\bigr)^2}
% \end{WithArrows}$
-% \end{Verbatim}
+% \end{Code}
+% \endgroup
%
%
% \medskip
% $\begin{WithArrows}[interline=0.5ex]
-% \MoveEqLeft \arccos(x) = \arcsin \frac45 + \arcsin \frac5{13}
-% \Arrow{because both are in $[-\frac{\pi}2,\frac{\pi}2]$} \\
-% & \Leftrightarrow x = \sin\left(\arcsin\frac45 + \arcsin\frac5{13}\right) \\
-% & \Leftrightarrow x = \frac45\cos\arcsin\frac5{13} + \frac5{13} \cos\arcsin\frac45
+% \MoveEqLeft \arccos(x) = \arcsin \frac{4}{5} + \arcsin \frac{5}{13}
+% \Arrow{because both are in $[-\frac{\pi}{2},\frac{\pi}{2}]$} \\
+% & \Leftrightarrow x = \sin\left(\arcsin\frac{4}{5} + \arcsin\frac{5}{13}\right) \\
+% & \Leftrightarrow x
+% = \frac{4}{5}\cos\arcsin\frac{5}{13} + \frac{5}{13} \cos\arcsin\frac{4}{5}
% \Arrow{$\forall x \in [-1,1], \cos(\arcsin x) = \sqrt{1-x^2}$} \\
-% & \Leftrightarrow x = \frac45\sqrt{1-\bigl(\frac5{13}\bigr)^2}
-% + \frac5{13}\sqrt{1-\bigl(\frac45\bigr)^2}
+% & \Leftrightarrow x = \frac{4}{5}\sqrt{1-\bigl(\frac{5}{13}\bigr)^2}
+% + \frac{5}{13}\sqrt{1-\bigl(\frac{4}{5}\bigr)^2}
% \end{WithArrows}$
%
%
@@ -2360,13 +2463,13 @@ version 2005/12/01 or later.
% directions.
%
% \bigskip
-% \begin{Verbatim}
+% \begin{Code}
% \NewDocumentCommand \DoubleArrow { O {} m m }
% {
-% \Arrow[tikz=->,~#1]{~#2}%
-% \Arrow[o,tikz=<-,~#1]{~#3}
+% \Arrow[tikz=->,#1]{#2}%
+% \Arrow[o,tikz=<-,#1]{#3}
% }
-% \end{Verbatim}
+% \end{Code}
%
%
% \NewDocumentCommand \DoubleArrow { O {} m m }
@@ -2379,12 +2482,12 @@ version 2005/12/01 or later.
% \bigskip
% Example of use:
%
-% \begin{Verbatim}
+% \begin{Code}
% $\begin{WithArrows}[groups]
-% A & = (a+b)^2 \DoubleArrow[tikz={font=\bfseries}]{expansion}{factorization} \\
+% A & = (a+b)^2 \emph{\DoubleArrow[tikz={font=\bfseries}]{expansion}{factorization}} \\
% & = a^2 + 2ab+b^2
% \end{WithArrows}$
-% \end{Verbatim}
+% \end{Code}
%
% \bigskip
% $\begin{WithArrows}[groups]
@@ -2401,22 +2504,22 @@ version 2005/12/01 or later.
% It's possible to change the shape of the labels, which are Tikz nodes, by
% modifying the key ``|every node|'' of Tikz.
%
-% \begin{Verbatim}
+% \begin{Code}
% \begin{WithArrows}%
% [format = c,
% interline = 4mm,
-% tikz = {~emphase#every node/.style = {circle,@
-% ~emphase# draw,@
-% ~emphase# auto = false,@
-% ~emphase# fill = gray!50,@
-% ~emphase# inner sep = 1pt,@
-% ~emphase# font = \tiny}@}]
+% tikz = {\emph{every node/.style = {circle,
+% draw,
+% auto = false,
+% fill = gray!50,
+% inner sep = 1pt,
+% font = \tiny}}}]
% 3 (2x+4) = 6 \Arrow{$\div 3$} \\
% 2x+4 = 2 \Arrow{$-4$} \\
% 2x = -2 \Arrow{$\div 2$} \\
% 2x = -1
% \end{WithArrows}
-% \end{Verbatim}
+% \end{Code}
%
% \[\begin{WithArrows}[%
% format = c,
@@ -2455,18 +2558,18 @@ version 2005/12/01 or later.
% instructions |\path| : the first instruction draws the arrow itself and the
% second puts the label in a Tikz node in the rectangle delimited by the arrow.
%
-% \begin{Verbatim}
+% \begin{Code}
% \begin{DispWithArrows*}%
% [displaystyle,
% ygap = 2mm,
% ystart = 0mm,
-% ~emphase#tikz-code = {\draw (~#1) -- ++(4.5cm,0) |- (~#2) ;@
-% ~emphase# \path (~#1) -- (~#2) @
-% ~emphase# node[text width = 4.2cm, right, midway] {~#3} ;}@]
+% \emph{tikz-code = {\draw (#1) -- ++(4.5cm,0) |- (#2) ;
+% \path (#1) -- (#2)
+% node[text width = 4.2cm, right, midway] {#3} ;}}]
% S_n
-% & = \frac1n \sum_{k=0}^{n-1}\cos\bigl(\tfrac{\pi}2\cdot\tfrac kn\bigr)
+% & = \frac{1}{n} \sum_{k=0}^{n-1}\cos\bigl(\tfrac{\pi}{2}\cdot\tfrac{k}{n}\bigr)
% ...........
-% \end{Verbatim}
+% \end{Code}
%
%
% \bigskip
@@ -2478,16 +2581,16 @@ version 2005/12/01 or later.
% \path (#1) -- (#2)
% node[text width = 4.2cm, right, midway] {#3} ;}]
% S_n
-% & = \frac1n \sum_{k=0}^{n-1}\cos\bigl(\tfrac{\pi}2\cdot\tfrac kn\bigr)
+% & = \frac{1}{n} \sum_{k=0}^{n-1}\cos\bigl(\tfrac{\pi}{2}\cdot\tfrac{k}{n}\bigr)
% \Arrow{$\cos x = \Re(e^{ix})$}\\
-% & = \frac1n\sum_{k=0}^{n-1} \Re\left(e^{i\frac{k\pi}{2n}}\right)
+% & = \frac{1}{n} \sum_{k=0}^{n-1} \Re\left(e^{i\frac{k\pi}{2n}}\right)
% \Arrow{$\Re(z+z')=\Re(z)+\Re(z')$}\\
-% & = \frac1n \Re\left(\sum_{k=0}^{n-1} e^{i\frac{k\pi}{2n}}\right)
+% & = \frac{1}{n} \Re\left(\sum_{k=0}^{n-1} e^{i\frac{k\pi}{2n}}\right)
% \Arrow{$\exp$ is a morphism for $\times$ and $+$} \\
-% & = \frac1n \Re \left(\sum_{k=0}^{n-1}\bigl(e^{i\frac{\pi}{2n}}\bigr)^k\right)
-% \Arrow{sum of terms of a geometric progression of ratio $e^{i\frac{2\pi}n}$}\\
-% & = \frac1n \Re \left( \frac{1-\bigl(e^{i\frac{\pi}{2n}}\bigr)^n}{1-e^{i\frac{\pi}{2n}}}\right)\\
-% & = \frac1n \Re \left(\frac{1-i}{1-e^{i\frac{\pi}{2n}}}\right)
+% & = \frac{1}{n} \Re \left(\sum_{k=0}^{n-1}\bigl(e^{i\frac{\pi}{2n}}\bigr)^k\right)
+% \Arrow{sum of terms of a geometric progression of ratio $e^{i\frac{2\pi}{n}}$}\\
+% & = \frac{1}{n} \Re \left( \frac{1-\bigl(e^{i\frac{\pi}{2n}}\bigr)^n}{1-e^{i\frac{\pi}{2n}}}\right)\\
+% & = \frac{1}{n} \Re \left(\frac{1-i}{1-e^{i\frac{\pi}{2n}}}\right)
% \end{DispWithArrows*}
%
% \bigskip
@@ -2502,55 +2605,56 @@ version 2005/12/01 or later.
% composition box (it's a TeX command and not a dimension). For lisibility, we
% use a style. This example requires the Tikz library \pkg{calc}.
%
-% \begin{Verbatim}
+% \begin{Code}
% \WithArrowsNewStyle{MyStyle}
% {displaystyle,
% ygap = 2mm,
% xoffset = 0pt,
% ystart = 0mm,
-% tikz-code = {\path let \p1 = (~#~#1)
-% in (~#~#1)
+% tikz-code = {\path let \p1 = (#1)
+% in (#1)
% -- node [anchor = west,
-% text width = {~emphase#\WithArrowsRightX@ - \x1 - 0.5 em}]
-% {~#~#3}
-% (~#~#2) ;
-% \draw let \p1 = (~#~#1)
-% in (~#~#1) -- ++(~emphase#\WithArrowsRightX@ - \x1,0) |- (~#~#2) ; }}
-% \end{Verbatim}
-%
-% \begin{Verbatim}
+% text width = {\emph{\WithArrowsRightX} - \x1 - 0.5 em}]
+% {#3}
+% (#2) ;
+% \draw let \p1 = (#1)
+% in (#1) -- ++(\emph{\WithArrowsRightX} - \x1,0) |- (#2) ; }}
+% \end{Code}
+%
+% \begin{Code}
%\begin{DispWithArrows}[MyStyle]
% S_n
-% & = \frac1n \sum_{k=0}^{n-1}\cos\bigl(\tfrac{\pi}2\cdot\tfrac kn\bigr)
+% & = \frac{1}{n} \sum_{k=0}^{n-1}\cos\bigl(\tfrac{\pi}{2}\cdot\tfrac{k}{n}\bigr)
% \Arrow{$\cos x = \Re(e^{ix})$}\\
% ...........
-% \end{Verbatim}
+% \end{Code}
%
% \WithArrowsNewStyle{MyStyle}
% {displaystyle,
% ygap = 2mm,
% xoffset = 0pt,
% ystart = 0mm,
-% tikz-code = {\path let \p1 = (##1)
-% in (##1)
+% tikz-code = {\path let \p1 = (#1)
+% in (#1)
% -- node [anchor = west,
-% text width = {\WithArrowsRightX - \x1 - 0.5 em}] {##3}
-% (##2) ;
-% \draw let \p1 = (##1)
-% in (##1) -- ++(\WithArrowsRightX - \x1,0) |- (##2) ; }}
+% text width = {\WithArrowsRightX - \x1 - 0.5 em}] {#3}
+% (#2) ;
+% \draw let \p1 = (#1)
+% in (#1) -- ++(\WithArrowsRightX - \x1,0) |- (#2) ; }}
%
%\begin{DispWithArrows}[MyStyle]
% S_n
-% & = \frac1n \sum_{k=0}^{n-1}\cos\bigl(\tfrac{\pi}2\cdot\tfrac kn\bigr)
+% & = \frac{1}{n} \sum_{k=0}^{n-1}\cos\bigl(\tfrac{\pi}{2}\cdot\tfrac{k}{n}\bigr)
% \Arrow{$\cos x = \Re(e^{ix})$}\\
-% & = \frac1n\sum_{k=0}^{n-1} \Re\left(e^{i\frac{k\pi}{2n}}\right)
+% & = \frac{1}{n} \sum_{k=0}^{n-1} \Re\left(e^{i\frac{k\pi}{2n}}\right)
% \Arrow{$\Re(z+z')=\Re(z)+\Re(z')$}\\
-% & = \frac1n \Re\left(\sum_{k=0}^{n-1} e^{i\frac{k\pi}{2n}}\right)
+% & = \frac{1}{n} \Re\left(\sum_{k=0}^{n-1} e^{i\frac{k\pi}{2n}}\right)
% \Arrow{$\exp$ is a morphism for $\times$ and $+$} \\
-% & = \frac1n \Re \left(\sum_{k=0}^{n-1}\bigl(e^{i\frac{\pi}{2n}}\bigr)^k\right)
-% \Arrow{sum of terms of a geometric progression of ratio $e^{i\frac{2\pi}n}$}\\
-% & = \frac1n \Re \left( \frac{1-\bigl(e^{i\frac{\pi}{2n}}\bigr)^n}{1-e^{i\frac{\pi}{2n}}}\right)\\
-% & = \frac1n \Re \left(\frac{1-i}{1-e^{i\frac{\pi}{2n}}}\right)
+% & = \frac{1}{n} \Re \left(\sum_{k=0}^{n-1}\bigl(e^{i\frac{\pi}{2n}}\bigr)^k\right)
+% \Arrow{sum of terms of a geometric progression of ratio $e^{i\frac{2\pi}{n}}$}\\
+% & = \frac{1}{n}
+% \Re \left( \frac{1-\bigl(e^{i\frac{\pi}{2n}}\bigr)^n}{1-e^{i\frac{\pi}{2n}}}\right)\\
+% & = \frac{1}{n} \Re \left(\frac{1-i}{1-e^{i\frac{\pi}{2n}}}\right)
% \end{DispWithArrows}
%
%
@@ -2562,23 +2666,23 @@ version 2005/12/01 or later.
% the start row is longer than the end row or not. This example requires the
% Tikz library \pkg{calc}.
%
-% \begin{Verbatim}
+% \begin{Code}
% \begin{WithArrows}[ll,interline=5mm,xoffset=5mm,
-% ~emphase#tikz-code = {\draw[rounded corners,@
-% ~emphase# every node/.style = {circle,@
-% ~emphase# draw,@
-% ~emphase# auto = false,@
-% ~emphase# inner sep = 1pt,@
-% ~emphase# fill = gray!50,@
-% ~emphase# font = \tiny }]@
-% ~emphase# let \p1 = (~#1),@
-% ~emphase# \p2 = (~#2)@
-% ~emphase# in \ifdim \x1 > \x2@
-% ~emphase# (\p1) -- node {~#3} (\x1,\y2) -- (\p2)@
-% ~emphase# \else@
-% ~emphase# (\p1) -- (\x2,\y1) -- node {~#3} (\p2)@
-% ~emphase# \fi ;}@]
-% E & \Longleftrightarrow \frac{(x+4)}3 + \frac{5x+3}5 = 7
+% \emph{tikz-code = {\draw[rounded corners,
+% every node/.style = {circle,
+% draw,
+% auto = false,
+% inner sep = 1pt,
+% fill = gray!50,
+% font = \tiny }]
+% let \p1 = (~#1),
+% \p2 = (~#2)
+% in \ifdim \x1 > \x2
+% (\p1) -- node {~#3} (\x1,\y2) -- (\p2)
+% \else
+% (\p1) -- (\x2,\y1) -- node {~#3} (\p2)
+% \fi ;}}]
+% E & \Longleftrightarrow \frac{(x+4)}{3} + \frac{5x+3}{5} = 7
% \Arrow{$\times 15$}\\
% & \Longleftrightarrow 5(x+4) + 3(5x+3) = 105 \\
% & \Longleftrightarrow 5x+20 + 15x+9 = 105 \\
@@ -2588,7 +2692,7 @@ version 2005/12/01 or later.
% \Arrow{$\div 20$}\\
% & \Longleftrightarrow x = \frac{38}{10}
% \end{WithArrows}
-% \end{Verbatim}
+% \end{Code}
%
%
% \[\begin{WithArrows}[ll,interline=5mm,xoffset=5mm,
@@ -2606,7 +2710,7 @@ version 2005/12/01 or later.
% \else
% (\p1) -- (\x2,\y1) -- node {#3} (\p2)
% \fi ;}]
-% E & \Longleftrightarrow \frac{(x+4)}3 + \frac{5x+3}5 = 7
+% E & \Longleftrightarrow \frac{(x+4)}{3} + \frac{5x+3}{5} = 7
% \Arrow{$\times 15$}\\
% & \Longleftrightarrow 5(x+4) + 3(5x+3) = 105 \\
% & \Longleftrightarrow 5x+20 + 15x+9 = 105 \\
@@ -2641,15 +2745,15 @@ version 2005/12/01 or later.
%
%
% \bigskip
-% \begin{Verbatim}
-% $\begin{WithArrows}[~emphase#code-after = \NumberedLoop@]
+% \begin{Code}
+% $\begin{WithArrows}[\emph{code-after = \NumberedLoop}]
% a.\;& f \text{ est continuous on } E \\
% b.\;& f \text{ est continuous in } 0 \\
% c.\;& f \text{ is bounded on the unit sphere} \\
% d.\;& \exists K > 0\quad \forall x \in E\quad \|f(x)\| \le K \|x\| \\
% e.\;& f \text{ is lipschitzian}
% \end{WithArrows}$
-% \end{Verbatim}
+% \end{Code}
%
% \bigskip
% \begin{scope}
@@ -2675,9 +2779,9 @@ version 2005/12/01 or later.
% example, numbers in round brackets, the best way is to change the value of
% |tikz-code|:
%
-% \begin{Verbatim}
-% tikz-code = {\draw (~#1) to node {\footnotesize (~#3)} (~#2) ;}
-% \end{Verbatim}
+% \begin{Code}
+% tikz-code = {\draw (#1) to node {\footnotesize (#3)} (#2) ;}
+% \end{Code}
%
% \WithArrowsOptions{tikz-code = {\draw (#1) to node {\footnotesize (#3)} (#2) ;}}
%
@@ -2749,6 +2853,17 @@ version 2005/12/01 or later.
%</plain-TeX>
% \end{macrocode}
%
+%
+% \begin{macrocode}
+%<*LaTeX>
+\ProvideDocumentCommand{\IfPackageLoadedT}{mm}
+ {\IfPackageLoadedTF{#1}{#2}{}}
+\ProvideDocumentCommand{\IfPackageLoadedF}{mm}
+ {\IfPackageLoadedTF{#1}{}{#2}}
+%</LaTeX>
+% \end{macrocode}
+%
+%
% \bigskip
% \subsection{The packages footnote and footnotehyper}
%
@@ -2791,7 +2906,7 @@ version 2005/12/01 or later.
\cs_new_protected:Npn \@@_warning:n { \msg_warning:nn { witharrows } }
\cs_new_protected:Npn \@@_fatal:n { \msg_fatal:nn { witharrows } }
\cs_new_protected:Npn \@@_error:nn { \msg_error:nnn { witharrows } }
-\cs_generate_variant:Nn \@@_error:nn { n x }
+\cs_generate_variant:Nn \@@_error:nn { n e }
% \end{macrocode}
%
% \bigskip
@@ -2808,11 +2923,16 @@ version 2005/12/01 or later.
% \begin{macrocode}
\bool_set:Nn \c_@@_messages_for_Overleaf_bool
{
- \str_if_eq_p:Vn \c_sys_jobname_str { _region_ } % for Emacs
- || \str_if_eq_p:Vn \c_sys_jobname_str { output } % for Overleaf
+ \str_if_eq_p:on \c_sys_jobname_str { _region_ } % for Emacs
+ || \str_if_eq_p:on \c_sys_jobname_str { output } % for Overleaf
}
% \end{macrocode}
%
+% \bigskip
+% \begin{macrocode}
+\bool_new:N \g_@@_beamer_bool
+% \end{macrocode}
+%
% \medskip
% We define a set of keys |WithArrows/package| for these options.
% \begin{macrocode}
@@ -2821,8 +2941,12 @@ version 2005/12/01 or later.
{
footnote .bool_set:N = \c_@@_footnote_bool ,
footnotehyper .bool_set:N = \c_@@_footnotehyper_bool ,
- unknown .code:n =
- \@@_fatal:n { Option~unknown~for~package }
+ footnote .usage:n = load ,
+ footnotehyper .usage:n = load ,
+ beamer .bool_gset:N = \g_@@_beamer_bool ,
+ beamer .default:n = true ,
+ beamer .usage:n = load ,
+ unknown .code:n = \@@_fatal:n { Option~unknown~for~package }
}
% \end{macrocode}
%
@@ -2841,6 +2965,11 @@ version 2005/12/01 or later.
% \begin{macrocode}
\ProcessKeysOptions { WithArrows / package }
% \end{macrocode}
+%
+% \begin{macrocode}
+\IfClassLoadedT { beamer } { \bool_gset_true:N \g_@@_beamer_bool }
+\IfPackageLoadedT { beamerarticle } { \bool_gset_true:N \g_@@_beamer_bool }
+% \end{macrocode}
%
% \medskip
% \begin{macrocode}
@@ -2985,7 +3114,10 @@ version 2005/12/01 or later.
%
%
% \begin{macrocode}
-\cs_generate_variant:Nn \seq_set_split:Nnn { N x x }
+\cs_generate_variant:Nn \seq_set_split:Nnn { N e e }
+\cs_generate_variant:Nn \keys_precompile:nnN { n n c }
+\prg_generate_conditional_variant:Nnn \tl_if_novalue:n { o } { F }
+\exp_args_generate:n { N N N n o }
% \end{macrocode}
%
%
@@ -3005,13 +3137,13 @@ version 2005/12/01 or later.
% \end{macrocode}
%
% \bigskip
-% The following command creates a sequence of strings (|str|) from a |clist|.
+% The following command creates a sequence of strings (|str|) from a |clist|.
%
% \begin{macrocode}
\cs_new_protected:Npn \@@_set_seq_of_str_from_clist:Nn #1 #2
{
\seq_set_from_clist:Nn #1 { #2 }
- \seq_set_map_x:NNn #1 #1 { \tl_to_str:n { ##1 } }
+ \seq_set_map_e:NNn #1 #1 { \tl_to_str:n { ##1 } }
}
% \end{macrocode}
%
@@ -3025,14 +3157,14 @@ version 2005/12/01 or later.
% \begin{macrocode}
\cs_new_protected:Npn \@@_save:N #1
{
- \seq_set_split:Nxx \l_tmpa_seq
+ \seq_set_split:Nee \l_tmpa_seq
{ \char_generate:nn { `_ } { 12 } }
{ \cs_to_str:N #1 }
\seq_pop_left:NN \l_tmpa_seq \l_tmpa_tl
% \end{macrocode}
% The string |\l_tmpa_str| will contains the \emph{type} of the variable.
% \begin{macrocode}
- \str_set:Nx \l_tmpa_str { \seq_item:Nn \l_tmpa_seq { -1 } }
+ \str_set:Ne \l_tmpa_str { \seq_item:Nn \l_tmpa_seq { -1 } }
\use:c { \l_tmpa_str _if_exist:cF }
{ g _\seq_use:Nnnn \l_tmpa_seq _ _ _ }
{
@@ -3050,11 +3182,11 @@ version 2005/12/01 or later.
% \begin{macrocode}
\cs_new_protected:Npn \@@_restore:N #1
{
- \seq_set_split:Nxx \l_tmpa_seq
+ \seq_set_split:Nee \l_tmpa_seq
{ \char_generate:nn { `_ } { 12 } }
{ \cs_to_str:N #1 }
\seq_pop_left:NN \l_tmpa_seq \l_tmpa_tl
- \str_set:Nx \l_tmpa_str { \seq_item:Nn \l_tmpa_seq { -1 } }
+ \str_set:Ne \l_tmpa_str { \seq_item:Nn \l_tmpa_seq { -1 } }
\use:c { \l_tmpa_str _set_eq:Nc }
#1 { g_\seq_use:Nnnn \l_tmpa_seq _ _ _ }
}
@@ -3251,7 +3383,7 @@ version 2005/12/01 or later.
% \begin{tabular}{l}
% \begin{tabular}{@{}l*8c@{}}
% \toprule
-% option & |lr| & |ll| & |rl| & |rr| & |v| & |i| & |groups| & |group| \\
+% option & |lr| & |ll| & |rl| & |rr| & |v| & |i| & |groups| & |group| \\
% \midrule
% |\l_@@_pos_arrow_int| & $0$ & $1$ & $2$ & $3$ & $4$ & $5$ & $6$ & $7$ \\
% \bottomrule
@@ -3320,7 +3452,7 @@ version 2005/12/01 or later.
% \begin{macrocode}
\cs_new_protected:Npn \@@_test_if_to_tag:
{
- \clist_if_in:NVT \l_@@_tags_clist \g_@@_line_int
+ \clist_if_in:NoT \l_@@_tags_clist \g_@@_line_int
{ \clist_set:Nn \l_@@_tags_clist { all } }
}
%</LaTeX>
@@ -3344,7 +3476,7 @@ version 2005/12/01 or later.
% be |Explanation|, this string will contain ``|\Arrow alias \Explanation|''.
% \begin{macrocode}
\str_new:N \l_@@_string_Arrow_for_msg_str
-\str_set:Nx \l_@@_string_Arrow_for_msg_str { \token_to_str:N \Arrow }
+\str_set:Ne \l_@@_string_Arrow_for_msg_str { \token_to_str:N \Arrow }
% \end{macrocode}
%
% \bigskip
@@ -3513,7 +3645,7 @@ version 2005/12/01 or later.
more-columns .value_forbidden:n = true ,
command-name .code:n =
\str_set:Nn \l_@@_command_name_str { #1 }
- \str_set:Nx \l_@@_string_Arrow_for_msg_str
+ \str_set:Ne \l_@@_string_Arrow_for_msg_str
{ \c_backslash_str Arrow~alias~\c_backslash_str #1 } ,
command-name .value_required:n = true ,
tikz-code .tl_set:N = \l_@@_tikz_code_tl ,
@@ -3533,7 +3665,7 @@ version 2005/12/01 or later.
\int_set:Nn \l_@@_pos_arrow_int 7
}
{ \@@_error:n { Incompatible~options } } ,
- group .value_forbidden:n = true ,
+ group .value_forbidden:n = true ,
groups .code:n =
\str_if_empty:NTF \l_@@_previous_key_str
{
@@ -3546,7 +3678,6 @@ version 2005/12/01 or later.
{ \@@_error:n { Incompatible~options } } ,
groups .value_forbidden:n = true ,
tikz .code:n = \tikzset { WithArrows / arrow / .append~style = { #1 } } ,
- tikz .initial:n = \c_empty_tl ,
tikz .value_required:n = true ,
rr .code:n = \@@_fix_pos_option:n 3 ,
rr .value_forbidden:n = true ,
@@ -3620,8 +3751,8 @@ version 2005/12/01 or later.
\AtBeginDocument
{
\bool_set_false:N \l_tmpa_bool
- \IfPackageLoadedTF { amsmath } { \bool_set_true:N \l_tmpa_bool } { }
- \IfPackageLoadedTF { unicode-math } { \bool_set_true:N \l_tmpa_bool } { }
+ \IfPackageLoadedT { amsmath } { \bool_set_true:N \l_tmpa_bool }
+ \IfPackageLoadedT { unicode-math } { \bool_set_true:N \l_tmpa_bool }
\bool_if:NT \l_tmpa_bool
{ \clist_put_right:Nn \c_@@_ext_delimiters_clist { \lvert, \lVert } }
}
@@ -3681,8 +3812,8 @@ version 2005/12/01 or later.
wrap-lines .default:n = true ,
replace-left-brace-by .code:n =
{
- \tl_set:Nx \l_tmpa_tl { \tl_head:n { #1 } }
- \clist_if_in:NVTF
+ \tl_set:Ne \l_tmpa_tl { \tl_head:n { #1 } }
+ \clist_if_in:NoTF
\c_@@_ext_delimiters_clist
\l_tmpa_tl
{ \tl_set:Nn \l_@@_replace_left_brace_by_tl { #1 } }
@@ -3717,9 +3848,9 @@ version 2005/12/01 or later.
% list of |str|.
% \begin{macrocode}
\str_set:Nn \l_tmpa_str { #1 }
- \seq_if_in:NVTF \g_@@_names_seq \l_tmpa_str
+ \seq_if_in:NoTF \g_@@_names_seq \l_tmpa_str
{ \@@_error:n { Duplicate~name } }
- { \seq_gput_left:NV \g_@@_names_seq \l_tmpa_str }
+ { \seq_gput_left:No \g_@@_names_seq \l_tmpa_str }
\str_set_eq:NN \l_@@_name_str \l_tmpa_str ,
name .value_required:n = true ,
code-before .code:n = \tl_put_right:Nn \l_@@_code_before_tl { #1 } ,
@@ -3877,7 +4008,7 @@ version 2005/12/01 or later.
% \begin{macrocode}
\cs_new_protected:Npn \@@_set_independent:
{
- \str_if_eq:VnF \l_keys_value_tl { NoValue }
+ \str_if_eq:onF \l_keys_value_tl { NoValue }
{ \@@_error:n { Value~for~a~key } }
\@@_set_independent_bis:
}
@@ -3911,7 +4042,7 @@ version 2005/12/01 or later.
\keys_define:nn { WithArrows / Arrow / FirstPass }
{
jump .code:n =
- \int_compare:nTF { #1 > 0 }
+ \int_compare:nNnTF { #1 } > \c_zero_int
{ \int_set:Nn \l_@@_jump_int { #1 } }
{ \@@_error:n { Negative~jump } } ,
jump .value_required:n = true,
@@ -3962,7 +4093,7 @@ version 2005/12/01 or later.
xoffset .code:n = ,
unknown .code:n =
\@@_sort_seq:N \l_@@_options_Arrow_seq
- \seq_if_in:NVTF \l_@@_options_WithArrows_seq \l_keys_key_str
+ \seq_if_in:NoTF \l_@@_options_WithArrows_seq \l_keys_key_str
{
\str_set:Nn \l_tmpa_str
{ ~However,~this~key~can~be~used~in~the~options~of~{WithArrows}. }
@@ -4009,7 +4140,6 @@ version 2005/12/01 or later.
tikz-code .tl_set:N = \l_@@_tikz_code_tl ,
tikz-code .initial:n = \draw~(#1)~to~node{#3}~(#2)~; ,
tikz .code:n = \tikzset { WithArrows / arrow / .append~style = { #1 } } ,
- tikz .initial:n = \c_empty_tl ,
rr .code:n = \@@_fix_pos_arrow:n 3 ,
ll .code:n = \@@_fix_pos_arrow:n 1 ,
rl .code:n = \@@_fix_pos_arrow:n 2 ,
@@ -4024,13 +4154,11 @@ version 2005/12/01 or later.
% arrow.
% \begin{macrocode}
xoffset .code:n =
- \bool_if:nTF
+ \bool_lazy_all:nTF
{
- \int_compare_p:nNn \g_@@_arrow_int > 1
- &&
- \int_compare_p:nNn \l_@@_pos_arrow_int > 5
- &&
- ! \str_if_eq_p:Vn \l_@@_status_arrow_str { independent }
+ { \int_compare_p:nNn \g_@@_arrow_int > 1 }
+ { \int_compare_p:nNn \l_@@_pos_arrow_int > 5 }
+ { ! \str_if_eq_p:on \l_@@_status_arrow_str { independent } }
}
{ \@@_error:n { Option~xoffset~forbidden } }
{ \dim_set:Nn \l_@@_xoffset_dim { #1 } } ,
@@ -4070,16 +4198,29 @@ version 2005/12/01 or later.
% at the beginning of an environment |{WithArrows}|, |\Arrow| is set to be
% equivalent to |\@@_Arrow|. However, the user can change the name with the
% option |command-name| and the user command for |\@@_Arrow| will be different.
-% This mechanism can be useful when the user has already a command named
-% |\Arrow| he still wants to use in the environments |{WithArrows}| or
+% This mechanism can be useful when the user already has a command named
+% |\Arrow| that he still wants to use in the environments |{WithArrows}| or
% |{DispWithArrows}|.
%
% \medskip
% \begin{macrocode}
%<*LaTeX>
\cs_new_protected:Npn \@@_Arrow
- { \@@_collect_options:n { \@@_Arrow_i } }
-\NewDocumentCommand \@@_Arrow_i { m m ! O { } }
+ { \@@_collect_options:n { \@@_Arrow_iii } }
+\bool_if:NTF \g_@@_beamer_bool
+ {
+ \NewDocumentCommand \@@_Arrow_iii { m d < > m ! O { } }
+ {
+ \tl_if_novalue:nTF { #2 }
+ { \@@_Arrow_ii { #1 } { #3 } [ #4 ] }
+ { \only <#2> { \@@_Arrow_ii { #1 } { #3 } [ #4 ] } }
+ }
+ }
+ {
+ \NewDocumentCommand \@@_Arrow_iii { m m ! O { } }
+ { \@@_Arrow_ii { #1 } { #2 } [ #3 ] }
+ }
+\NewDocumentCommand \@@_Arrow_ii { m m ! O { } }
%</LaTeX>
%<*plain-TeX>
\cs_new_protected:Npn \@@_Arrow
@@ -4146,7 +4287,7 @@ version 2005/12/01 or later.
% \item The ``status'' of the arrow, with 4 possible values: empty,
% |independent|, |new-group| or |over|.
% \begin{macrocode}
- \prop_put:NnV \l_tmpa_prop { status } \l_@@_status_arrow_str
+ \prop_put:Nno \l_tmpa_prop { status } \l_@@_status_arrow_str
% \end{macrocode}
%
% \item The options of the arrow (it's a token list):
@@ -4162,7 +4303,7 @@ version 2005/12/01 or later.
% \item The number of the line where the command |\Arrow| is issued in the TeX
% source (as of now, this is only useful for some error messages).
% \begin{macrocode}
- \prop_put:Nnx \l_tmpa_prop { input-line } \msg_line_number:
+ \prop_put:Nne \l_tmpa_prop { input-line } \msg_line_number:
% \end{macrocode}
%
% \item The total width of the arrow (with the label)... but we don't know it
@@ -4288,10 +4429,10 @@ version 2005/12/01 or later.
% command |\omit| in a cell of the |\halign| (it should be forbidden).
% For example, in the part of the preamble concerning the third column (if there
% is a third column in the environment), we will have the following instructions :
-% \begin{Verbatim}
-% \int_gincr:N \g_~@~@_col_int
-% \int_set:Nn \g_~@~@_static_col_int 3
-% \end{Verbatim}
+% \begin{Code}
+% \int_gincr:N \g_@@_col_int
+% \int_set:Nn \g_@@_static_col_int 3
+% \end{Code}
% The counter |\g_@@_col_int| is incremented dynamically and the second is
% static. If the user has used a command |\omit|, the dynamic incrementation is
% not done in the cell and, at the end of the row, the difference between the
@@ -4314,7 +4455,7 @@ version 2005/12/01 or later.
\seq_set_eq:NN \l_tmpa_seq \g_@@_position_in_the_tree_seq
\seq_pop_right:NN \l_tmpa_seq \l_tmpa_tl
\str_clear_new:N \l_@@_prefix_str
- \str_set:Nx \l_@@_prefix_str { \seq_use:Nnnn \l_tmpa_seq - - - }
+ \str_set:Ne \l_@@_prefix_str { \seq_use:Nnnn \l_tmpa_seq - - - }
% \end{macrocode}
%
% \bigskip
@@ -4564,23 +4705,23 @@ version 2005/12/01 or later.
% The command |\@@_set_qedhere:| will do a redefinition of |\qedhere| in each
% cell of the last column.
% \begin{macrocode}
- \IfPackageLoadedTF { amsmath } { \@@_set_qedhere: } { }
+ \IfPackageLoadedT { amsmath } { \@@_set_qedhere: }
}
%</LaTeX>
}
- \str_if_eq:VnT \l_@@_type_col_str { c } \hfil
- \str_if_eq:VnT \l_@@_type_col_str { C } \hfil
- \str_if_eq:VnT \l_@@_type_col_str { r } \hfill
- \str_if_eq:VnT \l_@@_type_col_str { R } \hfill
+ \str_if_eq:onT \l_@@_type_col_str { c } \hfil
+ \str_if_eq:onT \l_@@_type_col_str { C } \hfil
+ \str_if_eq:onT \l_@@_type_col_str { r } \hfill
+ \str_if_eq:onT \l_@@_type_col_str { R } \hfill
\int_gincr:N \g_@@_col_int
\int_gset:Nn \g_@@_static_col_int { \int_use:N \g_@@_col_int }
\c_math_toggle_token
- \str_if_eq:VnT \l_@@_type_col_str { C } { { } }
- \str_if_eq:VnT \l_@@_type_col_str { L } { { } }
+ \str_if_eq:onT \l_@@_type_col_str { C } { { } }
+ \str_if_eq:onT \l_@@_type_col_str { L } { { } }
\bool_if:NT \l_@@_displaystyle_bool \displaystyle
##
- \str_if_eq:VnT \l_@@_type_col_str { C } { { } }
- \str_if_eq:VnT \l_@@_type_col_str { R } { { } }
+ \str_if_eq:onT \l_@@_type_col_str { C } { { } }
+ \str_if_eq:onT \l_@@_type_col_str { R } { { } }
\c_math_toggle_token
\int_compare:nNnTF \g_@@_col_int = \l_@@_nb_cols_int
\@@_construct_nodes:
@@ -4590,10 +4731,10 @@ version 2005/12/01 or later.
% because, in the last cell, a glue (=skip) is added between the nodes (in
% |\@@_construct_nodes:|).
% \begin{macrocode}
- \str_if_eq:VnT \l_@@_type_col_str { l } \hfil
- \str_if_eq:VnT \l_@@_type_col_str { L } \hfil
- \str_if_eq:VnT \l_@@_type_col_str { c } \hfil
- \str_if_eq:VnT \l_@@_type_col_str { C } \hfil
+ \str_if_eq:onT \l_@@_type_col_str { l } \hfil
+ \str_if_eq:onT \l_@@_type_col_str { L } \hfil
+ \str_if_eq:onT \l_@@_type_col_str { c } \hfil
+ \str_if_eq:onT \l_@@_type_col_str { C } \hfil
\bool_if:NT \l_@@_in_DispWithArrows_bool { \tabskip = \c_zero_skip }
&
}
@@ -4788,7 +4929,7 @@ version 2005/12/01 or later.
\hbox_set_end:
\@@_post_halign:
% \end{macrocode}
-% We want to add white space on the right side of the box in order to take into
+% We want to add white space on the right side of the box in order to take into
% account the arrows and their labels.
% \begin{macrocode}
\bool_if:NF \l_@@_right_overlap_bool
@@ -4844,7 +4985,7 @@ version 2005/12/01 or later.
% \bigskip
% If there is really arrows in the environment, we draw the arrows.
% \begin{macrocode}
- \int_compare:nNnT \g_@@_arrow_int > 0
+ \int_if_zero:nF \g_@@_arrow_int
{
% \end{macrocode}
% If there is only one arrow, the options |group| and |groups| do not really
@@ -4892,7 +5033,7 @@ version 2005/12/01 or later.
% \begin{macrocode}
\seq_gpop_right:NN \g_@@_position_in_the_tree_seq \l_tmpa_tl
\seq_gpop_right:NN \g_@@_position_in_the_tree_seq \l_tmpa_tl
- \seq_gput_right:Nx \g_@@_position_in_the_tree_seq
+ \seq_gput_right:Ne \g_@@_position_in_the_tree_seq
{ \int_eval:n { \l_tmpa_tl + 1 } }
% \end{macrocode}
%
@@ -4959,7 +5100,7 @@ version 2005/12/01 or later.
%
% \bigskip
% Now, we test if the next token is the token |\end|. Indeed, we want to test if
-% the following tokens are |\end{WithArrows}| (or |\end{DispWithArrows}|, etc).
+% the following tokens are |\end{WithArrows}| (or |\end{Code}|, etc).
% In this case, we raise an error because the user must not put "\\" at the end
% of its alignment.
% \begin{macrocode}
@@ -5024,7 +5165,7 @@ version 2005/12/01 or later.
% line. We use a global variable because we will use it in the \emph{next} cell
% (after the |&|).
% \begin{macrocode}
- \cs_gset:Npx \g_tmpa_tl
+ \cs_gset:Npe \g_tmpa_tl
{ \tl_if_empty:NTF \l_@@_tag_tl \theequation \l_@@_tag_tl }
% \end{macrocode}
% It's possible to put several labels for the same line (it's not possible in
@@ -5040,25 +5181,24 @@ version 2005/12/01 or later.
%
% First an action which is in the definition of |\refstepcounter|.
% \begin{macrocode}
- \cs_set:Npx \@currentlabel { \p@equation \g_tmpa_tl }
+ \cs_set:Npe \@currentlabel { \p@equation \g_tmpa_tl }
% \end{macrocode}
% Then, an action done by \pkg{hyperref} in its redefinition of
% |\refstepcounter|.
% \begin{macrocode}
- \IfPackageLoadedTF { hyperref }
+ \IfPackageLoadedT { hyperref }
{
% the following line is probably pointless (2022/05/16)
% \str_set:Nn \This@name { equation }
\hyper@refstepcounter { equation }
}
- { }
% \end{macrocode}
% Then, an action done by \pkg{cleveref} in its redefinition of
% |\refstepcounter|. The package \pkg{cleveref} creates in the |aux| file a
% command |\cref@currentlabel| similar to |\@currentlabel| but with more
% informations.
% \begin{macrocode}
- \IfPackageLoadedTF { cleveref }
+ \IfPackageLoadedT { cleveref }
{
\cref@constructprefix { equation } \cref@result
\protected@edef \cref@currentlabel
@@ -5072,7 +5212,6 @@ version 2005/12/01 or later.
\p@equation \g_tmpa_tl
}
}
- { }
% \end{macrocode}
% Now, we can issue the command |\label| (some packages may have redefined
% |\label|, for example \pkg{typedref}) for each item in the sequence of the
@@ -5098,7 +5237,7 @@ version 2005/12/01 or later.
\@@_restore:N \l_@@_tag_star_bool
\@@_restore:N \l_@@_qedhere_bool
\bool_if:NT \l_@@_qedhere_bool
- { \hbox_overlap_left:n \@@_qedhere_i: }
+ { \hbox_overlap_left:n \@@_qedhere_i: }
\cs_set_eq:NN \theequation \g_tmpa_tl
\bool_if:NT \l_@@_tag_star_bool
{ \cs_set_eq:NN \tagform@ \prg_do_nothing: }
@@ -5140,7 +5279,7 @@ version 2005/12/01 or later.
%<*LaTeX>
\@@_restore:N \l_@@_qedhere_bool
\bool_if:NT \l_@@_qedhere_bool
- { \hbox_overlap_left:n \@@_qedhere_i: }
+ { \hbox_overlap_left:n \@@_qedhere_i: }
%</LaTeX>
\pgfpicture
\pgfrememberpicturepositiononpagetrue
@@ -5179,7 +5318,7 @@ version 2005/12/01 or later.
%<*LaTeX>
\cs_new_protected:Npn \@@_analyze_end:Nn #1 #2
{
- \str_if_eq:VnT \l_@@_type_env_str { #2 }
+ \str_if_eq:onT \l_@@_type_env_str { #2 }
{
\@@_error:n { newline~at~the~end~of~env }
\group_begin:
@@ -5212,8 +5351,8 @@ version 2005/12/01 or later.
%
%
% \bigskip
-% The boolean |\l_@@_in_label_or_minipage_bool| will be raised if we are just after a |\item|
-% of a list of LaTeX or at the beginning of a |{minipage}|.
+% The boolean |\l_@@_in_label_or_minipage_bool| will be raised if we are just
+% after a |\item| of a list of LaTeX or at the beginning of a |{minipage}|.
% \begin{macrocode}
%<*LaTeX>
\bool_new:N \l_@@_in_label_or_minipage_bool
@@ -5254,7 +5393,7 @@ version 2005/12/01 or later.
% |\item| of a LaTeX list and an environment |{DispWithArrows}| except with the
% option |standard-behaviour-with-items| stored in the boolean
% |\l_@@_sbwi_bool|. We have to know if we are just after an |\item| and this
-% information will be stored in |\l_@@_in_label_or_minipage_bool|. We have to do
+% information will be stored in |\l_@@_in_label_or_minipage_bool|. We have to do
% this test quicky after the beginning of the environment (in particular,
% because it must be done before the execution of the
% |code-before|\footnote{The |code-before| is not meant to contains typesetting
@@ -5280,7 +5419,7 @@ version 2005/12/01 or later.
% environment).
% \begin{macrocode}
%<*LaTeX>
- \IfPackageLoadedTF { mathtools }
+ \IfPackageLoadedT { mathtools }
{
\MH_if_boolean:nT { show_only_refs }
{
@@ -5293,24 +5432,23 @@ version 2005/12/01 or later.
\MH_set_boolean_T:n { show_only_refs }
}
}
- { }
% \end{macrocode}
%
% An action done by \pkg{typedref} in its redefinition of |\refstepcounter|. The
% command |\sr@name| is a prefix added to the name of the label by the
% redefinition of |\label| done by \pkg{typedref}.
% \begin{macrocode}
- \IfPackageLoadedTF { typedref }
+ \IfPackageLoadedT { typedref }
{ \str_set:Nn \sr@name { equation } }
- { }
% \end{macrocode}
%
% The command |\intertext@| is a command of \pkg{amsmath} which loads the
% definition of |\intertext|.
% \begin{macrocode}
- \IfPackageLoadedTF { amsmath } { \intertext@ } { }
+ \IfPackageLoadedT { amsmath } { \intertext@ }
%</LaTeX>
- \exp_args:No \tl_if_novalue:nF { #1 } { \tl_set:Nn \l_@@_left_brace_tl { #1 } }
+ \tl_if_novalue:oF { #1 }
+ { \cs_set_nopar:Npn \l_@@_left_brace_tl { #1 } }
\@@_pre_halign:n { #2 }
% \end{macrocode}
%
@@ -5331,7 +5469,8 @@ version 2005/12/01 or later.
\hbox_set:Nn \l_tmpa_box
{
% \end{macrocode}
-% Even if the default value of |\nulldelimiterspace| is 1.2~pt, we take it into account.
+% Even if the default value of |\nulldelimiterspace| is 1.2~pt, we take it into
+% account.
% \begin{macrocode}
\group_begin:
\dim_zero:N \nulldelimiterspace
@@ -5395,7 +5534,7 @@ version 2005/12/01 or later.
%<*LaTeX>
\bool_if:NTF \l_@@_in_label_or_minipage_bool
{
- \noindent % added in v. 2.6d
+ \noindent
\c_math_toggle_token
}
{
@@ -5419,8 +5558,8 @@ version 2005/12/01 or later.
\dim_zero_new:N \l_@@_linewidth_dim
%<*LaTeX>
\bool_if:NTF \l_@@_in_label_or_minipage_bool
- { \dim_set_eq:NN \l_@@_linewidth_dim \linewidth }
- { \dim_set_eq:NN \l_@@_linewidth_dim \displaywidth }
+ { \dim_set_eq:NN \l_@@_linewidth_dim \linewidth }
+ { \dim_set_eq:NN \l_@@_linewidth_dim \displaywidth }
%</LaTeX>
%<*plain-TeX>
\dim_set_eq:NN \l_@@_linewidth_dim \displaywidth
@@ -5577,9 +5716,8 @@ version 2005/12/01 or later.
% the environment).
% \begin{macrocode}
%<*LaTeX>
- \IfPackageLoadedTF { mathtools }
+ \IfPackageLoadedT { mathtools }
{ \MH_if_boolean:nT { show_only_refs } \MT_showonlyrefs_true: }
- { }
\bool_if:NTF \l_@@_in_label_or_minipage_bool
{
\c_math_toggle_token
@@ -5672,8 +5810,8 @@ version 2005/12/01 or later.
%
% \bigskip
% The command |\@@_tag| will be linked to |\tag| in |{WithArrows}| and
-% |{DispWithArrows}|. We do the definition with |\NewDocumentCommand| because this
-% command has a starred version.
+% |{DispWithArrows}|. We do the definition with |\NewDocumentCommand| because
+% this command has a starred version.
% \begin{macrocode}
\NewDocumentCommand \@@_tag { s m }
{
@@ -5682,7 +5820,7 @@ version 2005/12/01 or later.
\tl_if_empty:NF \l_@@_tag_tl
{ \@@_error:nn { Multiple~tags } { #2 } }
\clist_set:Nn \l_@@_tags_clist { all }
- \IfPackageLoadedTF { mathtools }
+ \IfPackageLoadedT { mathtools }
{
\MH_if_boolean:nT { show_only_refs }
{
@@ -5690,7 +5828,6 @@ version 2005/12/01 or later.
{ \clist_clear:N \l_@@_tags_clist }
}
}
- { }
\tl_set:Nn \l_@@_tag_tl { #2 }
\bool_set:Nn \l_@@_tag_star_bool { #1 }
% \end{macrocode}
@@ -5702,8 +5839,7 @@ version 2005/12/01 or later.
% \begin{macrocode}
\bool_if:nT { #1 }
{
- \IfPackageLoadedTF { amsmath }
- { }
+ \IfPackageLoadedF { amsmath }
{ \@@_error:n { tag*~without~amsmath } }
}
}
@@ -5728,7 +5864,7 @@ version 2005/12/01 or later.
{ \@@_error:n { Multiple~labels } }
}
\seq_put_right:Nn \l_@@_labels_seq { #1 }
- \IfPackageLoadedTF { mathtools }
+ \IfPackageLoadedT { mathtools }
{
\MH_if_boolean:nT { show_only_refs }
{
@@ -5737,14 +5873,12 @@ version 2005/12/01 or later.
{ \clist_clear:N \l_@@_tags_clist }
}
}
- { }
- \IfPackageLoadedTF { autonum }
+ \IfPackageLoadedT { autonum }
{
\cs_if_exist:cTF { autonum@#1Referenced }
{ \clist_set:Nn \l_@@_tags_clist { all } }
{ \clist_clear:N \l_@@_tags_clist }
}
- { }
}
}
% \end{macrocode}
@@ -5935,12 +6069,9 @@ version 2005/12/01 or later.
% situation occurs when all the arrows of the potential group arrive after the
% last line of the environment).
% \begin{macrocode}
- \bool_if:nT
- {
- ! \int_compare_p:nNn \l_@@_pos_arrow_int = 7
- &&
- \int_compare_p:nNn \l_@@_first_arrow_of_group_int > 0
- }
+ \bool_lazy_and:nnT
+ { ! \int_compare_p:nNn \l_@@_pos_arrow_int = 7 }
+ { \int_compare_p:nNn \l_@@_first_arrow_of_group_int > \c_zero_int }
{ \@@_draw_arrows:nn \l_@@_first_arrow_of_group_int \g_@@_arrow_int }
}
% \end{macrocode}
@@ -5971,10 +6102,10 @@ version 2005/12/01 or later.
}
{ \bool_not_p:n { \int_compare_p:nNn \l_@@_pos_arrow_int = 7 } }
}
- { \str_if_eq_p:Vn \l_@@_status_arrow_str { new-group } }
+ { \str_if_eq_p:on \l_@@_status_arrow_str { new-group } }
}
{
- \int_compare:nNnF \l_@@_first_arrow_of_group_int = \c_zero_int
+ \int_if_zero:nF \l_@@_first_arrow_of_group_int
{
\@@_draw_arrows:nn
\l_@@_first_arrow_of_group_int
@@ -6027,14 +6158,13 @@ version 2005/12/01 or later.
% If the arrow is independent, we don't take into account that arrow for the
% detection of the end of the group.
% \begin{macrocode}
- \str_if_eq:VnF \l_@@_status_arrow_str { independent }
+ \str_if_eq:onF \l_@@_status_arrow_str { independent }
{
% \end{macrocode}
% If the arrow is not independent, the arrow belongs to the current group and we
% have to take it into account in some variables.
% \begin{macrocode}
- \int_compare:nT
- { \l_@@_initial_int = \l_@@_first_line_of_group_int }
+ \int_compare:nNnT \l_@@_initial_int = \l_@@_first_line_of_group_int
{ \seq_put_left:NV \l_@@_first_arrows_seq \l_@@_arrow_int }
\int_compare:nNnTF \l_@@_final_int > \l_@@_last_line_of_group_int
{
@@ -6057,7 +6187,7 @@ version 2005/12/01 or later.
% 8), we don't initialize |\l_@@_x_dim| because we want to use the same value of
% |\l_@@_x_dim| (computed during the first step) for all the groups.
% \begin{macrocode}
- \str_if_eq:VnF \l_@@_status_arrow_str { independent }
+ \str_if_eq:onF \l_@@_status_arrow_str { independent }
{
\int_compare:nNnF \l_@@_pos_arrow_int = 8
{ \@@_update_x:nn \l_@@_initial_int \l_@@_final_int }
@@ -6066,14 +6196,6 @@ version 2005/12/01 or later.
% \end{macrocode}
%
%
-% \bigskip
-% The following code is necessary because we will have to expand an argument
-% exactly 3 times.
-% \begin{macrocode}
-\cs_generate_variant:Nn \keys_set:nn { n o }
-\cs_new_protected:Npn \@@_keys_set:
- { \keys_set_known:no { WithArrows / Arrow / SecondPass } }
-% \end{macrocode}
%
% \bigskip
% The macro |\@@_draw_arrows:nn| draws all the arrows whose numbers are between
@@ -6133,7 +6255,7 @@ version 2005/12/01 or later.
% arrows will be drawn after all the other arrows).
% \begin{macrocode}
{
- \str_if_eq:VnTF \l_@@_status_arrow_str { over }
+ \str_if_eq:onTF \l_@@_status_arrow_str { over }
{ \seq_put_right:NV \l_@@_o_arrows_seq \l_@@_arrow_int }
\@@_draw_arrow:
}
@@ -6144,6 +6266,7 @@ version 2005/12/01 or later.
}
% \end{macrocode}
%
+%
% \bigskip
% The first |\group_begin:| is for the options of the arrows (but we remind that
% the options |ll|, |rr|, |rl|, |lr|, |i| and |jump| have already been extracted
@@ -6155,17 +6278,24 @@ version 2005/12/01 or later.
% \end{macrocode}
%
% \bigskip
-% We process the options of the current arrow. The second argument of
-% |\keys_set:nn| must be expanded exactly three times. An x-expansion is not
-% possible because there can be tokens like |\bfseries| in the option |font| of
-% the option |tikz|. This expansion is a bit tricky.
+% We process the options of the current arrow.
% \begin{macrocode}
\prop_get:cnN
{ g_@@_arrow _\l_@@_prefix_str _ \int_use:N \l_@@_arrow_int _ prop }
- { options } \l_tmpa_tl
+ { options }
+ \l_tmpa_tl
\str_clear_new:N \l_@@_previous_key_str
- \exp_args:NNo \exp_args:No
- \@@_keys_set: { \l_tmpa_tl , tikz = { xshift = \l_@@_xoffset_dim } }
+% \end{macrocode}
+%
+% We will expand the second argument of |\keys_set_known:nn| exactly three
+% times. Maybe that an e-expansion would be possible but, in the past, there
+% were problems with fragile commands such as |\bfseries| in the option
+% |font| of the option |tikz| (it seems that this no longer the case).
+% \begin{macrocode}
+ \exp_args:NNNno \exp_args:NNno \exp_args:Nno
+ \keys_set_known:nn
+ { WithArrows / Arrow / SecondPass }
+ { \l_tmpa_tl , tikz = { xshift = \l_@@_xoffset_dim } }
% \end{macrocode}
%
% We create two booleans to indicate the position of the initial node and final
@@ -6219,9 +6349,9 @@ version 2005/12/01 or later.
% the point will perhaps have another
% $x$-value --- but always the same $y$-value). Idem for |\l_@@_final_tl|.
% \begin{macrocode}
- \tl_set:Nx \l_@@_initial_tl
+ \tl_set:Ne \l_@@_initial_tl
{ \int_use:N \l_@@_initial_int - \bool_if:NTF \l_@@_initial_r_bool rl }
- \tl_set:Nx \l_@@_final_tl
+ \tl_set:Ne \l_@@_final_tl
{ \int_use:N \l_@@_final_int - \bool_if:NTF \l_@@_final_r_bool rl }
% \end{macrocode}
%
@@ -6244,11 +6374,11 @@ version 2005/12/01 or later.
% done in the following |{tikzpicture}| because of the command |\seq_if_in:NnTF|
% which is \emph{not} expandable.
% \begin{macrocode}
- \seq_if_in:NxTF \l_@@_first_arrows_seq
+ \seq_if_in:NeTF \l_@@_first_arrows_seq
{ \int_use:N \l_@@_arrow_int }
{ \bool_set_true:N \l_tmpa_bool }
{ \bool_set_false:N \l_tmpa_bool }
- \seq_if_in:NxTF \l_@@_last_arrows_seq
+ \seq_if_in:NeTF \l_@@_last_arrows_seq
{ \int_use:N \l_@@_arrow_int }
{ \bool_set_true:N \l_tmpb_bool }
{ \bool_set_false:N \l_tmpb_bool }
@@ -6293,7 +6423,7 @@ version 2005/12/01 or later.
}
{ \int_compare_p:nNn { \l_@@_final_int - \l_@@_initial_int } = 1 }
{
- \tl_gset:Nx \g_tmpa_tl
+ \tl_gset:Ne \g_tmpa_tl
{
\int_compare:nNnTF \l_@@_pos_arrow_int < 5
{ \dim_use:N \g_@@_x_initial_dim }
@@ -6304,7 +6434,7 @@ version 2005/12/01 or later.
+ 0.5 \l_@@_max_length_of_arrow_dim
}
}
- \tl_gset:Nx \g_tmpb_tl
+ \tl_gset:Ne \g_tmpb_tl
{
\int_compare:nNnTF \l_@@_pos_arrow_int < 5
{ \dim_use:N \g_@@_x_final_dim }
@@ -6317,7 +6447,7 @@ version 2005/12/01 or later.
}
}
{
- \tl_gset:Nx \g_tmpa_tl
+ \tl_gset:Ne \g_tmpa_tl
{
\int_compare:nNnTF \l_@@_pos_arrow_int < 5
{ \dim_use:N \g_@@_x_initial_dim }
@@ -6326,7 +6456,7 @@ version 2005/12/01 or later.
{ \dim_eval:n { \g_@@_y_initial_dim + \l_@@_start_adjust_dim } }
{ \dim_use:N \g_@@_y_initial_dim }
}
- \tl_gset:Nx \g_tmpb_tl
+ \tl_gset:Ne \g_tmpb_tl
{
\int_compare:nNnTF \l_@@_pos_arrow_int < 5
{ \dim_use:N \g_@@_x_final_dim }
@@ -6392,12 +6522,13 @@ version 2005/12/01 or later.
% The function |@@_tmpa:nnn| will draw the arrow. It's merely an environment
% |{tikzpicture}|. However, the Tikz instruction in this environment must be
% inserted from |\l_@@_tikz_code_tl| with the markers |#1|, |#2| and |#3|.
-% That's why we create a function |\@@_def_function_tmpa:n| which will create
-% the function |\@@_tmpa:nnn|.
+% That's why we create a function |\@@_def_function_arrow:n| which will create
+% the function |\@@_arrow:nnn|.
% \begin{macrocode}
-\cs_new_protected:Npn \@@_def_function_tmpa:n #1
+\cs_generate_variant:Nn \@@_def_function_arrow:n { o }
+\cs_new_protected:Npn \@@_def_function_arrow:n #1
{
- \cs_set:Npn \@@_tmpa:nnn ##1 ##2 ##3
+ \cs_set:Npn \@@_arrow:nnn ##1 ##2 ##3
{
%<*LaTeX>
\begin{tikzpicture}
@@ -6417,10 +6548,16 @@ version 2005/12/01 or later.
{ \dim_zero:N \l_tmpa_dim }
{ \dim_set:Nn \l_tmpa_dim { \pgf@picmaxx - \pgf@picminx } }
\dim_add:Nn \l_tmpa_dim \l_@@_xoffset_dim
- \prop_gput:cnV
- { g_@@_arrow _ \l_@@_prefix_str _ \int_use:N \l_@@_arrow_int _ prop }
- { width }
- \l_tmpa_dim
+% \end{macrocode}
+% |\l_@@_arrow_int = 0| probably means that we have an arrow in the |code-after|.
+% \begin{macrocode}
+ \int_compare:nNnT \l_@@_arrow_int > 0 % added 2024/10/01
+ {
+ \prop_gput:cnV
+ { g_@@_arrow _ \l_@@_prefix_str _ \int_use:N \l_@@_arrow_int _ prop }
+ { width }
+ \l_tmpa_dim
+ }
% \end{macrocode}
% Now, the actualization of |\g_@@_overlap_x_dim|.
% \begin{macrocode}
@@ -6450,8 +6587,9 @@ version 2005/12/01 or later.
%
% \medskip
% When we draw the arrow (with |\@@_draw_arrow:nnn|), we first create the
-% function |\@@_tmpa:nnn| and, then, we use the function |\@@_tmpa:nnn| :
+% function |\@@_arrow:nnn| and, then, we use the function |\@@_arrow:nnn| :
% \begin{macrocode}
+\cs_generate_variant:Nn \@@_draw_arrow:nnn { n n o }
\cs_new_protected:Npn \@@_draw_arrow:nnn #1 #2 #3
{
% \end{macrocode}
@@ -6467,10 +6605,9 @@ version 2005/12/01 or later.
% \medskip
% Now, the main lines of this function |\@@_draw_arrow:nnn|.
% \begin{macrocode}
- \exp_args:NV \@@_def_function_tmpa:n \l_@@_tikz_code_tl
- \@@_tmpa:nnn { #1 } { #2 } { #3 }
+ \@@_def_function_arrow:o \l_@@_tikz_code_tl
+ \@@_arrow:nnn { #1 } { #2 } { #3 }
}
-\cs_generate_variant:Nn \@@_draw_arrow:nnn { n n o }
% \end{macrocode}
%
% \bigskip
@@ -6479,7 +6616,7 @@ version 2005/12/01 or later.
% \begin{macrocode}
\tl_const:Nn \c_@@_tikz_code_wrap_lines_tl
{
- \pgfset { inner~sep = 0pt}
+ \pgfset { inner~sep = 0pt }
% \end{macrocode}
% First, we draw the arrow without the label.
% \begin{macrocode}
@@ -6494,7 +6631,7 @@ version 2005/12/01 or later.
% Here is the use of |\g_@@_right_x_dim| which has been computed previously with
% the |v|-nodes.
% \begin{macrocode}
- \dim_set:Nn \l_tmpa_dim { \g_@@_right_x_dim - \pgf@x - 0.3333 ex }
+ \dim_set:Nn \l_tmpa_dim { \g_@@_right_x_dim - \pgf@x - 0.33333 em }
% \end{macrocode}
% We retrieve in |\g_tmpa_tl| the current value of the Tikz parameter
% ``|text width|''.\footnote{In fact, it's not the current value of
@@ -6502,7 +6639,7 @@ version 2005/12/01 or later.
% provided by \pkg{witharrows}. These options are given to Tikz in a
% ``|every path|''. That's why we have to retrieve it in a path.}
% \begin{macrocode}
- \path \pgfextra { \tl_gset:Nx \g_tmpa_tl \tikz@text@width } ;
+ \path \pgfextra { \tl_gset:Ne \g_tmpa_tl \tikz@text@width } ;
% \end{macrocode}
% Maybe the current value of the parameter ``|text width|'' is shorter than
% |\l_tmpa_dim|. In this case, we must use ``|text width|'' (we update
@@ -6523,7 +6660,7 @@ version 2005/12/01 or later.
%<*LaTeX>
node [ anchor = west ]
{
- \skip_horizontal:n { 0.3333 ex }
+ \skip_horizontal:n { 0.33333 em }
\begin { minipage } { \l_tmpa_dim }
\tikz@text@action
\pgfkeysgetvalue { / tikz / node~halign~header } \l_tmpa_tl
@@ -6543,7 +6680,7 @@ version 2005/12/01 or later.
%</LaTeX>
%<*plain-TeX>
node [ anchor = west , text~width = \dim_use:N \l_tmpa_dim ]
- { #3 } ;
+ { \skip_horizontal:n { 0.33333 em } #3 } ;
%</plain-TeX>
}
}
@@ -6600,7 +6737,7 @@ version 2005/12/01 or later.
%
%
% The second point ensures the expected output in situations such as in the
-% following example :
+% following example:
%
% \bigskip
% \begin{BVerbatim}[boxwidth=6cm,baseline=c]
@@ -6704,17 +6841,17 @@ version 2005/12/01 or later.
\prop_get:cnN
{ g_@@_arrow _ \l_@@_prefix_str _ ####1 _ prop }
{ status } \l_@@_status_arrow_str
- \bool_if:nT
+ \bool_lazy_any:nF
{
- ! \int_compare_p:n { ##1 = ####1 }
- && \int_compare_p:n { \l_@@_initial_int <= \l_tmpa_tl }
- && \int_compare_p:n { \l_tmpb_tl <= \l_@@_final_int }
+ { \int_compare_p:n { ##1 = ####1 } }
+ { \int_compare_p:nNn \l_@@_initial_int > \l_tmpa_tl }
+ { \int_compare_p:nNn \l_tmpb_tl > \l_@@_final_int }
% \end{macrocode}
% We don't take into account the independent arrows because we have only
% computed the \emph{width} of the arrows and that's why our arrow of type~|o|
% will be positionned only relatively to the current group.
% \begin{macrocode}
- && ! \str_if_eq_p:Vn \l_@@_status_arrow_str { independent }
+ { \str_if_eq_p:on \l_@@_status_arrow_str { independent } }
}
{
% \end{macrocode}
@@ -6782,22 +6919,22 @@ version 2005/12/01 or later.
{
tikz .code:n =
\tikzset { WithArrows / arrow / .append~style = { #1 } } ,
- tikz .value_required:n = true ,
- rr .value_forbidden:n = true ,
- rr .code:n = \@@_fix_pos_option:n 0 ,
- ll .value_forbidden:n = true,
- ll .code:n = \@@_fix_pos_option:n 1 ,
- rl .value_forbidden:n = true ,
- rl .code:n = \@@_fix_pos_option:n 2 ,
- lr .value_forbidden:n = true ,
- lr .code:n = \@@_fix_pos_option:n 3 ,
- v .value_forbidden:n = true ,
- v .code:n = \@@_fix_pos_option:n 4 ,
+ tikz .value_required:n = true ,
+ rr .value_forbidden:n = true ,
+ rr .code:n = \@@_fix_pos_option:n 0 ,
+ ll .value_forbidden:n = true,
+ ll .code:n = \@@_fix_pos_option:n 1 ,
+ rl .value_forbidden:n = true ,
+ rl .code:n = \@@_fix_pos_option:n 2 ,
+ lr .value_forbidden:n = true ,
+ lr .code:n = \@@_fix_pos_option:n 3 ,
+ v .value_forbidden:n = true ,
+ v .code:n = \@@_fix_pos_option:n 4 ,
tikz-code .tl_set:N = \l_@@_tikz_code_tl ,
tikz-code .value_required:n = true ,
- xoffset .dim_set:N = \l_@@_xoffset_dim ,
- xoffset .value_required:n = true ,
- unknown .code:n =
+ xoffset .dim_set:N = \l_@@_xoffset_dim ,
+ xoffset .value_required:n = true ,
+ unknown .code:n =
\@@_sort_seq:N \l_@@_options_Arrow_code_after_seq
\@@_error:n { Unknown~option~Arrow~in~code-after }
}
@@ -6833,7 +6970,7 @@ version 2005/12/01 or later.
\cs_new_protected:Npn \@@_Arrow_code_after_ii [ #1 ] #2 #3 #4 [ #5 ]
%</plain-TeX>
{
- \int_set:Nn \l_@@_pos_arrow_int 1
+ \int_set_eq:NN \l_@@_pos_arrow_int \c_one_int
\str_clear_new:N \l_@@_previous_key_str
\group_begin:
\keys_set:nn { WithArrows / Arrow / code-after }
@@ -6861,10 +6998,10 @@ version 2005/12/01 or later.
% \begin{macrocode}
{
\cs_if_free:cTF { pgf@sh@ns@wa - \l_@@_prefix_str - #2 - l }
- { \@@_error:nx { Wrong~line~in~Arrow } { #2 } }
+ { \@@_error:ne { Wrong~line~in~Arrow } { #2 } }
{
\cs_if_free:cTF { pgf@sh@ns@wa - \l_@@_prefix_str - #3 - l }
- { \@@_error:nx { Wrong~line~in~Arrow } { #3 } }
+ { \@@_error:ne { Wrong~line~in~Arrow } { #3 } }
{
\int_compare:nNnTF \l_@@_pos_arrow_int = 4
{
@@ -6878,9 +7015,9 @@ version 2005/12/01 or later.
{ north }
\dim_set:Nn \l_tmpa_dim
{ \dim_max:nn \l_tmpa_dim \pgf@x }
- \tl_gset:Nx \g_tmpa_tl
+ \tl_gset:Ne \g_tmpa_tl
{ \dim_use:N \l_tmpa_dim , \dim_use:N \l_tmpb_dim }
- \tl_gset:Nx \g_tmpb_tl
+ \tl_gset:Ne \g_tmpb_tl
{ \dim_use:N \l_tmpa_dim , \dim_use:N \pgf@y }
\endpgfpicture
}
@@ -6893,7 +7030,7 @@ version 2005/12/01 or later.
#2 - \bool_if:NTF \l_@@_initial_r_bool r l
}
{ south }
- \tl_gset:Nx \g_tmpa_tl
+ \tl_gset:Ne \g_tmpa_tl
{ \dim_use:N \pgf@x , \dim_use:N \pgf@y }
\pgfpointanchor
{
@@ -6901,7 +7038,7 @@ version 2005/12/01 or later.
#3 - \bool_if:NTF \l_@@_final_r_bool r l
}
{ north }
- \tl_gset:Nx \g_tmpb_tl
+ \tl_gset:Ne \g_tmpb_tl
{ \dim_use:N \pgf@x , \dim_use:N \pgf@y }
\endpgfpicture
}
@@ -6928,12 +7065,12 @@ version 2005/12/01 or later.
% First, we test with a regular expression whether the format of the list of
% lines is correct.
% \begin{macrocode}
- \exp_args:Nnx
+ \exp_args:Nne
\regex_match:nnTF
{ \A \d+ (\,\d+)* ( \, \.\.\. (\,\d+)+ )* \Z }
{ #1 }
{ \@@_MultiArrow_i:nn { #1 } { #2 } }
- { \@@_error:nx { Invalid~specification~for~MultiArrow } { #1 } }
+ { \@@_error:ne { Invalid~specification~for~MultiArrow } { #1 } }
}
% \end{macrocode}
%
@@ -6949,8 +7086,8 @@ version 2005/12/01 or later.
\foreach \x in { #1 }
{
\cs_if_free:cTF { pgf@sh@ns@wa - \l_@@_prefix_str - \x - l }
- { \@@_error:nx { Wrong~line~specification~in~MultiArrow } \x }
- { \clist_gput_right:Nx \g_tmpa_clist \x }
+ { \@@_error:ne { Wrong~line~specification~in~MultiArrow } \x }
+ { \clist_gput_right:Ne \g_tmpa_clist \x }
}
% \end{macrocode}
% We sort the list |\g_tmpa_clist| because we want to extract the minimum and
@@ -6961,7 +7098,7 @@ version 2005/12/01 or later.
{
\clist_sort:Nn \g_tmpa_clist
{
- \int_compare:nTF { ##1 > ##2 }
+ \int_compare:nNnTF { ##1 } > { ##2 }
\sort_return_swapped:
\sort_return_same:
}
@@ -6985,7 +7122,7 @@ version 2005/12/01 or later.
% the last teeth of the rak can't be drawn the same way as the others (think,
% for example, to the case of the option ``|rounded corners|'' is used).
% \begin{macrocode}
- \exp_args:NV \@@_MultiArrow_i:n \g_tmpa_clist
+ \exp_args:No \@@_MultiArrow_i:n \g_tmpa_clist
% \end{macrocode}
%
% Now, we draw the rest of the structure.
@@ -7007,7 +7144,7 @@ version 2005/12/01 or later.
-- ([xshift = \l_@@_xoffset_dim]\l_tmpb_tl-r.south) ;
\pgfpointanchor { wa - \l_@@_prefix_str - @@_label } { west }
\dim_set:Nn \l_tmpa_dim { 20 cm }
- \path \pgfextra { \tl_gset:Nx \g_tmpa_tl \tikz@text@width } ;
+ \path \pgfextra { \tl_gset:Ne \g_tmpa_tl \tikz@text@width } ;
\tl_if_empty:NF \g_tmpa_tl { \dim_set:Nn \l_tmpa_dim \g_tmpa_tl }
\bool_lazy_and:nnT \l_@@_wrap_lines_bool \l_@@_in_DispWithArrows_bool
{
@@ -7517,8 +7654,8 @@ version 2005/12/01 or later.
Normally,~we~can't~use~the~command~\token_to_str:N\label\
twice~in~a~line~of~the~environment~\{\l_@@_type_env_str\}. \\
However,~you~can~go~on.~
- \IfPackageLoadedTF { showlabels }
- { However,~only~the~last~label~will~be~shown~by~showlabels.~ } { }
+ \IfPackageLoadedT { showlabels }
+ { However,~only~the~last~label~will~be~shown~by~showlabels.~ }
If~you~don't~want~to~see~this~message~again,~you~can~use~the~option~
'allow-multiple-labels'~at~the~global~or~environment~level.
}
@@ -7622,32 +7759,18 @@ version 2005/12/01 or later.
\keyval_parse:NNn \@@_valid_key:n \@@_valid_key:nn { #2 }
\seq_if_empty:NTF \l_tmpa_seq
{
- \seq_put_right:Nx \l_@@_options_WithArrows_seq
+ \seq_put_right:Ne \l_@@_options_WithArrows_seq
{ \tl_to_str:n { #1 } }
- \seq_put_right:Nx \l_@@_options_DispWithArrows_seq
+ \seq_put_right:Ne \l_@@_options_DispWithArrows_seq
{ \tl_to_str:n { #1 } }
- \seq_put_right:Nx \l_@@_options_WithArrowsOptions_seq
+ \seq_put_right:Ne \l_@@_options_WithArrowsOptions_seq
{ \tl_to_str:N { #1 } }
-% \end{macrocode}
-% When we will consider that |\keys_precompile:nnN| (introduced in LaTeX on
-% 2022-03-09) is widely available, we will delete that test and keep only the
-% first version.
-% \begin{macrocode}
- \cs_if_exist:NTF \keys_precompile:nnN
- {
- \keys_precompile:nnN
- { WithArrows / WithArrowsOptions }
- { #2 }
- \l_tmpa_tl
- \@@_key_define:nV { #1 } \l_tmpa_tl
- }
- {
- \keys_define:nn { WithArrows / Global }
- {
- #1 .code:n =
- { \keys_set:nn { WithArrows / WithArrowsOptions } { #2 } }
- }
- }
+ \keys_precompile:nnc
+ { WithArrows / WithArrowsOptions }
+ { #2 }
+ { @@ _ style _ #1 _ tl }
+ \keys_define:nn { WithArrows / Global }
+ { #1 .code:n = \use:c { @@ _ style _ #1 _ tl } }
}
{ \@@_error:nn { Impossible~style } { #1 } }
}
@@ -7678,15 +7801,9 @@ version 2005/12/01 or later.
% \end{macrocode}
%
% \begin{macrocode}
-\cs_new_protected:Npn \@@_key_define:nn #1 #2
- { \keys_define:nn { WithArrows / Global } { #1 .code:n = #2 } }
-\cs_generate_variant:Nn \@@_key_define:nn { n V }
-% \end{macrocode}
-%
-% \begin{macrocode}
\@@_msg_new:nn { Key~already~defined }
{
- Key~already~define.\\
+ Key~already~defined.\\
The~key~'#1'~is~already~defined. \\
If~you~go~on,~your~instruction~\token_to_str:N\WithArrowsNewStyle\
will~be~ignored.
@@ -7766,7 +7883,7 @@ version 2005/12/01 or later.
{
\dim_set:Nn \l_tmpa_dim { \x2 - \x1 }
\begin { varwidth } \l_tmpa_dim
-% \end{macrocode}a
+% \end{macrocode}
% |\narrowragged| is a command of the package \pkg{varwidth}.
% \begin{macrocode}
\narrowragged
@@ -7991,9 +8108,9 @@ version 2005/12/01 or later.
\str_if_empty:NT \l_@@_previous_key_str
{
\str_set:Nn \l_@@_previous_key_str { up }
- \cs_if_exist:cTF { tikz@library@calc@loaded }
+ \cs_if_exist:NTF \tikz@library@calc@loaded
{
- \keys_set:nV { WithArrows / up-and-down } \l_keys_value_tl
+ \keys_set:no { WithArrows / up-and-down } \l_keys_value_tl
\int_set:Nn \l_@@_pos_arrow_int 1
% \end{macrocode}
% We have to set |\l_@@_wrap_lines_bool| to |false| because, otherwise, if the
@@ -8012,9 +8129,9 @@ version 2005/12/01 or later.
\str_if_empty:NT \l_@@_previous_key_str
{
\str_set:Nn \l_@@_previous_key_str { down }
- \cs_if_exist:cTF { tikz@library@calc@loaded }
+ \cs_if_exist:NTF \tikz@library@calc@loaded
{
- \keys_set:nV { WithArrows / up-and-down } \l_keys_value_tl
+ \keys_set:no { WithArrows / up-and-down } \l_keys_value_tl
\int_set:Nn \l_@@_pos_arrow_int 1
\bool_set_false:N \l_@@_wrap_lines_bool
\tl_set_eq:NN \l_@@_tikz_code_tl \c_@@_tikz_code_down_tl
@@ -8052,6 +8169,9 @@ version 2005/12/01 or later.
%
% \section{History}
%
+% \subsection*{Changes between 2.8 and 2.9}
+%
+% Argument |<...>| for the command |\Arrow| in the class Beamer.
%
% \subsection*{Changes between 2.7 and 2.8}
%
diff --git a/macros/generic/witharrows/witharrows.ins b/macros/generic/witharrows/witharrows.ins
index 5a65f4914c..6041cfd75b 100644
--- a/macros/generic/witharrows/witharrows.ins
+++ b/macros/generic/witharrows/witharrows.ins
@@ -1,5 +1,5 @@
%%
-%% Copyright (C) 2017-2023 by F. Pantigny
+%% Copyright (C) 2017-2024 by F. Pantigny
%%
%%
%% This file may be distributed and/or modified under the
@@ -17,7 +17,7 @@
\usedir{tex/latex/witharrows}
\preamble
-Copyright (C) 2017-2023 by F. Pantigny
+Copyright (C) 2017-2024 by F. Pantigny
This file may be distributed and/or modified under the
conditions of the LaTeX Project Public License, either
diff --git a/macros/generic/witharrows/witharrows.pdf b/macros/generic/witharrows/witharrows.pdf
index 2b4b9dd2e8..1d4cb54b56 100644
--- a/macros/generic/witharrows/witharrows.pdf
+++ b/macros/generic/witharrows/witharrows.pdf
Binary files differ