diff --git a/.github/workflows/pandoc.yaml b/.github/workflows/pandoc.yaml
new file mode 100644
index 000000000000..4a52c010327b
--- /dev/null
+++ b/.github/workflows/pandoc.yaml
@@ -0,0 +1,50 @@
+name: Pandoc
+
+on:
+  push:
+    branches: [scala3-pandoc]
+
+jobs:
+  printenv:
+    runs-on: ubuntu-latest
+
+    steps:
+      - name: Print Ubuntu environment
+        run: |
+          env | grep GIT
+          env | grep HOME
+          docker version --format '{{.Server.Version}}'
+          #docker run pandoc/latex:latest --version | grep ^pandoc
+
+  build:
+    needs: printenv
+    runs-on: ubuntu-latest
+    container:
+      image: pandoc/latex:latest
+    #if: "(    github.event_name == 'pull_request'
+    #       && !contains(github.event.pull_request.body, '[skip ci]')
+    #       && !contains(github.event.pull_request.body, '[skip docs]')
+    #     )
+    #     || contains(github.event.ref, 'pandoc')
+    #     || contains(github.event.ref, 'master')"
+
+    steps:
+      - name: Git Checkout
+        uses: actions/checkout@v2
+
+      - name: Print Pandoc environment
+        run: |
+          #env | grep TEX
+          pandoc --version | grep ^pandoc
+
+      - name: Install additional TeX fonts
+        run: |
+          find . -name install-tex-fonts
+          chmod u+x ./pandoc/extras/install-tex-fonts
+          DEBUG=1 & ./pandoc/extras/install-tex-fonts
+
+      - name: Generate PDF reference documentation
+        run: |
+          find . -name md2pdf
+          chmod u+x ./pandoc/md2pdf
+          DEBUG=1 & ./pandoc/md2pdf reference
diff --git a/community-build/community-projects/cask b/community-build/community-projects/cask
index d9e3ec387ade..da12e13da23c 160000
--- a/community-build/community-projects/cask
+++ b/community-build/community-projects/cask
@@ -1 +1 @@
-Subproject commit d9e3ec387ade7f462fe696d25c647e3192daf566
+Subproject commit da12e13da23c184196a5c253628cd91673e4ac84
diff --git a/community-build/community-projects/intent b/community-build/community-projects/intent
index b1a62511741d..38c7314fb764 160000
--- a/community-build/community-projects/intent
+++ b/community-build/community-projects/intent
@@ -1 +1 @@
-Subproject commit b1a62511741d84cc84fdf14c051804fe81629cdb
+Subproject commit 38c7314fb7643bc1786e4358b83a815194071d48
diff --git a/community-build/community-projects/onnx-scala b/community-build/community-projects/onnx-scala
index ff0c47297fd2..64cb918ea298 160000
--- a/community-build/community-projects/onnx-scala
+++ b/community-build/community-projects/onnx-scala
@@ -1 +1 @@
-Subproject commit ff0c47297fd2885f8b56def3ea4fd22efdfe1e8b
+Subproject commit 64cb918ea298ba2a9410d99d4dd565cdeed79b3e
diff --git a/community-build/community-projects/scala-stm b/community-build/community-projects/scala-stm
index 96ef6e56af08..7011331d3684 160000
--- a/community-build/community-projects/scala-stm
+++ b/community-build/community-projects/scala-stm
@@ -1 +1 @@
-Subproject commit 96ef6e56af08d0ec600ec80ebec68d227a8c048c
+Subproject commit 7011331d36848faf9af407e3e85ab75076dfdefa
diff --git a/community-build/community-projects/scalap b/community-build/community-projects/scalap
index 6dc9e16358a0..08e4a6172dfe 160000
--- a/community-build/community-projects/scalap
+++ b/community-build/community-projects/scalap
@@ -1 +1 @@
-Subproject commit 6dc9e16358a07150ca0e89df6ed38e79854a411c
+Subproject commit 08e4a6172dfef0425abe0dac6808127ba58ce909
diff --git a/community-build/community-projects/scas b/community-build/community-projects/scas
index 650b72f7baeb..91b1de233de7 160000
--- a/community-build/community-projects/scas
+++ b/community-build/community-projects/scas
@@ -1 +1 @@
-Subproject commit 650b72f7baeb4443f16fe4e923901837f5d9ad98
+Subproject commit 91b1de233de7128e57aca1303e099b1a5499807f
diff --git a/community-build/community-projects/scodec b/community-build/community-projects/scodec
index 84db5f776573..8d7f83ae76e3 160000
--- a/community-build/community-projects/scodec
+++ b/community-build/community-projects/scodec
@@ -1 +1 @@
-Subproject commit 84db5f7765738024aebd8df2bf53151cc6d4d793
+Subproject commit 8d7f83ae76e3278245631126d808c9c02e57ae23
diff --git a/community-build/community-projects/shapeless b/community-build/community-projects/shapeless
index 94c1d4413373..273524d806fc 160000
--- a/community-build/community-projects/shapeless
+++ b/community-build/community-projects/shapeless
@@ -1 +1 @@
-Subproject commit 94c1d44133739c7c57b64228caccc4fc938c2862
+Subproject commit 273524d806fc38a4fdfff27550c3fb3720716754
diff --git a/community-build/community-projects/stdLib213 b/community-build/community-projects/stdLib213
index 891f92f01cfb..21cb41941e39 160000
--- a/community-build/community-projects/stdLib213
+++ b/community-build/community-projects/stdLib213
@@ -1 +1 @@
-Subproject commit 891f92f01cfbc900a1a1efada73530246babd075
+Subproject commit 21cb41941e399b0b06c4ea80abbc6e2084f2e415
diff --git a/community-build/community-projects/utest b/community-build/community-projects/utest
index b5a04a2f3e35..d31c98761a20 160000
--- a/community-build/community-projects/utest
+++ b/community-build/community-projects/utest
@@ -1 +1 @@
-Subproject commit b5a04a2f3e35ae340e0821d604dafe9cb10a7fc7
+Subproject commit d31c98761a204c91f0e06a4eaa8a45aa038d14b8
diff --git a/pandoc/.dockerignore b/pandoc/.dockerignore
new file mode 100644
index 000000000000..6ab5a428a959
--- /dev/null
+++ b/pandoc/.dockerignore
@@ -0,0 +1,4 @@
+docs/
+extras/
+*.bat
+README.md
diff --git a/pandoc/.gitignore b/pandoc/.gitignore
new file mode 100644
index 000000000000..3fec32c84275
--- /dev/null
+++ b/pandoc/.gitignore
@@ -0,0 +1 @@
+tmp/
diff --git a/pandoc/Dockerfile b/pandoc/Dockerfile
new file mode 100644
index 000000000000..677bb7d2c7fd
--- /dev/null
+++ b/pandoc/Dockerfile
@@ -0,0 +1,35 @@
+## Created by mics (https://github.com/michelou/) on December 2020.
+
+FROM pandoc/ubuntu-latex:2.11.4
+
+LABEL md2pdf.author="Stéphane Micheloud <stephane.micheloud@gmail.com>"
+LABEL md2pdf.description="Create PDF file for Scala 3 documentation"
+LABEL md2pdf.version=1.0
+
+WORKDIR /dotty
+COPY ./tmp/docs ./docs/docs
+
+WORKDIR pandoc
+COPY ./data ./data
+COPY ./md2pdf .
+
+ENV TEXLIVE_HOME=/opt/texlive/texdir
+
+## See https://github.com/openjournals/whedon/blob/master/paperdraft.Dockerfile
+RUN tlmgr update --self
+
+## Install additional LaTeX packages
+## Already present: fancyvrb, fontspec, l3backend, l3kernel, l3packages, pgf, unicode-math, xcolor.
+RUN tlmgr install \
+ dejavu \
+ environ \
+ gnu-freefont \
+ selnolig \
+ tcolorbox \
+ trimspaces
+
+RUN echo "#!/bin/bash \n ./md2pdf \n ls /dotty/out/pandoc/" > ./entrypoint.sh
+RUN chmod +x ./entrypoint.sh
+
+ENTRYPOINT [ "./entrypoint.sh" ]
+CMD [ "reference" ]
diff --git a/pandoc/README.md b/pandoc/README.md
new file mode 100644
index 000000000000..bc7c0cc575de
--- /dev/null
+++ b/pandoc/README.md
@@ -0,0 +1,90 @@
+# <span id="top">Creating PDF files for the Scala 3 documentation</span>
+<!-- created by mics (https://github.com/michelou/) on December 2020 -->
+
+This project is located at the root of the [`lampepfl/dotty`][github_dotty] repository, at the same level as the [`Scaladoc`][github_scala3doc] project.
+
+We aim to generate a *single* PDF file from a collection of [Markdown] documents, for instance for the [*Scala 3 reference*][scala3_reference] documentation.
+
+Our solution is built on [Pandoc]; it gets its inputs from two directories and generates a PDF file into the output directory:
+
+<table style="margin-top:-10px; max-width:650px;">
+<tr>
+<td><b>Input directories</b></td>
+<td><code>docs/docs/&lt;project&gt;/</code><br/><code>pandoc/data/</code></td>
+<td><code>*.md</code> files<br/><a href="https://pandoc.org/">Pandoc</a> data files</td>
+</tr>
+<tr>
+<td><b>Output directory</b></td>
+<td><code>out/pandoc/</code></td>
+<td><code>scala3_<i>&lt;project&gt;</i>.pdf</code><sup>(*)</sup></td>
+</tr>
+</table>
+
+<span style="margin-left:10px;font-size:90%;"><sup>(*)</sup> *`<project>`* is one of [`contributing`](https://github.com/lampepfl/dotty/tree/master/docs/docs/contributing), [`internals`](https://github.com/lampepfl/dotty/tree/master/docs/docs/internals), [`reference`](https://github.com/lampepfl/dotty/tree/master/docs/docs/reference) or [`usage`](https://github.com/lampepfl/dotty/tree/master/docs/docs/usage).</span>
+
+The generated PDF file is more elaborated than its sibling HTML version; unlike the online [*Scala 3 reference*][scala3_reference] documentation available on the [Scala 3 documentation](https://docs.scala-lang.org/scala3/) webpage, the `scala3_reference.pdf` document :
+- starts with a *title page* directly followed by a *table of contents* and ends with an *appendix*.
+- gathers all the "*More details*" sections in the appendix.
+
+> See document [`PROJECT.md`](docs/PROJECT.md) for further information, e.g. project organisation.
+
+## <span id="dependencies">Project dependencies</span>
+
+This project depends on the following software :
+
+- [Pandoc 2](https://github.com/jgm/pandoc/releases) <sup id="anchor_01">[1](#footnote_01)</sup> *([release notes](https://pandoc.org/releases.html))*
+- [TeX Live 2021](https://tug.org/texlive/) <sup id="anchor_02">[2](#footnote_02)</sup> *([release notes](http://www.tug.org/texlive/doc/texlive-en/texlive-en.html#x1-880009.2))*
+
+> See documents [`PANDOC.md`](docs/PANDOC.md) and [`TEXLIVE.md`](docs/TEXLIVE.md) for product specific information, e.g. software installation.
+
+One may also install the following software:
+
+- [Docker Desktop 3](https://docs.docker.com/get-docker/) <sup id="anchor_03">[3](#footnote_03)</sup> *([release notes](https://docs.docker.com/release-notes/))*
+
+> See document [`DOCKER.md`](docs/DOCKER.md) for further information, e.g. `Dockerfile` usage.
+
+## <span id="commands">Build commands</span>
+
+We provide two commands for MacOS/Ubuntu as well as their equivalents for MS Windows :
+- for *interactive users* :<br/>[`build {<option>|<subcommand>}`](./build) (resp. [`build.bat`](./build.bat) on MS Windows)<br/><span style="font-size:80%;">(option `-help` displays the available options/subcommands).</span>
+- for *automated tasks* (primarily, but not exclusively) :<br/>[`md2pdf [<project>]`](./md2pdf) (resp. [`md2pdf.bat`](./md2pdf.bat) on MS Windows)<br/><span style="font-size:80%;">(default value for `<project>` : `reference`).</span>
+
+We also provide support for cloud development/deployment :
+
+- with *Docker*<br/><a href="./Dockerfile"><code>Dockerfile</code></a>, a text document to create a Docker image featuring <a href="https://tug.org/texlive/">TeX Live</a>, <a href="https://pandoc.org/">Pandoc</a> and <a href="./md2pdf"><code>md2pdf</code></a>.
+- with *GitHub Actions* <b style="color:red;">WIP</b> :<br/><a href="../.github/workflows/pandoc.yaml"><code>pandoc.yaml</code></a>, a workflow file to run CI jobs with <a href="https://docs.github.com/en/actions">GitHub Actions</a>.
+
+> See document [`EXAMPLES.md`](docs/EXAMPLES.md) for usage examples in different environments.
+
+## <span id="footnotes">Footnotes</span>
+
+<span id="footnote_01">[1]</span> ***Pandoc software*** [↩](#anchor_01)
+
+<dl><dd>
+<a href="https://pandoc.org/">Pandoc</a> is both a library and a command line tool for converting files from one markup format into another. Through the command line option <a href="https://pandoc.org/MANUAL.html#option--pdf-engine"><code>--pdf-engine=&lt;path&gt;</code></a> Pandoc supports many PDF engines, among others <a href="https://linux.die.net/man/1/pdflatex"><code>pdflatex</code></a>, <a href="http://www.luatex.org/"><code>lualatex</code></a> and <code>xelatex</code>.
+</dd></dl>
+
+<span id="footnote_02">[2]</span> ***MiKTeX software*** [↩](#anchor_02)
+
+<dl><dd>
+As an alternative to <a href="https://tug.org/texlive/">TeX Live 2020</a> one may also use the <a href="https://miktex.org/">MiKTeX</a> distribution <i>(<a href="https://miktex.org/announcement/miktex-20-12">release notes</a>)</i> which we have tested on both MS Windows 10 and <a href="https://www.msys2.org/">MSYS2</a>.
+</dd></dl>
+
+<span id="footnote_03">[3]</span> ***Docker software*** [↩](#anchor_03)
+
+<dl><dd>
+We run <a href="https://docs.docker.com/docker-for-windows/install/">Docker Desktop for Windows</a> on our development machine.<br/>
+Note that WSL 2 is required to interact with Docker on Windows from <a href="https://ubuntu.com/wsl">Ubuntu for WSL</a> (see documentation <a href="https://docs.docker.com/docker-for-windows/wsl/">Docker Desktop WSL 2 backend</a>).
+</dd></dl>
+
+***
+
+*[mics](https://github.com/michelou/)/January 2022* [**&#9650;**](#top "Back to top")
+<span id="bottom">&nbsp;</span>
+
+[github_dotty]: https://github.com/lampepfl/dotty/#dotty
+[github_scala3doc]: https://github.com/lampepfl/dotty/tree/master/scala3doc#scala3doc
+[markdown]: https://commonmark.org/
+[pandoc]: https://pandoc.org/ "A universal document converter"
+[scala3_reference]: https://dotty.epfl.ch/docs/reference/overview.html
+[tex_live]: https://tug.org/texlive/
diff --git a/pandoc/build b/pandoc/build
new file mode 100644
index 000000000000..47a2a064e302
--- /dev/null
+++ b/pandoc/build
@@ -0,0 +1,183 @@
+#!/usr/bin/env bash
+
+## Created by mics (https://github.com/michelou/) on December 2020.
+
+##############################################################################
+## Subroutines
+
+getHome() {
+    local source="${BASH_SOURCE[0]}"
+    while [ -h "$source" ] ; do
+        local linked="$(readlink "$source")"
+        local dir="$( cd -P $(dirname "$source") && cd -P $(dirname "$linked") && pwd )"
+        source="$dir/$(basename "$linked")"
+    done
+    ( cd -P "$(dirname "$source")" && pwd )
+}
+
+getOS() {
+    local os
+    case "$(uname -s)" in
+        Linux*)  os=Linux;;
+        Darwin*) os=Mac;;
+        CYGWIN*) os=Win;; # os=Cygwin;;
+        MINGW*)  os=Win;; # os=MinGw;;
+        *)       os=Unknown
+    esac
+    echo $os
+}
+
+# use variables EXITCODE, TIMER_START
+cleanup() {
+    [[ $1 =~ ^[0-1]$ ]] && EXITCODE=$1
+
+    if $TIMER; then
+        local timer_end=$(date +'%s')
+        local duration=$((timer_end - TIMER_START))
+        echo "Total elapsed time: $(date -d @$duration +'%H:%M:%S')" 1>&2
+    fi
+    debug "EXITCODE=$EXITCODE"
+    exit $EXITCODE
+}
+
+verbose() {
+    $VERBOSE && echo "$1" 1>&2
+}
+
+debug() {
+    local debug_label="[DEBUG]"
+    $DEBUG && echo "$debug_label $1" 1>&2
+}
+
+error() {
+    local error_label="Error:"
+    echo "$error_label $1" 1>&2
+}
+
+args() {
+    PROJECT_NAME=$PROJECT_NAME_DEFAULT
+
+    [[ $# -eq 0 ]] && HELP=true && return 1
+
+    for arg in "$@"; do
+        case "$arg" in
+        ## options
+        -debug)     DEBUG=true ;;
+        -help)      HELP=true ;;
+        -project:*) PROJECT_NAME="$(project_name ${arg:9})" ;;
+        -timer)     TIMER=true ;;
+        -verbose)   VERBOSE=true ;;
+        -*)
+            error "Unknown option $arg"
+            EXITCODE=1 && return 0
+            ;;
+        ## subcommands
+        clean)      CLEAN=true ;;
+        compile)    COMPILE=true ;;
+        help)       HELP=true ;;
+        *)
+           error "Error: Unknown subcommand $arg"
+           EXITCODE=1 && return 0
+           ;;
+        esac
+    done
+    $CLEAN || $COMPILE || $HELP || HELP=true
+    debug "Options    : DEBUG=$DEBUG TIMER=$TIMER VERBOSE=$VERBOSE"
+    debug "Subcommands: CLEAN=$CLEAN COMPILE=$COMPILE HELP=$HELP"
+    debug "Variables  : PANDOC_HOME=$PANDOC_HOME"
+    debug "Variables  : TEXLIVE_HOME=$TEXLIVE_HOME"
+    debug "Variables  : PROJECT_NAME=$PROJECT_NAME"
+    # See http://www.cyberciti.biz/faq/linux-unix-formatting-dates-for-display/
+    $TIMER && TIMER_START=$(date +"%s")
+}
+
+help() {
+    cat << EOS
+Usage: $BASENAME { <option> | <subcommand> }
+
+  Options:
+    -debug           show commands executed by this script
+    -help            display this help message
+    -project:<name>  project name (default: $PROJECT_NAME_DEFAULT)
+    -timer           display total elapsed time
+    -verbose         display progress messages
+
+  Subcommands:
+    clean            delete generated files
+    help             display this help message
+    compile          compile source files
+EOS
+}
+
+project_name() {
+    local name=""
+    case "$1" in
+    internals) name="internals" ;;
+    reference) name="reference" ;;
+    usage)     name="usage" ;;
+    *)         error "Invalid project name $1"
+    esac
+    $name
+}
+
+clean() {
+    if [ -d "$TARGET_DIR" ]; then
+        debug "rm -rf $TARGET_DIR"
+        verbose "Delete directory $TARGET_DIR"
+        rm -rf "$TARGET_DIR"
+        [[ $? -eq 0 ]] || ( EXITCODE=1 & return 0 )
+    fi
+}
+
+compile() {
+    [ -d "$TARGET_DIR" ] || mkdir -p "$TARGET_DIR"
+
+    debug "$MD2PDF_CMD $PROJECT_NAME"
+    verbose "$MD2PDF_CMD $PROJECT_NAME"
+    $MD2PDF_CMD $PROJECT_NAME
+    [[ $? -eq 0 ]] || ( EXITCODE=1 & return 0 )
+}
+
+##############################################################################
+## Environment setup
+
+BASENAME=$(basename "${BASH_SOURCE[0]}")
+
+EXITCODE=0
+
+PROG_HOME="$(getHome)"
+
+OS="$(getOS)"
+[ $OS == "Unknown" ] && error "Unsupported OS"
+[ $OS == "Win" ] && EXT=".exe" || EXT=""
+
+MD2PDF_CMD=$PROG_HOME/md2pdf
+[ -x "$MD2PDF_CMD" ] || error "md2pdf script not found"
+
+PROJECT_NAME_DEFAULT=reference
+
+CLEAN=false
+COMPILE=false
+DEBUG=false
+HELP=false
+TIMER=false
+VERBOSE=false
+
+TARGET_DIR=$(dirname "$PROG_HOME")/out/pandoc
+
+args "$@"
+[[ $EXITCODE -eq 0 ]] || cleanup 1
+
+##############################################################################
+## Main
+
+$HELP && help && cleanup
+
+if $CLEAN; then
+    clean || cleanup 1
+fi
+if $COMPILE; then
+    compile || cleanup 1
+fi
+
+cleanup
diff --git a/pandoc/build.bat b/pandoc/build.bat
new file mode 100644
index 000000000000..f15a491fe555
--- /dev/null
+++ b/pandoc/build.bat
@@ -0,0 +1,331 @@
+@rem ## Created by mics (https://github.com/michelou/) on December 2020.
+
+@echo off
+setlocal enabledelayedexpansion
+
+set _DEBUG=0
+
+@rem #########################################################################
+@rem ## Environment setup
+
+set _EXITCODE=0
+
+call :env
+if not %_EXITCODE%==0 goto end
+
+call :args %*
+if not %_EXITCODE%==0 goto end
+
+@rem #########################################################################
+@rem ## Main
+
+if %_HELP%==1 (
+    call :help
+    exit /b !_EXITCODE!
+)
+if %_CLEAN%==1 (
+    call :clean
+    if not !_EXITCODE!==0 goto end
+)
+if %_COMPILE%==1 (
+    call :compile
+    if not !_EXITCODE!==0 goto end
+)
+if %_RUN%==1 (
+    call :run
+    if not !_EXITCODE!==0 goto end
+)
+goto end
+
+@rem #########################################################################
+@rem ## Subroutines
+
+@rem output parameters: _DEBUG_LABEL, _ERROR_LABEL, _WARNING_LABEL
+@rem                    _SOURCE_DIR, _TARGET_DIR, _PANDOC_CMD
+:env
+set _TIMER=0
+set _BASENAME=%~n0
+set "_ROOT_DIR=%~dp0"
+
+call :env_colors
+set _DEBUG_LABEL=%_NORMAL_BG_CYAN%[%_BASENAME%]%_RESET%
+set _ERROR_LABEL=%_STRONG_FG_RED%Error%_RESET%:
+set _WARNING_LABEL=%_STRONG_FG_YELLOW%Warning%_RESET%:
+
+set "_DATA_DIR=%_ROOT_DIR%data"
+set "_IMAGES_DIR=%_DATA_DIR%\images"
+set "_TEMPLATES_DIR=%_DATA_DIR%\templates"
+for %%f in ("%~dp0\.") do set "_TARGET_DIR=%%~dpfout\pandoc"
+goto :eof
+
+:env_colors
+@rem ANSI colors in standard Windows 10 shell
+@rem see https://gist.github.com/mlocati/#file-win10colors-cmd
+set _RESET=
+set _BOLD=
+set _UNDERSCORE=
+set _INVERSE=
+
+@rem normal foreground colors
+set _NORMAL_FG_BLACK=
+set _NORMAL_FG_RED=
+set _NORMAL_FG_GREEN=
+set _NORMAL_FG_YELLOW=
+set _NORMAL_FG_BLUE=
+set _NORMAL_FG_MAGENTA=
+set _NORMAL_FG_CYAN=
+set _NORMAL_FG_WHITE=
+
+@rem normal background colors
+set _NORMAL_BG_BLACK=
+set _NORMAL_BG_RED=
+set _NORMAL_BG_GREEN=
+set _NORMAL_BG_YELLOW=
+set _NORMAL_BG_BLUE=
+set _NORMAL_BG_MAGENTA=
+set _NORMAL_BG_CYAN=
+set _NORMAL_BG_WHITE=
+
+@rem strong foreground colors
+set _STRONG_FG_BLACK=
+set _STRONG_FG_RED=
+set _STRONG_FG_GREEN=
+set _STRONG_FG_YELLOW=
+set _STRONG_FG_BLUE=
+set _STRONG_FG_MAGENTA=
+set _STRONG_FG_CYAN=
+set _STRONG_FG_WHITE=
+
+@rem strong background colors
+set _STRONG_BG_BLACK=
+set _STRONG_BG_RED=
+set _STRONG_BG_GREEN=
+set _STRONG_BG_YELLOW=
+set _STRONG_BG_BLUE=
+goto :eof
+
+@rem input parameter: %*
+:args
+set _CLEAN=0
+set _COMPILE=0
+set _HELP=0
+set _PROJECT_NAME=reference
+set _RUN=0
+set _TIMER=0
+set _VERBOSE=0
+set __N=0
+:args_loop
+set "__ARG=%~1"
+if not defined __ARG (
+    if !__N!==0 set _HELP=1
+    goto args_done
+)
+if "%__ARG:~0,1%"=="-" (
+    @rem option
+    if "%__ARG%"=="-debug" ( set _DEBUG=1
+    ) else if "%__ARG:~0,9%"=="-project:" (
+        call :set_project "!__ARG:~9!"
+        if not !_EXITCODE!== 0 goto args_done
+    ) else if "%__ARG%"=="-timer" ( set _TIMER=1
+    ) else if "%__ARG%"=="-verbose" ( set _VERBOSE=1
+    ) else (
+        echo %_ERROR_LABEL% Unknown option %__ARG% 1>&2
+        set _EXITCODE=1
+        goto args_done
+    )
+) else (
+    @rem subcommand
+    if "%__ARG%"=="clean" ( set _CLEAN=1
+    ) else if "%__ARG%"=="compile" ( set _COMPILE=1
+    ) else if "%__ARG%"=="help" ( set _HELP=1
+    ) else if "%__ARG%"=="run" ( set _COMPILE=1& set _RUN=1
+    ) else if "%__ARG%"=="view" ( set _COMPILE=1& set _RUN=1
+    ) else (
+        echo %_ERROR_LABEL% Unknown subcommand %__ARG% 1>&2
+        set _EXITCODE=1
+        goto args_done
+    )
+    set /a __N+=1
+)
+shift
+goto args_loop
+:args_done
+set "_OUTPUT_FILE=%_TARGET_DIR%\scala3_%_PROJECT_NAME%.pdf"
+
+if %_DEBUG%==1 (
+    echo %_DEBUG_LABEL% Options    : _TIMER=%_TIMER% _VERBOSE=%_VERBOSE% 1>&2
+    echo %_DEBUG_LABEL% Subcommands: _CLEAN=%_CLEAN% _COMPILE=%_COMPILE% _RUN=%_RUN% 1>&2
+    echo %_DEBUG_LABEL% Variables  : PANDOC_HOME="%PANDOC_HOME%" 1>&2
+    echo %_DEBUG_LABEL% Variables  : TEXLIVE_HOME="%TEXLIVE_HOME%" 1>&2
+    echo %_DEBUG_LABEL% Variables  : _PROJECT_NAME=%_PROJECT_NAME% 1>&2
+)
+if %_TIMER%==1 for /f "delims=" %%i in ('powershell -c "(Get-Date)"') do set _TIMER_START=%%i
+goto :eof
+
+:help
+if %_VERBOSE%==1 (
+    set __BEG_P=%_STRONG_FG_CYAN%
+    set __BEG_O=%_STRONG_FG_GREEN%
+    set __BEG_N=%_NORMAL_FG_YELLOW%
+    set __END=%_RESET%
+) else (
+    set __BEG_P=
+    set __BEG_O=
+    set __BEG_N=
+    set __END=
+)
+echo Usage: %__BEG_O%%_BASENAME% { ^<option^> ^| ^<subcommand^> }%__END%
+echo.
+echo   %__BEG_P%Options:%__END%
+echo     %__BEG_O%-debug%__END%           show commands executed by this script
+echo     %__BEG_O%-help%__END%            display this help message
+echo     %__BEG_O%-project:^<name^>%__END%  project name ^(default: %__BEG_O%reference%__END%^)
+echo     %__BEG_O%-verbose%__END%         display progress messages
+echo.
+echo   %__BEG_P%Subcommands:%__END%
+echo     %__BEG_O%clean%__END%            delete generated files
+echo     %__BEG_O%compile%__END%          compile source files
+echo     %__BEG_O%run%__END%              open generated PDF file in default application
+echo     %__BEG_O%view%__END%             alias for %__BEG_O%run%__END%
+goto :eof
+
+@rem output parameter: _PROJECT_NAME
+:set_project
+set __ARG=%~1
+
+if "%__ARG%"=="internals" ( set _PROJECT_NAME=internals
+) else if "%__ARG%"=="reference" ( set _PROJECT_NAME=reference
+) else if "%__ARG%"=="usage" ( set _PROJECT_NAME=usage
+) else (
+    echo %_ERROR_LABEL% Invalid project name ^(%__ARG%^) 1>&2
+    set _EXITCODE=1
+    goto :eof
+)
+goto :eof
+
+:clean
+call :rmdir "%_TARGET_DIR%"
+goto :eof
+
+@rem input parameter(s): %1=directory path
+:rmdir
+set __DIR=%~1
+if not exist "%__DIR%\" goto :eof
+if %_DEBUG%==1 ( echo %_DEBUG_LABEL% rmdir /s /q "%__DIR%" 1>&2
+) else if %_VERBOSE%==1 ( echo Delete directory "!__DIR:%_ROOT_DIR%=!" 1>&2
+)
+rmdir /s /q "%__DIR%"
+if not %ERRORLEVEL%==0 (
+    set _EXITCODE=1
+    goto :eof
+)
+goto :eof
+
+:compile
+if not exist "%_TARGET_DIR%" mkdir "%_TARGET_DIR%"
+
+if not exist "%_OUTPUT_FILE%" goto :md2pdf
+
+call :compile_required "%_OUTPUT_FILE%" "%_IMAGES_DIR%\*.png"
+if %_COMPILE_REQUIRED%==1 goto :md2pdf
+
+call :compile_required "%_OUTPUT_FILE%" "%_TEMPLATES_DIR%\*.tex"
+if %_COMPILE_REQUIRED%==1 goto :md2pdf
+
+call :compile_required "%_OUTPUT_FILE%" "%_SOURCE_DIR%\%_PROJECT_NAME%\*.md"
+if %_COMPILE_REQUIRED%==0 goto :eof
+
+:md2pdf
+if %_DEBUG%==1 ( echo %_DEBUG_LABEL% "%_ROOT_DIR%md2pdf.bat" "%_PROJECT_NAME%" 1>&2
+) else if %_VERBOSE%==1 ( echo md2pdf.bat "%_PROJECT_NAME%" 1>&2
+)
+call "%_ROOT_DIR%md2pdf.bat" "%_PROJECT_NAME%"
+if not %ERRORLEVEL%==0 (
+    set _EXITCODE=1
+    goto :eof
+)
+goto :eof
+
+@rem input parameter: 1=target file 2,3,..=path (wildcards accepted)
+@rem output parameter: _COMPILE_REQUIRED
+:compile_required
+set "__TARGET_FILE=%~1"
+
+set __PATH_ARRAY=
+set __PATH_ARRAY1=
+:compile_path
+shift
+set __PATH=%~1
+if not defined __PATH goto :compile_next
+set __PATH_ARRAY=%__PATH_ARRAY%,'%__PATH%'
+set __PATH_ARRAY1=%__PATH_ARRAY1%,'!__PATH:%_ROOT_DIR%=!'
+goto :compile_path
+
+:compile_next
+set __TARGET_TIMESTAMP=00000000000000
+for /f "usebackq" %%i in (`powershell -c "gci -path '%__TARGET_FILE%' -ea Stop | select -last 1 -expandProperty LastWriteTime | Get-Date -uformat %%Y%%m%%d%%H%%M%%S" 2^>NUL`) do (
+     set __TARGET_TIMESTAMP=%%i
+)
+set __SOURCE_TIMESTAMP=00000000000000
+for /f "usebackq" %%i in (`powershell -c "gci -recurse -path %__PATH_ARRAY:~1% -ea Stop | sort LastWriteTime | select -last 1 -expandProperty LastWriteTime | Get-Date -uformat %%Y%%m%%d%%H%%M%%S" 2^>NUL`) do (
+    set __SOURCE_TIMESTAMP=%%i
+)
+call :newer %__SOURCE_TIMESTAMP% %__TARGET_TIMESTAMP%
+set _COMPILE_REQUIRED=%_NEWER%
+if %_DEBUG%==1 (
+    echo %_DEBUG_LABEL% %__TARGET_TIMESTAMP% Target : '%__TARGET_FILE%' 1>&2
+    echo %_DEBUG_LABEL% %__SOURCE_TIMESTAMP% Sources: %__PATH_ARRAY:~1% 1>&2
+    echo %_DEBUG_LABEL% _COMPILE_REQUIRED=%_COMPILE_REQUIRED% 1>&2
+) else if %_VERBOSE%==1 if %_COMPILE_REQUIRED%==0 if %__SOURCE_TIMESTAMP% gtr 0 (
+    echo No compilation needed ^(%__PATH_ARRAY1:~1%^) 1>&2
+)
+goto :eof
+
+@rem output parameter: _NEWER
+:newer
+set __TIMESTAMP1=%~1
+set __TIMESTAMP2=%~2
+
+set __DATE1=%__TIMESTAMP1:~0,8%
+set __TIME1=%__TIMESTAMP1:~-6%
+
+set __DATE2=%__TIMESTAMP2:~0,8%
+set __TIME2=%__TIMESTAMP2:~-6%
+
+if %__DATE1% gtr %__DATE2% ( set _NEWER=1
+) else if %__DATE1% lss %__DATE2% ( set _NEWER=0
+) else if %__TIME1% gtr %__TIME2% ( set _NEWER=1
+) else ( set _NEWER=0
+)
+goto :eof
+
+:run
+if not exist "%_OUTPUT_FILE%" (
+    echo %_ERROR_LABEL% Output file not found ^("%_OUTPUT_FILE%"^) 1>&2
+    set _EXITCODE=1
+    goto :eof
+)
+if %_DEBUG%==1 echo %_DEBUG_LABEL% start "%_PROJECT_NAME%" "%_OUTPUT_FILE%" 1>&2
+start "%_PROJECT_NAME%" "%_OUTPUT_FILE%"
+goto :eof
+
+@rem output parameter: _DURATION
+:duration
+set __START=%~1
+set __END=%~2
+
+for /f "delims=" %%i in ('powershell -c "$interval = New-TimeSpan -Start '%__START%' -End '%__END%'; Write-Host $interval"') do set _DURATION=%%i
+goto :eof
+
+@rem #########################################################################
+@rem ## Cleanups
+
+:end
+if %_TIMER%==1 (
+    for /f "delims=" %%i in ('powershell -c "(Get-Date)"') do set __TIMER_END=%%i
+    call :duration "%_TIMER_START%" "!__TIMER_END!"
+    echo Total elapsed time: !_DURATION! 1>&2
+)
+if %_DEBUG%==1 echo %_DEBUG_LABEL% _EXITCODE=%_EXITCODE% 1>&2
+exit /b %_EXITCODE%
+endlocal
diff --git a/pandoc/data/defaults.yaml b/pandoc/data/defaults.yaml
new file mode 100644
index 000000000000..cd5bc299bd49
--- /dev/null
+++ b/pandoc/data/defaults.yaml
@@ -0,0 +1,24 @@
+# See page 29 in https://pandoc.org/MANUAL.pdf
+
+to: pdf
+# output-file: target/scala3_reference.pdf
+
+filters:
+- include-files.lua
+
+dpi: 300
+
+table-of-contents: true
+toc-depth: 2
+number-sections: true
+
+
+# input-files:
+# - src/scala3_reference.md
+
+standalone: true
+self-contained: false
+
+# pdf-engine: pdflatex
+pdf-engine: lualatex
+# pdf-engine: xelatex
diff --git a/pandoc/data/filters/include-files.lua b/pandoc/data/filters/include-files.lua
new file mode 100644
index 000000000000..f685ec001cdf
--- /dev/null
+++ b/pandoc/data/filters/include-files.lua
@@ -0,0 +1,92 @@
+--- include-files.lua – filter to include Markdown files
+---
+--- Copyright: © 2019–2020 Albert Krewinkel
+--- License:   MIT – see LICENSE file for details
+
+-- pandoc's List type
+local List = require 'pandoc.List'
+
+--- Get include auto mode
+local include_auto = false
+function get_vars (meta)
+  if meta['include-auto'] then
+    include_auto = true
+  end
+end
+
+--- Keep last heading level found
+local last_heading_level = 0
+function update_last_level(header)
+  last_heading_level = header.level
+end
+
+--- Shift headings in block list by given number
+local function shift_headings(blocks, shift_by)
+  if not shift_by then
+    return blocks
+  end
+
+  local shift_headings_filter = {
+    Header = function (header)
+      header.level = header.level + shift_by
+      return header
+    end
+  }
+
+  return pandoc.walk_block(pandoc.Div(blocks), shift_headings_filter).content
+end
+
+--- Filter function for code blocks
+local transclude
+function transclude (cb)
+  -- ignore code blocks which are not of class "include".
+  if not cb.classes:includes 'include' then
+    return
+  end
+
+  -- Markdown is used if this is nil.
+  local format = cb.attributes['format']
+
+  -- Attributes shift headings
+  local shift_heading_level_by = 0
+  local shift_input = cb.attributes['shift-heading-level-by']
+  if shift_input then
+    shift_heading_level_by = tonumber(shift_input)
+  else
+    if include_auto then
+      -- Auto shift headings
+      shift_heading_level_by = last_heading_level
+    end
+  end
+
+  --- keep track of level before recusion
+  local buffer_last_heading_level = last_heading_level
+
+  local blocks = List:new()
+  for line in cb.text:gmatch('[^\n]+') do
+    if line:sub(1,2) ~= '//' then
+      local fh = io.open(line)
+      if not fh then
+        io.stderr:write("Cannot open file " .. line .. " | Skipping includes\n")
+      else
+        local contents = pandoc.read(fh:read '*a', format).blocks
+        last_heading_level = 0
+        -- recursive transclusion
+        contents = pandoc.walk_block(
+          pandoc.Div(contents),
+          { Header = update_last_level, CodeBlock = transclude }
+          ).content
+        --- reset to level before recursion
+        last_heading_level = buffer_last_heading_level
+        blocks:extend(shift_headings(contents, shift_heading_level_by))
+        fh:close()
+      end
+    end
+  end
+  return blocks
+end
+
+return {
+  { Meta = get_vars },
+  { Header = update_last_level, CodeBlock = transclude }
+}
diff --git a/pandoc/data/filters/inlcude-files.txt b/pandoc/data/filters/inlcude-files.txt
new file mode 100644
index 000000000000..e7764ea1aaec
--- /dev/null
+++ b/pandoc/data/filters/inlcude-files.txt
@@ -0,0 +1 @@
+Source: https://github.com/pandoc/lua-filters/tree/master/include-files
diff --git a/pandoc/data/images/explicit-nulls/explicit-nulls-type-hierarchy.png b/pandoc/data/images/explicit-nulls/explicit-nulls-type-hierarchy.png
new file mode 100644
index 000000000000..65179260c246
Binary files /dev/null and b/pandoc/data/images/explicit-nulls/explicit-nulls-type-hierarchy.png differ
diff --git a/pandoc/data/images/external.png b/pandoc/data/images/external.png
new file mode 100644
index 000000000000..acf772f0ad6a
Binary files /dev/null and b/pandoc/data/images/external.png differ
diff --git a/pandoc/data/images/external.txt b/pandoc/data/images/external.txt
new file mode 100644
index 000000000000..969a4d35ef77
--- /dev/null
+++ b/pandoc/data/images/external.txt
@@ -0,0 +1,2 @@
+Source: https://icon-icons.com/pack/Heroicons/2550
+License: https://opensource.org/licenses/mit-license.php
diff --git a/pandoc/data/images/scala-spiral.png b/pandoc/data/images/scala-spiral.png
new file mode 100644
index 000000000000..8280fd4bfc3f
Binary files /dev/null and b/pandoc/data/images/scala-spiral.png differ
diff --git a/pandoc/data/internals.md b/pandoc/data/internals.md
new file mode 100644
index 000000000000..18b6606e0178
--- /dev/null
+++ b/pandoc/data/internals.md
@@ -0,0 +1,81 @@
+---
+layout: doc-page
+title: "Scala 3 Internals"
+titlegraphic: ../out/pandoc/images/scala-spiral.png
+author: Martin Odersky et al.
+abstract-title: WILL_BE_IGNORED
+abstract: |
+  Latest HTML version available at
+  [`https://dotty.epfl.ch/docs/internals/`](https://dotty.epfl.ch/docs/internals/backend.html)
+---
+
+\newpage
+# Backend Internals [![](../out/pandoc/images/external.png){width=64px}](https://dotty.epfl.ch/docs/internals/backend.html) {#backend}
+```{.include}
+../out/pandoc/src_managed/internals/backend.md
+```
+
+\newpage
+# Classpaths [![](../out/pandoc/images/external.png){width=64px}](https://dotty.epfl.ch/docs/internals/classpaths.html) {#classpaths}
+```{.include}
+../out/pandoc/src_managed/internals/classpaths.md
+```
+
+\newpage
+# Core Data Structures [![](../out/pandoc/images/external.png){width=64px}](https://dotty.epfl.ch/docs/internals/core-data-structures.html) {#core-data-structures}
+```{.include}
+../out/pandoc/src_managed/internals/core-data-structures.md
+```
+
+\newpage
+# Dotty Overvall Structure [![](../out/pandoc/images/external.png){width=64px}](https://dotty.epfl.ch/docs/internals/overall-structure.html) {#overall-structure}
+```{.include}
+../out/pandoc/src_managed/internals/overall-structure.md
+```
+
+\newpage
+# Dotc's concept of time [![](../out/pandoc/images/external.png){width=64px}](https://dotty.epfl.ch/docs/internals/periods.html) {#periods}
+```{.include}
+../out/pandoc/src_managed/internals/periods.md
+```
+
+\newpage
+# Scala 3 Syntax Summary [![](../out/pandoc/images/external.png){width=64px}](https://dotty.epfl.ch/docs/internals/syntax.html) {#syntax}
+```{.include}
+../out/pandoc/src_managed/internals/syntax.md
+```
+
+\newpage
+# Type System [![](../out/pandoc/images/external.png){width=64px}](https://dotty.epfl.ch/docs/internals/type-system.html) {#type-system}
+```{.include}
+../out/pandoc/src_managed/internals/type-system.md
+```
+
+# Dotty Internals 1 [![](../out/pandoc/images/external.png){width=64px}](https://dotty.epfl.ch/docs/internals/dotty-internals-1-notes.html) {#dotty-internals-1-notes}
+```{.include}
+../out/pandoc/src_managed/internals/dotty-internals-1-notes.md
+```
+
+\newpage
+# Debug Macros [![](../out/pandoc/images/external.png){width=64px}](https://dotty.epfl.ch/docs/internals/debug-macros.html) {#debug-macros}
+```{.include}
+../out/pandoc/src_managed/internals/debug-macros.md
+```
+
+\newpage
+# Differences between Scalac and Dotty [![](../out/pandoc/images/external.png){width=64px}](https://dotty.epfl.ch/docs/internals/dotc-scalac.html) {#dotc-scalac}
+```{.include}
+../out/pandoc/src_managed/internals/dotc-scalac.md
+```
+
+\newpage
+# Contexts [![](../out/pandoc/images/external.png){width=64px}](https://dotty.epfl.ch/docs/internals/contexts.html) {#contexts}
+```{.include}
+../out/pandoc/src_managed/internals/contexts.md
+```
+
+\newpage
+# Explicit Nulls [![](../out/pandoc/images/external.png){width=64px}](https://dotty.epfl.ch/docs/internals/explicit-nulls.html) {#explicit-nulls}
+```{.include}
+../out/pandoc/src_managed/internals/explicit-nulls.md
+```
diff --git a/pandoc/data/reference.md b/pandoc/data/reference.md
new file mode 100644
index 000000000000..8e4b46a3638a
--- /dev/null
+++ b/pandoc/data/reference.md
@@ -0,0 +1,625 @@
+---
+layout: doc-page
+title: "Scala 3 Reference"
+titlegraphic: ../out/pandoc/images/scala-spiral.png
+author: Martin Odersky et al.
+institute: EPFL, Switzerland
+abstract-title: WILL_BE_IGNORED
+abstract: |
+  Latest HTML version available at
+  [`https://docs.scala-lang.org/scala3/reference/`](https://docs.scala-lang.org/scala3/reference/overview.html)
+---
+
+\newpage
+# Overview [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/overview.html) {#overview}
+```{.include}
+../out/pandoc/src_managed/reference/overview.md
+```
+
+## Soft Keywords [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/soft-modifier.html) {#soft-modifier}
+```{.include}
+../out/pandoc/src_managed/reference/soft-modifier.md
+```
+
+[new-types]: #################################################################
+
+\newpage
+# New Types [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/new-types.html) {#new-types}
+
+## Intersection types [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/new-types/intersection-types.html) {#intersection-types}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/new-types/intersection-types.md
+```
+
+## Union types [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/new-types/union-types.html) {#union-types}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/new-types/union-types.md
+```
+
+## Type lambdas [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/new-types/type-lambdas.html) {#type-lambdas}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/new-types/type-lambdas.md
+```
+
+## Match Types [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/new-types/match-types.html) {#match-types}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/new-types/match-types.md
+```
+
+## Dependent Function Types [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/new-types/dependent-function-types.html) {#dependent-function-types}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/new-types/dependent-function-types.md
+```
+
+## Polymorphic Function Types [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/new-types/polymorphic-function-types.html) {#polymorphic-function-types}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/new-types/polymorphic-function-types.md
+```
+
+[enums]: #####################################################################
+
+\newpage
+# Enums [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/enums.html) {#enums-2}
+
+## Enumerations [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/enums/enums.html) {#enums}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/enums/enums.md
+```
+
+## Algebraic Data Types [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/enums/adts.html) {#adts}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/enums/adts.md
+```
+
+## Translation of Enums and ADTs [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/enums/desugarEnums.html) {#desugarEnums}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/enums/desugarEnums.md
+```
+
+[contextual-abstractions]: ###################################################
+
+\newpage
+# Contextual Abstractions [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/contextual/contextual.html) {#motivation}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/contextual/contextual.md
+```
+
+## Given Instances [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/contextual/givens.html) {#givens}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/contextual/givens.md
+```
+
+## Using Clauses [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/contextual/using-clauses.html) {#using-clauses}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/contextual/using-clauses.md
+```
+
+## Context Bounds [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/contextual/context-bounds.html) {#context-bounds}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/contextual/context-bounds.md
+```
+
+## Importing Givens [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/contextual/given-imports.html) {#given-imports}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/contextual/given-imports.md
+```
+
+## Extension Methods [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/contextual/extension-methods.html) {#extension-methods}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/contextual/extension-methods.md
+```
+
+## Implementing Type classes [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/contextual/type-classes.html) {#type-classes}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/contextual/type-classes.md
+```
+
+## Type Class Derivation [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/contextual/derivation.html) {#derivation}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/contextual/derivation.md
+```
+
+## Multiversal Equality [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/contextual/multiversal-equality.html) {#multiversal-equality}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/contextual/multiversal-equality.md
+```
+
+## Context Functions [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/contextual/context-functions.html) {#context-functions}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/contextual/context-functions.md
+```
+
+## Implicit Conversions [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/contextual/conversions.html) {#conversions}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/contextual/conversions.md
+```
+
+## By-Name Context Parameters [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/contextual/by-name-context-parameters.html) {#by-name-context-parameters}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/contextual/by-name-context-parameters.md
+```
+
+## Relationship with Scala 2 Implicits [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/contextual/relationship-implicits.html) {#relationship-implicits}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/contextual/relationship-implicits.md
+```
+
+## How to write a type class `derived` method using macros {#derivation-macro}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/contextual/derivation-macro.md
+``` 
+
+[metaprogramming]: ###########################################################
+
+\newpage
+# Metaprogramming [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/metaprogramming.html) {#metaprogramming}
+
+```{.include}
+../out/pandoc/src_managed/reference/metaprogramming/metaprogramming.md
+```
+
+## Inline [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/metaprogramming/inline.html) {#inline}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/metaprogramming/inline.md
+```
+
+## Macros [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/metaprogramming/macros.html) {#macros}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/metaprogramming/macros.md
+```
+
+## Multi-Stage Programming [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/metaprogramming/staging.html) {#staging}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/metaprogramming/staging.md
+```
+
+## Reflection [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/metaprogramming/reflection.html) {#reflection}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/metaprogramming/reflection.md
+```
+
+## TASTy Inspection [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/metaprogramming/tasty-inspect.html) {#tasty-inspect}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/metaprogramming/tasty-inspect.md
+```
+
+## The Meta-theory of Symmetric Metaprogramming [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/metaprogramming/simple-smp.html) {#simple-smp}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/metaprogramming/simple-smp.md
+```
+
+[other-new-features]: ########################################################
+
+\newpage
+# Other New Features [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/other-new-features.html) {#other-new-features}
+
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/other-new-features/other-new-types.md
+```
+
+## Trait Parameters [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/other-new-features/trait-parameters.html) {#trait-parameters}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/other-new-features/trait-parameters.md
+```
+
+## Transparent Traits [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/other-new-features/transparent-traits.html) {#transparent-traits}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/other-new-features/transparent-traits.md
+```
+
+## Universal Apply Methods [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/other-new-features/creator-applications.html) {#creator-applications}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/other-new-features/creator-applications.md
+```
+
+## Export clauses [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/other-new-features/export.html) {#export}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/other-new-features/export.md
+```
+
+## Opaque Type Aliases [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/other-new-features/opaques.html) {#opaques}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/other-new-features/opaques.md
+```
+
+## Open Classes [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/other-new-features/open-classes.html) {#open-classes}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/other-new-features/open-classes.md
+```
+
+## Parameter Untupling [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/other-new-features/parameter-untupling.html) {#parameter-untupling}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/other-new-features/parameter-untupling.md
+```
+
+## Kind Polymorphism [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/other-new-features/kind-polymorphism.html) {#kind-polymorphism}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/other-new-features/kind-polymorphism.md
+```
+
+## The Matchable Trait [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/other-new-features/matchable.html) {#matchable}
+```{.include}
+../out/pandoc/src_managed/reference/other-new-features/matchable.md
+```
+
+## `@threadUnsafe` Annotation [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/other-new-features/threadUnsafe-annotation.html) {#threadUnsafe-annotation}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/other-new-features/threadUnsafe-annotation.md
+```
+
+## `@targetName` Annotations [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/other-new-features/targetName.html) {#targetName}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/other-new-features/targetName.md
+```
+
+## New Control Syntax [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/other-new-features/control-syntax.html) {#control-syntax}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/other-new-features/control-syntax.md
+```
+
+## Optional Braces [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/other-new-features/indentation.html) {#indentation}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/other-new-features/indentation.md
+```
+
+## Fewer Braces [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/other-new-features/indentation-experimental.html) {#indentation-experimental}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/other-new-features/indentation-experimental.md
+```
+
+## Safe Initialization [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/other-new-features/safe-initialization.html) {#safe-initialization}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/other-new-features/safe-initialization.md
+```
+
+## TypeTest [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/other-new-features/type-test.html) {#type-test}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/other-new-features/type-test.md
+```
+
+## Experimental Definitions [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/other-new-features/experimental-defs.html) {#type-test}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/other-new-features/experimental-defs.md
+```
+
+[changed-features]: ##########################################################
+
+\newpage
+# Other Changed Features [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/changed-features.html) {#other-changed-features}
+
+## Numeric Literals [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/changed-features/numeric-literals.html) {#numeric-literals}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/changed-features/numeric-literals.md
+```
+
+## Programmatic Structural Types [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/changed-features/structural-types.html) {#structural-types}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/changed-features/structural-types.md
+```
+
+## Rules for Operators [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/changed-features/operators.html) {#operators}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/changed-features/operators.md
+```
+
+## Wildcard Arguments in Types [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/changed-features/wildcards.html) {#wildcards}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/changed-features/wildcards.md
+```
+
+## Imports [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/changed-features/imports.html) {#wildcards}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/changed-features/imports.md
+```
+
+## Changes in Type Checking [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/changed-features/type-checking.html) {#type-checking}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/changed-features/type-checking.md
+```
+
+## Changes in Type Inference [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/changed-features/type-inference.html) {#type-inference}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/changed-features/type-inference.md
+```
+
+## Changes in Implicit Resolution [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/changed-features/implicit-resolution.html) {#implicit-resolution}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/changed-features/implicit-resolution.md
+```
+
+## Implicit Conversions [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/changed-features/implicit-conversions.html) {#implicit-conversions}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/changed-features/implicit-conversions.md
+```
+
+## Changes in Overload Resolution [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/changed-features/overload-resolution.html) {#overload-resolution}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/changed-features/overload-resolution.md
+```
+
+## Match Expressions [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/changed-features/match-syntax.html) {#match-syntax}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/changed-features/match-syntax.md
+```
+
+## Vararg Splices [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/changed-features/vararg-splices.html) {#vararg-splices}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/changed-features/vararg-splices.md
+```
+
+## Pattern Bindings [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/changed-features/pattern-bindings.html) {#pattern-bindings}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/changed-features/pattern-bindings.md
+```
+
+## Option-less pattern matching [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/changed-features/pattern-matching.html) {#pattern-matching}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/changed-features/pattern-matching.md
+```
+
+## Automatic Eta Expansion [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/changed-features/eta-expansion.html) {#eta-expansion}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/changed-features/eta-expansion.md
+```
+
+## Changes in Compiler Plugins [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/changed-features/compiler-plugins.html) {#compiler-plugins}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/changed-features/compiler-plugins.md
+```
+
+## Lazy Vals Initialization [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/changed-features/lazy-vals-init.html) {#lazy-vals-init}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/changed-features/lazy-vals-init.md
+```
+
+## Main Methods [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/changed-features/main-functions.html) {#main-functions}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/changed-features/main-functions.md
+```
+
+## Escapes in interpolations [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/changed-features/interpolation-escapes.html) {#interpolation-escapes}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/changed-features/interpolation-escapes.md
+```
+
+[dropped-features]: ##########################################################
+
+\newpage
+# Dropped Features [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/dropped-features.html) {#dropped-features}
+
+## Dropped: DelayedInit [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/dropped-features/delayed-init.html) {#delayed-init}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/dropped-features/delayed-init.md
+```
+
+## Dropped: Scala 2 Macros [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/dropped-features/macros.html) {#macros2}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/dropped-features/macros.md
+```
+
+## Dropped: Existential types [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/dropped-features/existential-types.html) {#existential-types}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/dropped-features/existential-types.md
+```
+
+## Dropped: General Type Projection [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/dropped-features/type-projection.html) {#type-projection}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/dropped-features/type-projection.md
+```
+
+## Dropped: Do-While [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/dropped-features/do-while.html) {#do-while}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/dropped-features/do-while.md
+```
+
+## Dropped: Procedure Syntax [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/dropped-features/procedure-syntax.html) {#procedure-syntax}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/dropped-features/procedure-syntax.md
+```
+
+## Dropped: Package Objects [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/dropped-features/package-objects.html) {#package-objects}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/dropped-features/package-objects.md
+```
+
+## Dropped: Early Initializers [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/dropped-features/early-initializers.html) {#early-initializers}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/dropped-features/early-initializers.md
+```
+
+## Dropped: Class shadowing [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/dropped-features/class-shadowing.html) {#class-shadowing}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/dropped-features/class-shadowing.md
+```
+
+## Dropped: Limit 22 [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/dropped-features/limit22.html) {#limit22}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/dropped-features/limit22.md
+```
+
+## Dropped: XML literals [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/dropped-features/xml.html) {#xml}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/dropped-features/xml.md
+```
+
+## Dropped: Symbol literals [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/dropped-features/symlits.html) {#symlits}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/dropped-features/symlits.md
+```
+
+## Dropped: Auto-Application [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/dropped-features/auto-apply.html) {#auto-apply}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/dropped-features/auto-apply.md
+```
+
+## Dropped: Weak conformance [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/dropped-features/weak-conformance.html) {#weak-conformance}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/dropped-features/weak-conformance.md
+```
+
+## Deprecated: Nonlocal Returns [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/dropped-features/nonlocal-returns.html) {#nonlocal-returns}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/dropped-features/nonlocal-returns.md
+```
+
+## Dropped: `private[this]` and `protected[this]` [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/dropped-features/this-qualifier.html) {#this-qualifier}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/dropped-features/this-qualifier.md
+```
+
+## Dropped: Wildcard Initializer [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/dropped-features/wildcard-init.html) {#wildcard-init}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/dropped-features/wildcard-init.md
+```
+
+[experimental]: ##############################################################
+
+\newpage
+# Experimental Features [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/experimental/overview.html) {#experimental-features}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/experimental/overview.md
+```
+
+## CanThrow Capabilities [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/experimental/canthrow.html) {#canthrow}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/experimental/canthrow.md
+```
+
+## Capture Checking [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/experimental/cc.html) {#capture-checking}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/experimental/cc.md
+```
+
+## Erased Definitions [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/experimental/erased-defs.html) {#erased-defs}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/experimental/erased-defs.md
+```
+
+## Explicit Nulls [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/experimental/explicit-nulls.html) {#explicit-nulls}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/experimental/explicit-nulls.md
+```
+
+## Named Type Arguments [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/experimental/named-typeargs.html) {#named-typeargs}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/experimental/named-typeargs.md
+```
+
+## Named Numeric Literals [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/experimental/numeric-literals.html) {#numeric-literals}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/experimental/numeric-literals.md
+```
+
+[syntax]: ####################################################################
+
+\newpage
+# Scala 3 Syntax Summary [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/syntax.html) {#syntax}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/syntax.md
+```
+
+[language-versions]: #########################################################
+
+\newpage
+# Language Versions [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/language-versions.html) {#language-versions}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/language-versions/language-versions.md
+```
+
+## Source Compatibility [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/language-versions/source-compatibility.html) {#source-compatibility}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/language-versions/source-compatibility.md
+```
+
+## Binary Compatibility [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/language-versions/binary-compatibility.html) {#binary-compatibility}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/language-versions/binary-compatibility.md
+```
+
+[appendix]: ##################################################################
+
+\newpage
+# Appendix {#appendix}
+
+## Context Functions - More Details [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/contextual/context-functions-spec.html) {#context-functions-spec}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/contextual/context-functions-spec.md
+```
+
+## Opaque Type Aliases: More Details [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/other-new-features/opaques-details.html) {#opaques-details}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/other-new-features/opaques-details.md
+```
+
+## Parameter Untupling - More Details [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/other-new-features/parameter-untupling-spec.html) {#parameter-untupling-spec}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/other-new-features/parameter-untupling-spec.md
+```
+
+## Dropped: Class Shadowing - More Details [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/dropped-features/class-shadowing-spec.html) {#class-shadowing-spec}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/dropped-features/class-shadowing-spec.md
+```
+
+## Dropped: Weak Conformance - More Details [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/dropped-features/weak-conformance-spec.html) {#weak-conformance-spec}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/dropped-features/weak-conformance-spec.md
+```
+
+## Automatic Eta Expansion - More Details [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/changed-features/eta-expansion-spec.html) {#eta-expansion-spec}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/changed-features/eta-expansion-spec.md
+```
+
+## Implicit Conversions - More Details [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/changed-features/implicit-conversions-spec.html) {#implicit-conversions-spec}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/changed-features/implicit-conversions-spec.md
+```
+
+## Programmatic Structural Types - More Details [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/changed-features/structural-types-spec.html) {#structural-types-spec}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/changed-features/structural-types-spec.md
+```
+
+## Dependent Function Types - More Details [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/new-types/dependent-function-types-spec.html) {#dependent-function-types-spec}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/new-types/dependent-function-types-spec.md
+```
+
+## Intersection Types - More Details [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/new-types/intersection-types-spec.html) {#intersection-types-spec.}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/new-types/intersection-types-spec.md
+```
+
+## Type Lambdas - More Details [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/new-types/type-lambdas-spec.html) {#type-lambdas-spec}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/new-types/type-lambdas-spec.md
+```
+
+## Union Types - More Details [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/new-types/union-types-spec.html) {#union-types-spec}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/new-types/union-types-spec.md
+```
+
+## Macros Spec [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/metaprogramming/macros-spec.html) {#macros-spec}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/metaprogramming/macros-spec.md
+```
+
+## Erased Definitions: More Details [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/experimental/erased-defs-spec.html) {#erased-defs-spec}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/experimental/erased-defs-spec.md
+```
+
+## Named Type Arguments - More Details [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/experimental/named-typeargs-spec.html) {#named-typeargs-spec}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/experimental/named-typeargs-spec.md
+```
+
+[features-classification]: # Referenced in overview.md #######################
+
+\newpage
+## A Classification of Proposed Language Features [![](../out/pandoc/images/external.png){width=64px}&nbsp;](https://docs.scala-lang.org/scala3/reference/features-classification.html) {#features-classification}
+```{.include shift-heading-level-by=1}
+../out/pandoc/src_managed/reference/features-classification.md
+```
diff --git a/pandoc/data/templates/scala.xml b/pandoc/data/templates/scala.xml
new file mode 100644
index 000000000000..42b79eb73238
--- /dev/null
+++ b/pandoc/data/templates/scala.xml
@@ -0,0 +1,378 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE language SYSTEM "language.dtd">
+<language name="Scala" version="11" kateversion="5.62" section="Sources"
+          extensions="*.scala;*.sbt" mimetype="text/x-scala" license="LGPL"
+          author="Stephane Micheloud (stephane.micheloud@alumni.epfl.ch)">
+<!--
+adapted from "java.xml" by Alfredo Luiz Foltran Fialho (alfoltran@ig.com.br)
+-->
+  <highlighting>
+    <list name="scala2">
+      <item>Actor</item>
+      <item>ActorProxy</item>
+      <item>ActorTask</item>
+      <item>ActorThread</item>
+      <item>AllRef</item>
+      <item>Any</item>
+      <item>AnyRef</item>
+      <item>Application</item>
+      <item>AppliedType</item>
+      <item>Array</item>
+      <item>ArrayBuffer</item>
+      <item>Attribute</item>
+      <item>BoxedArray</item>
+      <item>BoxedBooleanArray</item>
+      <item>BoxedByteArray</item>
+      <item>BoxedCharArray</item>
+      <item>Buffer</item>
+      <item>BufferedIterator</item>
+      <item>Char</item>
+      <item>Console</item>
+      <item>Enumeration</item>
+      <item>Fluid</item>
+      <item>Function</item>
+      <item>IScheduler</item>
+      <item>ImmutableMapAdaptor</item>
+      <item>ImmutableSetAdaptor</item>
+      <item>Int</item>
+      <item>Iterable</item>
+      <item>List</item>
+      <item>ListBuffer</item>
+      <item>None</item>
+      <item>Option</item>
+      <item>Ordered</item>
+      <item>Pair</item>
+      <item>PartialFunction</item>
+      <item>Pid</item>
+      <item>Predef</item>
+      <item>PriorityQueue</item>
+      <item>PriorityQueueProxy</item>
+      <item>Reaction</item>
+      <item>Ref</item>
+      <item>Responder</item>
+      <item>RichInt</item>
+      <item>RichString</item>
+      <item>Rule</item>
+      <item>RuleTransformer</item>
+      <item>Script</item>
+      <item>Seq</item>
+      <item>SerialVersionUID</item>
+      <item>Some</item>
+      <item>Stream</item>
+      <item>Symbol</item>
+      <item>TcpService</item>
+      <item>TcpServiceWorker</item>
+      <item>Triple</item>
+      <item>Unit</item>
+      <item>Value</item>
+      <item>WorkerThread</item>
+      <item>serializable</item>
+      <item>transient</item>
+      <item>volatile</item>
+    </list>
+    <list name="java15">
+      <include>java15##Java</include>
+    </list>
+    <list name="keywords">
+      <item>abstract</item>
+      <item>class</item>
+      <item>def</item>
+      <item>enum</item>
+      <item>export</item>
+      <item>extends</item>
+      <item>false</item>
+      <item>final</item>
+      <item>given</item>
+      <item>implicit</item>
+      <item>import</item>
+      <item>lazy</item>
+      <item>new</item>
+      <item>null</item>
+      <item>object</item>
+      <item>override</item>
+      <item>package</item>
+      <item>private</item>
+      <item>protected</item>
+      <item>sealed</item>
+      <item>super</item>
+      <item>then</item>
+      <item>this</item>
+      <item>trait</item>
+      <item>true</item>
+      <item>type</item>
+      <item>val</item>
+      <item>var</item>
+      <item>with</item>
+    </list>
+    <list name="control flow">
+      <item>case</item>
+      <item>catch</item>
+      <item>do</item>
+      <item>else</item>
+      <item>finally</item>
+      <item>for</item>
+      <item>if</item>
+      <item>match</item>
+      <item>return</item>
+      <item>throw</item>
+      <item>try</item>
+      <item>while</item>
+      <item>yield</item>
+    </list>
+    <list name="types">
+      <item>boolean</item>
+      <item>byte</item>
+      <item>char</item>
+      <item>double</item>
+      <item>float</item>
+      <item>int</item>
+      <item>long</item>
+      <item>short</item>
+      <item>unit</item>
+    </list>
+    <contexts>
+      <context attribute="Normal Text" lineEndContext="#stay" name="Normal">
+        <DetectSpaces context="#stay"/>
+
+        <!-- Comment next line if you don't use Javadoc tool -->
+        <!-- <IncludeRules context="##Javadoc"/> -->
+        <Detect2Chars attribute="Comment" context="CommentSingleLine" char="/" char1="/"/>
+        <Detect2Chars attribute="Comment" context="CommentMultiline" char="/" char1="*" beginRegion="Comment"/>
+
+        <DetectChar attribute="Symbol" context="#stay" char="{" beginRegion="Brace1"/>
+        <DetectChar attribute="Symbol" context="#stay" char="}" endRegion="Brace1"/>
+        <DetectChar attribute="Annotation" context="Annotation" char="@"/>
+        <Float attribute="Float" context="Float Suffixes"/>
+        <AnyChar attribute="Symbol" context="#stay" String=".()[]&amp;|+,-/*&lt;=&gt;;!%?:~^"/>
+        <HlCHex attribute="Hex" context="Int Suffixes"/>
+        <Int attribute="Decimal" context="Int Suffixes"/>
+
+        <DetectChar attribute="String" context="String" char="&quot;"/>
+        <DetectChar context="Char" char="'" lookAhead="1"/>
+        <Detect2Chars attribute="String Interpolation" context="StringInterpolatorS" char="s" char1="&quot;"/>
+        <Detect2Chars attribute="String Interpolation" context="StringInterpolatorF" char="f" char1="&quot;"/>
+        <StringDetect attribute="Raw String" context="StringInterpolatorRaw" String="raw&quot;"/>
+
+        <WordDetect attribute="Keyword" context="SoftKeywordAs" String="as"/>
+        <WordDetect attribute="Keyword" context="SoftKeywordDerives" String="derives"/>
+        <WordDetect attribute="Keyword" context="SoftKeywordEnd" String="end"/>
+        <WordDetect attribute="Keyword" context="SoftKeywordErased" String="erased"/>
+        <WordDetect attribute="Keyword" context="SoftKeywordExtension" String="extension"/>
+        <WordDetect attribute="Keyword" context="SoftKeywordInfix" String="infix"/>
+        <WordDetect attribute="Keyword" context="SoftKeywordInline" String="inline"/>
+        <WordDetect attribute="Keyword" context="SoftKeywordOpaque" String="opaque"/>
+        <WordDetect attribute="Keyword" context="SoftKeywordOpen" String="open"/>
+        <WordDetect attribute="Keyword" context="SoftKeywordTransparent" String="transparent"/>
+        <WordDetect attribute="Keyword" context="SoftKeywordUsing" String="using"/>
+
+        <keyword attribute="Keyword" context="#stay" String="keywords"/>
+        <keyword attribute="Control Flow" context="#stay" String="control flow"/>
+        <keyword attribute="Data Type" context="#stay" String="types"/>
+        <keyword attribute="Java15" context="#stay" String="java15"/>
+        <keyword attribute="Scala2" context="#stay" String="scala2"/>
+
+        <RegExpr attribute="Function" context="#stay" String="\b[_a-zA-Z]\w*(?=[\s]*(?:/\*\s*\d+\s*\*/\s*)?[(])" />
+        <DetectIdentifier context="#stay"/>
+      </context>
+
+      <context attribute="Float" lineEndContext="#pop" name="Float Suffixes" fallthroughContext="#pop">
+        <AnyChar attribute="Float" context="#pop" String="fdFD"/>
+      </context>
+      <context attribute="Decimal" lineEndContext="#pop" name="Int Suffixes" fallthroughContext="#pop">
+        <AnyChar attribute="Decimal" context="#pop" String="Ll"/>
+      </context>
+
+      <context attribute="Normal Text" lineEndContext="#pop" name="Annotation" fallthroughContext="#pop">
+        <RegExpr attribute="Annotation" context="#pop" String="[_a-zA-Z]+(\.[0-9_a-zA-Z]+)*"/>
+      </context>
+
+      <context attribute="Normal Text" lineEndContext="#stay" name="Char">
+        <HlCChar attribute="Char" context="#pop"/>
+        <RegExpr attribute="Char" context="#pop" String="'\\u+[0-9a-fA-F]{4}'"/>
+        <RegExpr attribute="Error" context="#pop" String="'(\\(u+[0-9a-fA-F]*|.))?'?"/>
+      </context>
+
+      <context attribute="String" lineEndContext="#pop" name="String" fallthroughContext="#pop!SingleLineString">
+        <Detect2Chars attribute="String" context="#pop!MultiLineString" char="&quot;" char1="&quot;"/>
+        <DetectChar attribute="String" context="#pop" char="&quot;"/>
+      </context>
+      <context attribute="String" lineEndContext="#pop" name="SingleLineString">
+        <DetectChar context="StringEscapedChar" char="\" lookAhead="1"/>
+        <DetectChar attribute="String" context="#pop" char="&quot;"/>
+      </context>
+      <context attribute="String" lineEndContext="#stay" name="MultiLineString">
+        <DetectChar context="StringEscapedChar" char="\" lookAhead="1"/>
+        <DetectChar context="MultiLineStringFinal" char="&quot;" lookAhead="1"/>
+      </context>
+      <context attribute="String" lineEndContext="#stay" name="MultiLineStringFinal">
+        <StringDetect context="MultiLineStringNoFinal" String="&quot;&quot;&quot;&quot;" lookAhead="1"/>
+        <StringDetect attribute="String" context="#pop#pop" String="&quot;&quot;&quot;"/>
+        <Detect2Chars attribute="String" context="#pop" char="&quot;" char1="&quot;"/>
+        <DetectChar attribute="String" context="#pop" char="&quot;"/>
+      </context>
+      <context attribute="String" lineEndContext="#stay" name="MultiLineStringNoFinal">
+        <DetectChar attribute="String" context="#pop" char="&quot;"/>
+      </context>
+      <context attribute="String" lineEndContext="#pop" name="StringEscapedChar">
+        <HlCStringChar attribute="String Char" context="#pop"/>
+        <RegExpr attribute="String Char" context="#pop" String="\\u+[0-9a-fA-F]{4}"/>
+        <RegExpr attribute="Error" context="#pop" String="\\(u+[0-9a-fA-F]*|.)?"/>
+      </context>
+
+      <context attribute="String" lineEndContext="#pop" name="StringInterpolatorS" fallthroughContext="#pop!SingleLineStringInterpolatorS">
+        <Detect2Chars attribute="String Interpolation" context="#pop!MultiLineStringInterpolatorS" char="&quot;" char1="&quot;"/>
+      </context>
+      <context attribute="String" lineEndContext="#pop" name="SingleLineStringInterpolatorS">
+        <DetectChar context="StringEscapedChar" char="\" lookAhead="1"/>
+        <DetectChar context="Interpolation" char="$" lookAhead="1"/>
+        <DetectChar attribute="String Interpolation" context="#pop" char="&quot;"/>
+      </context>
+      <context attribute="String" lineEndContext="#stay" name="MultiLineStringInterpolatorS">
+        <DetectChar context="Interpolation" char="$" lookAhead="1"/>
+        <DetectChar context="StringEscapedChar" char="\" lookAhead="1"/>
+        <DetectChar context="MultiLineStringInterpolarFinal" char="&quot;" lookAhead="1"/>
+      </context>
+      <context attribute="String" lineEndContext="#stay" name="MultiLineStringInterpolarFinal">
+        <StringDetect context="MultiLineStringInterpolarNoFinal" String="&quot;&quot;&quot;&quot;" lookAhead="1"/>
+        <StringDetect attribute="String Interpolation" context="#pop#pop" String="&quot;&quot;&quot;"/>
+        <Detect2Chars attribute="String" context="#pop" char="&quot;" char1="&quot;"/>
+        <DetectChar attribute="String" context="#pop" char="&quot;"/>
+      </context>
+      <context attribute="String" lineEndContext="#stay" name="MultiLineStringInterpolarNoFinal">
+        <DetectChar attribute="String" context="#pop" char="&quot;"/>
+      </context>
+      <context attribute="String" lineEndContext="#stay" name="Interpolation">
+        <Detect2Chars attribute="String Interpolation" context="#pop!InInterpolation" char="$" char1="{"/>
+        <Detect2Chars attribute="String Char" context="#pop" char="$" char1="$"/>
+        <DetectChar attribute="String Interpolation" context="#pop!Variable" char="$"/>
+      </context>
+      <context attribute="String Interpolation" lineEndContext="#stay" name="InInterpolation">
+        <DetectChar attribute="String Interpolation" context="#pop" char="}"/>
+        <IncludeRules context="Normal"/>
+      </context>
+      <context attribute="String" lineEndContext="#pop" name="Variable" fallthroughContext="#pop">
+        <DetectIdentifier attribute="String Interpolation" context="#pop"/>
+      </context>
+
+      <context attribute="String" lineEndContext="#pop" name="StringInterpolatorF" fallthroughContext="#pop!SingleLineStringInterpolatorF">
+        <Detect2Chars attribute="String Interpolation" context="#pop!MultiLineStringInterpolatorF" char="&quot;" char1="&quot;"/>
+      </context>
+      <context attribute="String" lineEndContext="#pop" name="SingleLineStringInterpolatorF">
+        <Detect2Chars attribute="String Interpolation" context="InInterpolation" char="$" char1="{"/>
+        <Detect2Chars attribute="String Char" context="#stay" char="$" char1="$"/>
+        <DetectChar attribute="String Interpolation" context="VariableF" char="$"/>
+        <DetectChar context="StringEscapedChar" char="\" lookAhead="1"/>
+        <DetectChar attribute="String Interpolation" context="#pop" char="&quot;"/>
+      </context>
+      <context attribute="String" lineEndContext="#stay" name="MultiLineStringInterpolatorF">
+        <Detect2Chars attribute="String Interpolation" context="InInterpolation" char="$" char1="{"/>
+        <Detect2Chars attribute="String Char" context="#stay" char="$" char1="$"/>
+        <DetectChar attribute="String Interpolation" context="VariableF" char="$"/>
+        <DetectChar context="StringEscapedChar" char="\" lookAhead="1"/>
+        <DetectChar context="MultiLineStringInterpolarFinal" char="&quot;" lookAhead="1"/>
+      </context>
+      <context attribute="String" lineEndContext="#pop" name="VariableF" fallthroughContext="#pop">
+        <DetectIdentifier attribute="String Interpolation" context="#pop!PrintfString"/>
+      </context>
+      <context attribute="String" lineEndContext="#pop" name="PrintfString" fallthroughContext="#pop">
+        <RegExpr attribute="String Interpolation" context="#stay" String="%((\d+\$)?[-#+ 0,(]*\d*((\.\d+)?[a-hosxA-CEGHSX]|[tT][aAbBcCdDeFhHIjklLmMNpPQrRsSTyYzZ])|[%n])" />
+      </context>
+
+      <context attribute="String" lineEndContext="#pop" name="StringInterpolatorRaw" fallthroughContext="#pop!SingleLineStringInterpolatorRaw">
+        <Detect2Chars attribute="Raw String" context="#pop!MultiLineStringInterpolatorRaw" char="&quot;" char1="&quot;"/>
+      </context>
+      <context attribute="String" lineEndContext="#pop" name="SingleLineStringInterpolatorRaw">
+        <DetectChar context="Interpolation" char="$" lookAhead="1"/>
+        <DetectChar attribute="Raw String" context="#pop" char="&quot;"/>
+      </context>
+      <context attribute="String" lineEndContext="#stay" name="MultiLineStringInterpolatorRaw">
+        <DetectChar context="Interpolation" char="$" lookAhead="1"/>
+        <DetectChar context="MultiLineStringInterpolarRawFinal" char="&quot;" lookAhead="1"/>
+      </context>
+      <context attribute="String" lineEndContext="#stay" name="MultiLineStringInterpolarRawFinal">
+        <StringDetect context="MultiLineStringInterpolarRawNoFinal" String="&quot;&quot;&quot;&quot;" lookAhead="1"/>
+        <StringDetect attribute="Raw String" context="#pop#pop" String="&quot;&quot;&quot;"/>
+        <Detect2Chars attribute="String" context="#pop" char="&quot;" char1="&quot;"/>
+        <DetectChar attribute="String" context="#pop" char="&quot;"/>
+      </context>
+      <context attribute="String" lineEndContext="#stay" name="MultiLineStringInterpolarRawNoFinal">
+        <DetectChar attribute="Raw String" context="#pop" char="&quot;"/>
+      </context>
+
+      <context attribute="Keyword" lineEndContext="#pop" name="SoftKeywordAs" fallthroughContext="#pop">
+        <RegExpr attribute="Keyword" context="#pop" String="[_a-zA-Z][0-9_a-zA-Z]*"/>
+      </context>
+      <context attribute="Keyword" lineEndContext="#pop" name="SoftKeywordDerives" fallthroughContext="#pop">
+        <RegExpr attribute="Keyword" context="#pop" String="[_a-zA-Z][0-9_a-zA-Z]*"/>
+      </context>
+      <context attribute="Keyword" lineEndContext="#pop" name="SoftKeywordEnd" fallthroughContext="#pop">
+        <RegExpr attribute="Keyword" context="#pop" String="[_a-zA-Z][0-9_a-zA-Z]*"/>
+      </context>
+      <context attribute="Keyword" lineEndContext="#pop" name="SoftKeywordErased" fallthroughContext="#pop">
+        <RegExpr attribute="Keyword" context="#pop" String="def|val"/>
+      </context>
+      <context attribute="Keyword" lineEndContext="#pop" name="SoftKeywordExtension" fallthroughContext="#pop">
+        <RegExpr attribute="Keyword" context="#pop" String="\(|\["/>
+      </context>
+      <context attribute="Keyword" lineEndContext="#pop" name="SoftKeywordInfix" fallthroughContext="#pop">
+        <RegExpr attribute="Keyword" context="#pop" String="type"/>
+      </context>
+      <context attribute="Keyword" lineEndContext="#pop" name="SoftKeywordInline" fallthroughContext="#pop">
+        <RegExpr attribute="Keyword" context="#pop" String="def|given|val"/>
+      </context>
+      <context attribute="Keyword" lineEndContext="#pop" name="SoftKeywordOpaque" fallthroughContext="#pop">
+        <StringDetect attribute="Keyword" context="#pop" String="type"/>
+      </context>
+      <context attribute="Keyword" lineEndContext="#pop" name="SoftKeywordOpen" fallthroughContext="#pop">
+        <StringDetect attribute="Keyword" context="#pop" String="class"/>
+      </context>
+      <context attribute="Keyword" lineEndContext="#pop" name="SoftKeywordTransparent" fallthroughContext="#pop">
+        <RegExpr attribute="Keyword" context="#pop" String="(inline[\s]+)?def"/>
+      </context>
+      <context attribute="Keyword" lineEndContext="#pop" name="SoftKeywordUsing" fallthroughContext="#pop">
+        <RegExpr attribute="Keyword" context="#pop" String="[_a-zA-Z][0-9_a-zA-Z]*"/>
+      </context>
+
+      <context attribute="Comment" lineEndContext="#pop" name="CommentSingleLine">
+        <DetectSpaces />
+        <IncludeRules context="##Comments"/>
+      </context>
+      <context attribute="Comment" lineEndContext="#stay" name="CommentMultiline">
+        <Detect2Chars attribute="Comment" context="#pop" char="*" char1="/" endRegion="Comment"/>
+        <Detect2Chars attribute="Comment" context="CommentMultiline" char="/" char1="*" beginRegion="Comment"/>
+        <DetectSpaces />
+        <IncludeRules context="##Comments"/>
+      </context>
+
+    </contexts>
+    <itemDatas>
+      <itemData name="Normal Text"  defStyleNum="dsNormal" spellChecking="false"/>
+      <itemData name="Keyword"      defStyleNum="dsKeyword" spellChecking="false"/>
+      <itemData name="Control Flow" defStyleNum="dsControlFlow" spellChecking="false"/>
+      <itemData name="Annotation"   defStyleNum="dsAttribute" spellChecking="false"/>
+      <itemData name="Function"     defStyleNum="dsFunction" spellChecking="false"/>
+      <itemData name="Data Type"    defStyleNum="dsDataType" spellChecking="false"/>
+      <itemData name="Decimal"      defStyleNum="dsDecVal" spellChecking="false"/>
+      <itemData name="Hex"          defStyleNum="dsBaseN" spellChecking="false"/>
+      <itemData name="Float"        defStyleNum="dsFloat" spellChecking="false"/>
+      <itemData name="Char"         defStyleNum="dsChar" spellChecking="false"/>
+      <itemData name="String"       defStyleNum="dsString"/>
+      <itemData name="String Char"  defStyleNum="dsChar" spellChecking="false"/>
+      <itemData name="Raw String"   defStyleNum="dsVerbatimString"/>
+      <itemData name="String Interpolation" defStyleNum="dsSpecialString"/>
+      <itemData name="Comment"      defStyleNum="dsComment"/>
+      <itemData name="Symbol"       defStyleNum="dsOperator" spellChecking="false"/>
+      <itemData name="Scala2"       defStyleNum="dsBuiltIn"/>
+      <itemData name="Java15"       defStyleNum="dsExtension"/>
+      <itemData name="Error"        defStyleNum="dsError"/>
+    </itemDatas>
+  </highlighting>
+  <general>
+    <comments>
+      <comment name="singleLine" start="//"/>
+      <comment name="multiLine" start="/*" end="*/" region="Comment"/>
+    </comments>
+    <keywords casesensitive="1"/>
+  </general>
+</language>
+<!-- kate: replace-tabs on; tab-width 2; indent-width 2; -->
diff --git a/pandoc/data/templates/scala.xml.txt b/pandoc/data/templates/scala.xml.txt
new file mode 100644
index 000000000000..1143a5ec0159
--- /dev/null
+++ b/pandoc/data/templates/scala.xml.txt
@@ -0,0 +1 @@
+Source: https://github.com/KDE/syntax-highlighting/tree/master/data/syntax
diff --git a/pandoc/data/templates/template.tex b/pandoc/data/templates/template.tex
new file mode 100644
index 000000000000..89523ca8141a
--- /dev/null
+++ b/pandoc/data/templates/template.tex
@@ -0,0 +1,535 @@
+% Options for packages loaded elsewhere
+\PassOptionsToPackage{unicode$for(hyperrefoptions)$,$hyperrefoptions$$endfor$}{hyperref}
+\PassOptionsToPackage{hyphens}{url}
+$if(colorlinks)$
+\PassOptionsToPackage{dvipsnames,svgnames*,x11names*}{xcolor}
+$endif$
+$if(dir)$
+$if(latex-dir-rtl)$
+\PassOptionsToPackage{RTLdocument}{bidi}
+$endif$
+$endif$
+$if(CJKmainfont)$
+\PassOptionsToPackage{space}{xeCJK}
+$endif$
+%
+\documentclass[
+$if(fontsize)$
+  $fontsize$,
+$endif$
+$if(lang)$
+  $babel-lang$,
+$endif$
+$if(papersize)$
+  $papersize$paper,
+$endif$
+$if(beamer)$
+  ignorenonframetext,
+$if(handout)$
+  handout,
+$endif$
+$if(aspectratio)$
+  aspectratio=$aspectratio$,
+$endif$
+$endif$
+$for(classoption)$
+  $classoption$$sep$,
+$endfor$
+]{$documentclass$}
+$if(beamer)$
+$if(background-image)$
+\usebackgroundtemplate{%
+  \includegraphics[width=\paperwidth]{$background-image$}%
+}
+$endif$
+\usepackage{pgfpages}
+\setbeamertemplate{caption}[numbered]
+\setbeamertemplate{caption label separator}{: }
+\setbeamercolor{caption name}{fg=normal text.fg}
+\beamertemplatenavigationsymbols$if(navigation)$$navigation$$else$empty$endif$
+$for(beameroption)$
+\setbeameroption{$beameroption$}
+$endfor$
+% Prevent slide breaks in the middle of a paragraph
+\widowpenalties 1 10000
+\raggedbottom
+$if(section-titles)$
+\setbeamertemplate{part page}{
+  \centering
+  \begin{beamercolorbox}[sep=16pt,center]{part title}
+    \usebeamerfont{part title}\insertpart\par
+  \end{beamercolorbox}
+}
+\setbeamertemplate{section page}{
+  \centering
+  \begin{beamercolorbox}[sep=12pt,center]{part title}
+    \usebeamerfont{section title}\insertsection\par
+  \end{beamercolorbox}
+}
+\setbeamertemplate{subsection page}{
+  \centering
+  \begin{beamercolorbox}[sep=8pt,center]{part title}
+    \usebeamerfont{subsection title}\insertsubsection\par
+  \end{beamercolorbox}
+}
+\AtBeginPart{
+  \frame{\partpage}
+}
+\AtBeginSection{
+  \ifbibliography
+  \else
+    \frame{\sectionpage}
+  \fi
+}
+\AtBeginSubsection{
+  \frame{\subsectionpage}
+}
+$endif$
+$endif$
+$if(beamerarticle)$
+\usepackage{beamerarticle} % needs to be loaded first
+$endif$
+\usepackage{amsmath,amssymb}
+$if(fontfamily)$
+\usepackage[$for(fontfamilyoptions)$$fontfamilyoptions$$sep$,$endfor$]{$fontfamily$}
+$else$
+\usepackage{lmodern}
+$endif$
+$if(linestretch)$
+\usepackage{setspace}
+$endif$
+\usepackage{ifxetex,ifluatex}
+\ifnum 0\ifxetex 1\fi\ifluatex 1\fi=0 % if pdftex
+  \usepackage[$if(fontenc)$$fontenc$$else$T1$endif$]{fontenc}
+  \usepackage[utf8]{inputenc}
+  \usepackage{textcomp} % provide euro and other symbols
+\else % if luatex or xetex
+$if(mathspec)$
+  \ifxetex
+    \usepackage{mathspec}
+  \else
+    \usepackage{unicode-math}
+  \fi
+$else$
+  \usepackage{unicode-math}
+$endif$
+  \defaultfontfeatures{Scale=MatchLowercase}
+  \defaultfontfeatures[\rmfamily]{Ligatures=TeX,Scale=1}
+$if(mainfont)$
+  \setmainfont[$for(mainfontoptions)$$mainfontoptions$$sep$,$endfor$]{$mainfont$}
+$endif$
+$if(sansfont)$
+  \setsansfont[$for(sansfontoptions)$$sansfontoptions$$sep$,$endfor$]{$sansfont$}
+$endif$
+$if(monofont)$
+  \setmonofont[$for(monofontoptions)$$monofontoptions$$sep$,$endfor$]{$monofont$}
+$endif$
+$for(fontfamilies)$
+  \newfontfamily{$fontfamilies.name$}[$for(fontfamilies.options)$$fontfamilies.options$$sep$,$endfor$]{$fontfamilies.font$}
+$endfor$
+$if(mathfont)$
+$if(mathspec)$
+  \ifxetex
+    \setmathfont(Digits,Latin,Greek)[$for(mathfontoptions)$$mathfontoptions$$sep$,$endfor$]{$mathfont$}
+  \else
+    \setmathfont[$for(mathfontoptions)$$mathfontoptions$$sep$,$endfor$]{$mathfont$}
+  \fi
+$else$
+  \setmathfont[$for(mathfontoptions)$$mathfontoptions$$sep$,$endfor$]{$mathfont$}
+$endif$
+$endif$
+$if(CJKmainfont)$
+  \ifxetex
+    \usepackage{xeCJK}
+    \setCJKmainfont[$for(CJKoptions)$$CJKoptions$$sep$,$endfor$]{$CJKmainfont$}
+  \fi
+$endif$
+$if(luatexjapresetoptions)$
+  \ifluatex
+    \usepackage[$for(luatexjapresetoptions)$$luatexjapresetoptions$$sep$,$endfor$]{luatexja-preset}
+  \fi
+$endif$
+$if(CJKmainfont)$
+  \ifluatex
+    \usepackage[$for(luatexjafontspecoptions)$$luatexjafontspecoptions$$sep$,$endfor$]{luatexja-fontspec}
+    \setmainjfont[$for(CJKoptions)$$CJKoptions$$sep$,$endfor$]{$CJKmainfont$}
+  \fi
+$endif$
+\fi
+$if(beamer)$
+$if(theme)$
+\usetheme[$for(themeoptions)$$themeoptions$$sep$,$endfor$]{$theme$}
+$endif$
+$if(colortheme)$
+\usecolortheme{$colortheme$}
+$endif$
+$if(fonttheme)$
+\usefonttheme{$fonttheme$}
+$endif$
+$if(mainfont)$
+\usefonttheme{serif} % use mainfont rather than sansfont for slide text
+$endif$
+$if(innertheme)$
+\useinnertheme{$innertheme$}
+$endif$
+$if(outertheme)$
+\useoutertheme{$outertheme$}
+$endif$
+$endif$
+% Use upquote if available, for straight quotes in verbatim environments
+\IfFileExists{upquote.sty}{\usepackage{upquote}}{}
+\IfFileExists{microtype.sty}{% use microtype if available
+  \usepackage[$for(microtypeoptions)$$microtypeoptions$$sep$,$endfor$]{microtype}
+  \UseMicrotypeSet[protrusion]{basicmath} % disable protrusion for tt fonts
+}{}
+$if(indent)$
+$else$
+\makeatletter
+\@ifundefined{KOMAClassName}{% if non-KOMA class
+  \IfFileExists{parskip.sty}{%
+    \usepackage{parskip}
+  }{% else
+    \setlength{\parindent}{0pt}
+    \setlength{\parskip}{6pt plus 2pt minus 1pt}}
+}{% if KOMA class
+  \KOMAoptions{parskip=half}}
+\makeatother
+$endif$
+$if(verbatim-in-note)$
+\usepackage{fancyvrb}
+$endif$
+\usepackage{tcolorbox}
+\usepackage{xcolor}
+\IfFileExists{xurl.sty}{\usepackage{xurl}}{} % add URL line breaks if available
+\IfFileExists{bookmark.sty}{\usepackage{bookmark}}{\usepackage{hyperref}}
+\hypersetup{
+$if(title-meta)$
+  pdftitle={$title-meta$},
+$endif$
+$if(author-meta)$
+  pdfauthor={$author-meta$},
+$endif$
+$if(lang)$
+  pdflang={$lang$},
+$endif$
+$if(subject)$
+  pdfsubject={$subject$},
+$endif$
+$if(keywords)$
+  pdfkeywords={$for(keywords)$$keywords$$sep$, $endfor$},
+$endif$
+$if(colorlinks)$
+  colorlinks=true,
+  linkcolor=$if(linkcolor)$$linkcolor$$else$Maroon$endif$,
+  filecolor=$if(filecolor)$$filecolor$$else$Maroon$endif$,
+  citecolor=$if(citecolor)$$citecolor$$else$Blue$endif$,
+  urlcolor=$if(urlcolor)$$urlcolor$$else$Blue$endif$,
+$else$
+  hidelinks,
+$endif$
+  pdfcreator={LaTeX via pandoc}}
+\urlstyle{same} % disable monospaced font for URLs
+$if(verbatim-in-note)$
+\VerbatimFootnotes % allow verbatim text in footnotes
+$endif$
+$if(geometry)$
+$if(beamer)$
+\geometry{$for(geometry)$$geometry$$sep$,$endfor$}
+$else$
+\usepackage[$for(geometry)$$geometry$$sep$,$endfor$]{geometry}
+$endif$
+$endif$
+$if(beamer)$
+\newif\ifbibliography
+$endif$
+$if(listings)$
+\usepackage{listings}
+\newcommand{\passthrough}[1]{#1}
+\lstset{defaultdialect=[5.3]Lua}
+\lstset{defaultdialect=[x86masm]Assembler}
+$endif$
+$if(lhs)$
+\lstnewenvironment{code}{\lstset{language=Haskell,basicstyle=\small\ttfamily}}{}
+$endif$
+$if(highlighting-macros)$
+$highlighting-macros$
+$endif$
+$if(tables)$
+\usepackage{longtable,booktabs,array}
+\usepackage{calc} % for calculating minipage widths
+$if(beamer)$
+\usepackage{caption}
+% Make caption package work with longtable
+\makeatletter
+\def\fnum@table{\tablename~\thetable}
+\makeatother
+$else$
+% Correct order of tables after \paragraph or \subparagraph
+\usepackage{etoolbox}
+\makeatletter
+\patchcmd\longtable{\par}{\if@noskipsec\mbox{}\fi\par}{}{}
+\makeatother
+% Allow footnotes in longtable head/foot
+\IfFileExists{footnotehyper.sty}{\usepackage{footnotehyper}}{\usepackage{footnote}}
+\makesavenoteenv{longtable}
+$endif$
+$endif$
+$if(graphics)$
+\usepackage{graphicx}
+\makeatletter
+\def\maxwidth{\ifdim\Gin@nat@width>\linewidth\linewidth\else\Gin@nat@width\fi}
+\def\maxheight{\ifdim\Gin@nat@height>\textheight\textheight\else\Gin@nat@height\fi}
+\makeatother
+% Scale images if necessary, so that they will not overflow the page
+% margins by default, and it is still possible to overwrite the defaults
+% using explicit options in \includegraphics[width, height, ...]{}
+\setkeys{Gin}{width=\maxwidth,height=\maxheight,keepaspectratio}
+% Set default figure placement to htbp
+\makeatletter
+\def\fps@figure{htbp}
+\makeatother
+$endif$
+$if(links-as-notes)$
+% Make links footnotes instead of hotlinks:
+\DeclareRobustCommand{\href}[2]{#2\footnote{\url{#1}}}
+$endif$
+$if(strikeout)$
+\usepackage[normalem]{ulem}
+% Avoid problems with \sout in headers with hyperref
+\pdfstringdefDisableCommands{\renewcommand{\sout}{}}
+$endif$
+\setlength{\emergencystretch}{3em} % prevent overfull lines
+\providecommand{\tightlist}{%
+  \setlength{\itemsep}{0pt}\setlength{\parskip}{0pt}}
+$if(numbersections)$
+\setcounter{secnumdepth}{$if(secnumdepth)$$secnumdepth$$else$5$endif$}
+$else$
+\setcounter{secnumdepth}{-\maxdimen} % remove section numbering
+$endif$
+$if(beamer)$
+$else$
+$if(block-headings)$
+% Make \paragraph and \subparagraph free-standing
+\ifx\paragraph\undefined\else
+  \let\oldparagraph\paragraph
+  \renewcommand{\paragraph}[1]{\oldparagraph{#1}\mbox{}}
+\fi
+\ifx\subparagraph\undefined\else
+  \let\oldsubparagraph\subparagraph
+  \renewcommand{\subparagraph}[1]{\oldsubparagraph{#1}\mbox{}}
+\fi
+$endif$
+$endif$
+$if(pagestyle)$
+\pagestyle{$pagestyle$}
+$endif$
+\usepackage{fancyhdr}
+\pagestyle{fancy}
+\fancyhead[L]{}
+\fancyhead[R]{\nouppercase{\leftmark}}
+% For more options see section 11 in PDF document
+% from https://www.ctan.org/pkg/fancyhdr
+$if(lang)$
+\ifxetex
+  % Load polyglossia as late as possible: uses bidi with RTL langages (e.g. Hebrew, Arabic)
+  \usepackage{polyglossia}
+  \setmainlanguage[$for(polyglossia-lang.options)$$polyglossia-lang.options$$sep$,$endfor$]{$polyglossia-lang.name$}
+$for(polyglossia-otherlangs)$
+  \setotherlanguage[$for(polyglossia-otherlangs.options)$$polyglossia-otherlangs.options$$sep$,$endfor$]{$polyglossia-otherlangs.name$}
+$endfor$
+\else
+  \usepackage[$for(babel-otherlangs)$$babel-otherlangs$,$endfor$main=$babel-lang$]{babel}
+% get rid of language-specific shorthands (see #6817):
+\let\LanguageShortHands\languageshorthands
+\def\languageshorthands#1{}
+$if(babel-newcommands)$
+  $babel-newcommands$
+$endif$
+\fi
+$endif$
+\ifluatex
+  \usepackage{selnolig}  % disable illegal ligatures
+\fi
+$if(dir)$
+\ifxetex
+  % Load bidi as late as possible as it modifies e.g. graphicx
+  \usepackage{bidi}
+\fi
+\ifnum 0\ifxetex 1\fi\ifluatex 1\fi=0 % if pdftex
+  \TeXXeTstate=1
+  \newcommand{\RL}[1]{\beginR #1\endR}
+  \newcommand{\LR}[1]{\beginL #1\endL}
+  \newenvironment{RTL}{\beginR}{\endR}
+  \newenvironment{LTR}{\beginL}{\endL}
+\fi
+$endif$
+$if(natbib)$
+\usepackage[$natbiboptions$]{natbib}
+\bibliographystyle{$if(biblio-style)$$biblio-style$$else$plainnat$endif$}
+$endif$
+$if(biblatex)$
+\usepackage[$if(biblio-style)$style=$biblio-style$,$endif$$for(biblatexoptions)$$biblatexoptions$$sep$,$endfor$]{biblatex}
+$for(bibliography)$
+\addbibresource{$bibliography$}
+$endfor$
+$endif$
+$if(csl-refs)$
+\newlength{\cslhangindent}
+\setlength{\cslhangindent}{1.5em}
+\newlength{\csllabelwidth}
+\setlength{\csllabelwidth}{3em}
+\newenvironment{CSLReferences}[2] % #1 hanging-ident, #2 entry spacing
+ {% don't indent paragraphs
+  \setlength{\parindent}{0pt}
+  % turn on hanging indent if param 1 is 1
+  \ifodd #1 \everypar{\setlength{\hangindent}{\cslhangindent}}\ignorespaces\fi
+  % set entry spacing
+  \ifnum #2 > 0
+  \setlength{\parskip}{#2\baselineskip}
+  \fi
+ }%
+ {}
+\usepackage{calc}
+\newcommand{\CSLBlock}[1]{#1\hfill\break}
+\newcommand{\CSLLeftMargin}[1]{\parbox[t]{\csllabelwidth}{#1}}
+\newcommand{\CSLRightInline}[1]{\parbox[t]{\linewidth - \csllabelwidth}{#1}\break}
+\newcommand{\CSLIndent}[1]{\hspace{\cslhangindent}#1}
+$endif$
+$if(csquotes)$
+\usepackage{csquotes}
+$endif$
+
+$if(title)$
+\title{$title$$if(thanks)$\thanks{$thanks$}$endif$}
+$endif$
+$if(subtitle)$
+$if(beamer)$
+$else$
+\usepackage{etoolbox}
+\makeatletter
+\providecommand{\subtitle}[1]{% add subtitle to \maketitle
+  \apptocmd{\@title}{\par {\large #1 \par}}{}{}
+}
+\makeatother
+$endif$
+\subtitle{$subtitle$}
+$endif$
+\author{$for(author)$$author$$sep$ \and $endfor$}
+\date{$date$}
+$if(beamer)$
+$if(institute)$
+\institute{$for(institute)$$institute$$sep$ \and $endfor$}
+$endif$
+$if(titlegraphic)$
+\titlegraphic{\includegraphics{$titlegraphic$}}
+$endif$
+$if(logo)$
+\logo{\includegraphics{$logo$}}
+$endif$
+$endif$
+
+\begin{document}
+$if(has-frontmatter)$
+\frontmatter
+$endif$
+$if(title)$
+$if(beamer)$
+\frame{\titlepage}
+$else$
+\maketitle
+$endif$
+$if(titlegraphic)$
+\begin{figure}
+\centering{\includegraphics[width=2.4cm]{$titlegraphic$}}
+\end{figure}
+$endif$
+$if(abstract)$
+$if(abstract-title)$
+\renewcommand\abstractname{}
+$endif$
+\begin{abstract}
+\centering\footnotesize
+\tcbox{$abstract$}
+\newpage
+\end{abstract}
+$endif$
+$endif$
+
+$for(include-before)$
+$include-before$
+
+$endfor$
+$if(toc)$
+$if(toc-title)$
+\renewcommand*\contentsname{$toc-title$}
+$endif$
+$if(beamer)$
+\begin{frame}[allowframebreaks]
+$if(toc-title)$
+  \frametitle{$toc-title$}
+$endif$
+  \tableofcontents[hideallsubsections]
+\end{frame}
+$else$
+{
+$if(colorlinks)$
+\hypersetup{linkcolor=$if(toccolor)$$toccolor$$else$$endif$}
+$endif$
+\setcounter{tocdepth}{$toc-depth$}
+\tableofcontents
+}
+$endif$
+$endif$
+$if(lot)$
+\listoftables
+$endif$
+$if(lof)$
+\listoffigures
+$endif$
+$if(linestretch)$
+\setstretch{$linestretch$}
+$endif$
+$if(has-frontmatter)$
+\mainmatter
+$endif$
+$body$
+
+$if(has-frontmatter)$
+\backmatter
+$endif$
+$if(natbib)$
+$if(bibliography)$
+$if(biblio-title)$
+$if(has-chapters)$
+\renewcommand\bibname{$biblio-title$}
+$else$
+\renewcommand\refname{$biblio-title$}
+$endif$
+$endif$
+$if(beamer)$
+\begin{frame}[allowframebreaks]{$biblio-title$}
+  \bibliographytrue
+$endif$
+  \bibliography{$for(bibliography)$$bibliography$$sep$,$endfor$}
+$if(beamer)$
+\end{frame}
+$endif$
+
+$endif$
+$endif$
+$if(biblatex)$
+$if(beamer)$
+\begin{frame}[allowframebreaks]{$biblio-title$}
+  \bibliographytrue
+  \printbibliography[heading=none]
+\end{frame}
+$else$
+\printbibliography$if(biblio-title)$[title=$biblio-title$]$endif$
+$endif$
+
+$endif$
+$for(include-after)$
+$include-after$
+
+$endfor$
+\end{document}
diff --git a/pandoc/data/usage.md b/pandoc/data/usage.md
new file mode 100644
index 000000000000..5ddd0595c985
--- /dev/null
+++ b/pandoc/data/usage.md
@@ -0,0 +1,73 @@
+---
+layout: doc-page
+title: "Scala 3 User's Manual"
+titlegraphic: ../out/pandoc/images/scala-spiral.png
+author: Martin Odersky et al.
+abstract-title: WILL_BE_IGNORED
+abstract: |
+  Latest HTML version available at
+  [`https://dotty.epfl.ch/docs/usage/`](https://dotty.epfl.ch/docs/usage/getting-started.html)
+---
+
+\newpage
+# Getting Started: Users [![](../out/pandoc/images/external.png){width=64px}](https://dotty.epfl.ch/docs/usage/getting-started.html) {#getting-started}
+```{.include}
+../out/pandoc/src_managed/usage/getting-started.md
+```
+
+# Using Dotty with sbt [![](../out/pandoc/images/external.png){width=64px}](https://dotty.epfl.ch/docs/usage/sbt-projects.html) {#sbt-projects}
+```{.include}
+../out/pandoc/src_managed/usage/sbt-projects.md
+```
+
+# IDE support for Dotty [![](../out/pandoc/images/external.png){width=64px}](https://dotty.epfl.ch/docs/usage/ide-support.html) {#ide-support.md}
+```{.include}
+../out/pandoc/src_managed/usage/ide-support.md
+```
+
+# Worksheet mode with Dotty IDE [![](../out/pandoc/images/external.png){width=64px}](https://dotty.epfl.ch/docs/usage/worksheet-mode.html) {#worksheet-mode}
+```{.include}
+../out/pandoc/src_managed/usage/worksheet-mode.md
+```
+
+# Language Versions [![](../out/pandoc/images/external.png){width=64px}](https://dotty.epfl.ch/docs/usage/language-versions.html) {#language-versions}
+```{.include}
+../out/pandoc/src_managed/usage/language-versions.md
+```
+
+# Using Dotty with cbt [![](../out/pandoc/images/external.png){width=64px}](https://dotty.epfl.ch/docs/usage/cbt-projects.html) {#cbt-projects}
+```{.include}
+../out/pandoc/src_managed/usage/cbt-projects.md
+```
+
+\newpage
+# Scaladoc [![](../out/pandoc/images/external.png){width=64px}](https://dotty.epfl.ch/docs/usage/scaladoc/index.html) {#index}
+```{.include}
+../out/pandoc/src_managed/usage/scaladoc/index.md
+```
+
+# API Documentation [![](../out/pandoc/images/external.png){width=64px}](https://dotty.epfl.ch/docs/usage/scaladoc/docComments.html) {#docComments}
+```{.include}
+../out/pandoc/src_managed/usage/scaladoc/docComments.md
+```
+
+# Built-in blog [![](../out/pandoc/images/external.png){width=64px}](https://dotty.epfl.ch/docs/usage/scaladoc/blog.html) {#blog}
+```{.include}
+../out/pandoc/src_managed/usage/scaladoc/blog.md
+```
+
+# Scaladoc-specific Tags and Features [![](../out/pandoc/images/external.png){width=64px}](https://dotty.epfl.ch/docs/usage/scaladoc/specificTags.html) {#specificTags}
+```{.include}
+../out/pandoc/src_managed/usage/scaladoc/specificTags.md
+```
+
+# Static documentation [![](../out/pandoc/images/external.png){width=64px}](https://dotty.epfl.ch/docs/usage/scaladoc/staticSite.html) {#staticSite}
+```{.include}
+../out/pandoc/src_managed/usage/scaladoc/staticSite.md
+```
+
+\newpage
+# Dottydoc [Legacy] [![](../out/pandoc/images/external.png){width=64px}](https://dotty.epfl.ch/docs/usage/dottydoc.html) {#dottydoc}
+```{.include}
+../out/pandoc/src_managed/usage/dottydoc.md
+```
diff --git a/pandoc/docs/DOCKER.md b/pandoc/docs/DOCKER.md
new file mode 100644
index 000000000000..ecaab315e61b
--- /dev/null
+++ b/pandoc/docs/DOCKER.md
@@ -0,0 +1,98 @@
+# <span id="top">More about Docker</span> <span style="size:25%;"><a href="../README.md" title="Back to README">↩</a></span>
+<!-- created by mics (https://github.com/michelou/) on December 2020 -->
+
+Command [`docker image inspect`][docker_inspect] helps us to get information out of the [`pandoc/ubuntu-latex`][docker_pandoc] image, e.g. to know the values of the [`ENV`][docker_env] and [`ENTRYPOINT`][docker_entrypoint] instructions :
+
+<pre style="font-size:80%; max-width:680px;">
+<b>&gt; <a href="https://docs.docker.com/engine/reference/commandline/image_inspect/">docker image inspect</a> --format "{{.Config.<b style="color:darkred;">Env</b>}}" pandoc/ubuntu-latex:2.11.4</b>
+[PATH=/opt/texlive/texdir/bin/x86_64-linux:/usr/local/sbin:/usr/local/bin:/usr/sbin:/usr/bin:/sbin:/bin]
+&nbsp;
+<b>&gt; <a href="https://docs.docker.com/engine/reference/commandline/image_inspect/">docker image inspect</a> --format "{{.Config.<b style="color:darkred;">Entrypoint</b>}}" pandoc/ubuntu-latex:2.11.4</b>
+[/usr/local/bin/pandoc]
+</pre>
+
+Let us now check that both commands [`pandoc`][pandoc_command] and [`lualatex`][lualatex] are available in the running container :
+
+<pre style="font-size:80%; max-width:680px;">
+<b>&gt; <a href="https://docs.docker.com/engine/reference/commandline/run/">docker run</a> --rm --entrypoint lualatex pandoc/ubuntu-latex:2.11.4 --version | findstr Version</b>
+This is LuaHBTeX, Version 1.12.0 (TeX Live 2020)
+&nbsp;
+<b>&gt; <a href="https://docs.docker.com/engine/reference/commandline/run/">docker run</a> --rm --entrypoint which pandoc/ubuntu-latex:2.11.4 lualatex</b>
+/opt/texlive/texdir/bin/x86_64-linux/lualatex
+&nbsp;
+<b>&gt; <a href="https://docs.docker.com/engine/reference/commandline/run/">docker run</a> --rm pandoc/ubuntu-latex:2.11.4 --version | findstr /b pandoc</b>
+pandoc 2.11.4
+</pre>
+
+> **:mag_right:** We note with pleasure that tool versions are identical for MS Windows 10, Ubuntu 18.04 and the Docker image [`pandoc/ubuntu-latex`][docker_pandoc].
+
+<!-- 
+https://www.howtoinstall.me/ubuntu/18-04/xz-utils/
+-->
+
+At this point we face the same situation as in the previous environments where some fonts were missing.
+
+We create a [`Dockerfile`](../Dockerfile) document which adds a layer with our additions on top on the [`pandoc/ubuntu-latex`][docker_pandoc] image. We reproduce below a simplified version :
+
+<pre style="font-size:80%; max-width:600px;">
+<a href="https://docs.docker.com/engine/reference/builder/#from"><b>FROM</b></a> <a href="https://hub.docker.com/r/pandoc/ubuntu-latex">pandoc/ubuntu-latex:2.11.4</a>
+<a href="https://docs.docker.com/engine/reference/builder/#workdir"><b>WORKDIR</b></a> /app
+<a href="https://docs.docker.com/engine/reference/builder/#copy"><b>COPY</b></a> ./data ./data
+<a href="https://docs.docker.com/engine/reference/builder/#copy"><b>COPY</b></a> ./src ./src
+<a href="https://docs.docker.com/engine/reference/builder/#copy"><b>COPY</b></a> <a href="../md2pdf">./md2pdf</a> .
+[...]
+<a href="https://docs.docker.com/engine/reference/builder/#env"><b>ENV</b></a> <span style="color:darkred;">TEXLIVE_HOME</span>=/opt/texlive/texdir
+<a href="https://docs.docker.com/engine/reference/builder/#run"><b>RUN</b></a> echo "#!/bin/bash \n <a href="../md2pdf">./md2pdf</a>" > ./entrypoint.sh
+<a href="https://docs.docker.com/engine/reference/builder/#run"><b>RUN</b></a> chmod +x ./entrypoint.sh
+<a href="https://docs.docker.com/engine/reference/builder/#entrypoint" title="ENTRYPOINT instruction"><b>ENTRYPOINT</b></a> ["./entrypoint.sh"]
+</pre>
+
+Command [`docker images`][docker_images] displays the repository name, the tag name and the size of both images :
+
+<pre style="font-size:80%; max-width:600px;">
+<b>&gt; <a href="https://docs.docker.com/engine/reference/commandline/images/">docker images</a></b>
+REPOSITORY               TAG         IMAGE ID       CREATED          SIZE
+scala3/md2pdf            1.0         ec4bc8c273cd   19 minutes ago   861MB
+pandoc/ubuntu-latex      2.11.4      fa20b6e6dfe6   5 days ago       799MB
+</pre>
+
+Finally, we can save both images as archive files with command [`docker save`][docker_save] (and [`gzip`][linux_gzip] for compression) :
+
+<pre style="font-size:80%; max-width:600px;">
+<b>&gt; <a href="https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/dir">dir</a> target\*tar* | <a href="https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/findstr">findstr</a> /b [0-9]</b>
+29.01.2021  23:34       813 513 216 pandoc_ubuntu-latex-2.11.4.tar
+29.01.2021  23:34       254 725 746 pandoc_ubuntu-latex-2.11.4.tar.gz
+29.01.2021  23:31       876 669 952 scala3_md2pdf-1.0.tar
+29.01.2021  23:31       283 584 449 scala3_md2pdf-1.0.tar.gz
+</pre>
+
+<!--
+## <span id="footnotes">Footnotes</span>
+
+<b name="footnote_01">[1]</b> ***Pandoc software*** [↩](#anchor_01)
+
+<p style="margin:0 0 1em 20px;">
+ (version: 2.11.3.2, compressed size: 240.96 MB)
+</p>
+-->
+***
+
+*[mics](https://github.com/michelou/)/January 2022* [**&#9650;**](#top "Back to top")
+<span id="bottom">&nbsp;</span>
+
+[docker_entrypoint]: https://docs.docker.com/engine/reference/builder/#entrypoint "ENTRYPOINT instruction"
+[docker_env]: https://docs.docker.com/engine/reference/builder/#env
+[docker_hub]: https://hub.docker.com/
+[docker_images]: https://docs.docker.com/engine/reference/commandline/images/
+[docker_inspect]: https://docs.docker.com/engine/reference/commandline/image_inspect/ "Display detailed information on one or more images"
+[docker_pandoc]: https://hub.docker.com/r/pandoc/ubuntu-latex "Ubuntu based image"
+[docker_save]: https://docs.docker.com/engine/reference/commandline/save/
+[linux_gzip]: https://linux.die.net/man/1/gzip
+[lualatex]: http://www.luatex.org/
+[pandoc_command]: https://pandoc.org/MANUAL.html/ "Pandoc command line tool"
+[tex_live]: https://tug.org/texlive/
+[tex_live_repository]: https://github.com/TeX-Live/installer "TeX Live installer repository"
+[tex_live_install]: https://tug.org/texlive/doc/install-tl.html "TeX Live cross-platform installer"
+[tex_live_setup]: https://tug.org/texlive/acquire-netinstall.html
+[tex_live_tug]: https://tug.org/ "TeX Users Group website"
+[xelatex]: https://sourceforge.net/projects/xetex/
diff --git a/pandoc/docs/EXAMPLES.md b/pandoc/docs/EXAMPLES.md
new file mode 100644
index 000000000000..d12f135f716c
--- /dev/null
+++ b/pandoc/docs/EXAMPLES.md
@@ -0,0 +1,106 @@
+# <span id="top">Usage examples</span> <span style="size:25%;"><a href="../README.md" title="Back to README">↩</a></span>
+<!-- created by mics (https://github.com/michelou/) on December 2020 -->
+
+In the following we illustrate the usage of the two scripts listed in document [`PROJECT.md`](./PROJECT.md "More about the Pandoc project").
+
+### <span id="bash">Bash Shell</span>
+
+This section presents examples in a Unix-like environment, e.g. [MSYS2] or [Ubuntu].
+
+> **:mag_right:** For the sake of simplicity we assume that the following variables are defined in the execution environment :
+> <pre style="max-width:585px;">
+> <b>export</b> <b style="color:darkred;">PANDOC_HOME</b>=/opt/pandoc    (<i>symlink</i> pandoc <b>-></b> pandoc-2.16.2)
+> <b>export</b> <b style="color:darkred;">TEXLIVE_HOME</b>=/opt/texlive/2020
+> </pre>
+> or in a <a href="https://www.msys2.org/">MSYS2</a> environment :
+> <pre style="max-width:585px;">
+> $ <b>export</b> <b style="color:darkred;">GIT_HOME</b>=/c/opt/Git-2.34.1/
+> $ <b>export</b> <b style="color:darkred;">PANDOC_HOME</b>=/c/opt/pandoc-2.16.2/
+> $ <b>export</b> <b style="color:darkred;">TEXLIVE_HOME</b>=/c/opt/texlive/2021/
+> </pre>
+
+Command [`./build`](../build) generates the PDF file `scala3_reference.pdf` :
+
+<pre style="max-width:600px;">
+<b>pandoc$ ./<a href="../build">build</a></b>
+Elapsed time: 59 seconds
+&nbsp;
+<b>pandoc$ <a href="https://man7.org/linux/man-pages/man1/ls.1.html">ls</a> ../out/pandoc</b>
+images  scala3_reference.pdf  src_managed
+</pre>
+
+With `DEBUG=1` we execute [`md2pdf`](../md2pdf) in debug mode :
+
+<pre>
+<b>pandoc$ DEBUG=1 ./<a href="../md2pdf">md2pdf</a></b>
+Copy image files to directory "/tmp/dotty/out/pandoc/images"
+Preprocess file "/tmp/dotty/docs/docs/reference/changed-features/compiler-plugins.md"
+[...]
+Preprocess file "/tmp/dotty/docs/docs/reference/syntax.md"
+/opt/pandoc/bin/pandoc <b style="color:darkred;">--data-dir</b>=/tmp/dotty/pandoc/data <b style="color:darkred;">--defaults</b>=/tmp/dotty/pandoc/data/defaults.yaml <b style="color:darkred;">--syntax-definition</b>=/tmp/dotty/pandoc/data/templates/scala.xml -V geometry=a4paper -V geometry:margin=30mm -V mainfont:FreeSerif.ttf -V fontsize=12pt -V urlcolor=blue -V linkcolor=[HTML]{66001E} -V subtitle='Internal Draft (rev 82a8762c24)' -V date='2 January 2021' <b style="color:darkred;">--template</b>=/tmp/dotty/pandoc/data/templates/template.tex <b style="color:darkred;">--pdf-engine</b>=/opt/texlive/2021//bin/x86_64-linux/lualatex <b style="color:darkred;">--output</b>=/tmp/dotty/out/pandoc/scala3_reference.pdf /tmp/dotty/pandoc/data/reference.md
+&nbsp;
+<b>pandoc$ <a href="https://man7.org/linux/man-pages/man1/ls.1.html">ls</a> ../out/pandoc/</b>
+images  scala3_reference.pdf  src_managed
+</pre>
+
+> **:mag_right:** The preprocessing step converts cross-reference between [Markdown] documents into [named anchors][named_anchor]. The transformed files are stored into the output directory `../out/pandoc/src_managed/` and are then passed to [`pandoc`][pandoc_cmd].
+
+### <span id="windows">Windows Command Prompt</span>  <sup style="font-size:60%;">[**&#9650;**](#top "Back to top")</sup>
+
+This section presents examples in a MS Windows environment, e.g. [MS Windows 10 Pro][win_10_pro].
+
+> **:mag_right:** For the sake of simplicity we assume that the following environment variables are defined :
+> <pre style="max-width:585px;">
+> <b>set</b> <b style="color:darkred;">GIT_HOME</b>=C:\opt\Git-2.34.1
+> <b>set</b> <b style="color:darkred;">PANDOC_HOME</b>=C:\opt\pandoc-2.16.2
+> <b>set</b> <b style="color:darkred;">TEXLIVE_HOME</b>=C:\opt\texlive\2021
+> </pre>
+
+Command [`build.bat`](../build.bat) generates the PDF file `scala3_reference.pdf`; with option `-timer` it prints the elapsed time and with option `-verbose` it also prints progress messages :
+
+<pre style="max-width:600px;">
+<b>pandoc&gt; <a href="../build.bat">build</a> -timer -verbose clean compile</b>
+Delete directory "W:\scala3-pandoc\out\pandoc"
+md2pdf.bat "reference"
+Total elapsed time: 00:01:17
+&nbsp;
+<b>pandoc&gt; <a href="https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/dir">dir</a> /b ..\out\pandoc</b>
+images
+scala3_reference.pdf
+src_managed
+</pre>
+
+> **:mag_right:** Use the command [`build help`](../build) (resp. [`build.bat help`](../build.bat)) to display the available options/subcommands.
+
+We can specify option `-project:internals` to produce the output file `scala3_internals.pdf` :
+
+<pre style="max-width:640px;">
+<b>pandoc&gt; <a href="../build.bat">build</a> -timer -debug -project:internals clean compile</b>
+[build] Options    : _TIMER=1 _VERBOSE=0
+[build] Subcommands: _CLEAN=1 _COMPILE=1 _RUN=0
+[build] Variables  : <b style="color:darkred;">PANDOC_HOME</b>=c:\opt\pandoc-2.16.2
+[build] Variables  : <b style="color:darkred;">TEXLIVE_HOME</b>=c:\opt\texlive\2021
+[build] Variables  : _PROJECT_NAME=internals
+[build] rmdir /s /q "W:\scala3-pandoc\out\pandoc"
+[build] "W:\scala3-pandoc\pandoc\md2pdf.bat" "internals"
+Total elapsed time: 00:00:38
+[build] _EXITCODE=0
+&nbsp;
+<b>pandoc&gt; ls -l ..\out\pandoc | sed "s/%USERNAME%//"</b>
+total 188
+drwxr-xr-x 1  197121      0 Jan 30 19:29 images
+-rw-r--r-- 1  197121 185157 Jan 30 19:30 scala3_internals.pdf
+drwxr-xr-x 1  197121      0 Jan 30 19:29 src_managed
+</pre>
+
+***
+
+*[mics](https://github.com/michelou/)/January 2022* [**&#9650;**](#top "Back to top")
+<span id="bottom">&nbsp;</span>
+
+[markdown]: https://commonmark.org/
+[msys2]: https://www.msys2.org/
+[named_anchor]: https://stackoverflow.com/questions/5319754/cross-reference-named-anchor-in-markdown
+[pandoc_cmd]: https://pandoc.org/MANUAL.html
+[ubuntu]: https://ubuntu.com/desktop
+[win_10_pro]: https://www.microsoft.com/en-us/windows/compare-windows-10-home-vs-pro
diff --git a/pandoc/docs/PANDOC.md b/pandoc/docs/PANDOC.md
new file mode 100644
index 000000000000..918afae058b0
--- /dev/null
+++ b/pandoc/docs/PANDOC.md
@@ -0,0 +1,71 @@
+# <span id="top">More about Pandoc</span> <span style="size:25%;"><a href="../README.md" title="Back to README">↩</a></span>
+<!-- created by mics (https://github.com/michelou/) on December 2020 -->
+
+The [Pandoc] software is free and available on Linux, MacOS and MS Windows.
+
+The setup of [Pandoc] in the different environments is straightforward :
+- *MS Windows*: we download archive [`pandoc-2.16.<X>-windows-x86_64.zip`][pandoc_downloads] and extract its contents into directory `C:\opt\pandoc-2.16.<X>`.
+- *Ubuntu* : we download archive [`pandoc-2.16.<X>-linux-amd64.tar.gz`][pandoc_downloads], extract its contents into directory `/opt/pandoc-2.16.<X>/` and create a symbolic link `/opt/pandoc -> /opt/pandoc-2.16.<X>`.
+- *Docker* : we use [`pandoc/ubuntu-latex`][docker_pandoc], a Ubuntu based image which bundles [TeX Live][tex_live] and [Pandoc] and is available from the [Docker Hub][docker_hub].
+  > See document [`DOCKER.md`](./DOCKER.md) for further information, e.g. `Dockerfile` usage.
+
+
+The [`md2pdf`](../md2pdf) script (resp. [`md2pdf.bat`](../md2pdf.bat)) executes the [Pandoc](https://pandoc.org/) command line tool with the desired options :
+
+<table style="max-width:720px;">
+<tr>
+  <td><code>--data-dir="$DATA_DIR"</code></td>
+  <td>User data directory, e.g. <a href="../data/"><code>data/</code></a>.</td>
+</tr>
+<tr>
+  <td><code>--defaults="$DEFAULTS_FILE"</code></td>
+  <td>Defaults file, e.g. <a href="../data/defaults.yaml"><code>data/defaults.yaml</code></a></td>
+</tr>
+<tr>
+  <td><code>--syntax-definition="$YNTAX_FILE"</code></td>
+  <td>Syntax file, e.g. <a href="../data/templates/scala.xml"><code>data/templates/scala.xml</code></a></td>
+</tr>
+<tr>
+  <td><i><code>&lt;more_options&gt;</code></i> <sup id="anchor_01"><a href="#footnote_01">[1]</a></sup></td>
+  <td>further options, like variable definitions</td>
+</tr>
+<tr>
+  <td><code>--template="$TEMPLATE_FILE"</code></td>
+  <td>Template file, e.g. <a href="../data/templates/template.tex"><code>data/templates/template.tex</code></a></td>
+</tr>
+<tr>
+  <td><code>--pdf-engine="$LATEX_CMD"</code> <sup id="anchor_02"><a href="#footnote_02">[2]</a></sup></td>
+  <td>LaTeX command, e.g. <a href="http://www.luatex.org/"><code>lualatex</code></a> or <code>xelatex</code></td>
+</tr>
+<tr>
+  <td><code>--output="$OUTPUT_FILE"</code></td>
+  <td>Output file, e.g. <code>target/scala3_reference.pdf</code></td>
+</tr>
+</table>
+
+## <span id="footnotes">Footnotes</span>
+
+<span id="footnote_01">[1]</span> ***Pandoc options*** [↩](#anchor_01)
+
+<dl><dd>
+Several Pandoc options can be specified either on the command line or in a defaults file (e.g. <a href="../data/defaults.yaml"><code>data/defaults.yaml</code></a>); changes to the current settings should be made very carefully.
+</dd></dl>
+
+<span id="footnote_02">[2]</span> ***PDF engines*** [↩](#anchor_02)
+
+<dl><dd>
+In this project we use either <a href="http://www.luatex.org/"><code>lualatex</code></a> or <code>xelatex</code> as PDF engines since they both support UTF-8 encoded Markdown documents, unlike <a href="https://linux.die.net/man/1/pdflatex"><code>pdflatex</code></a> (see also the article <a href="https://www.overleaf.com/learn/latex/Choosing%20a%20LaTeX%20Compiler">Choosing a LaTeX Compiler</a>).<br/>We successfully tested them in several environments, namely MS Windows 10, <a href="https://www.msys2.org/">MSYS2</a>, Ubuntu 18.04 (Bionic) and Docker (TeX Live based image).
+</dd></dl>
+
+***
+
+*[mics](https://github.com/michelou/)/January 2022* [**&#9650;**](#top "Back to top")
+<span id="bottom">&nbsp;</span>
+
+[docker_entrypoint]: https://docs.docker.com/engine/reference/builder/#entrypoint "ENTRYPOINT instruction"
+[docker_env]: https://docs.docker.com/engine/reference/builder/#env
+[docker_hub]: https://hub.docker.com/
+[docker_pandoc]: https://hub.docker.com/r/pandoc/ubuntu-latex
+[pandoc]: https://pandoc.org/ "A universal document converter"
+[pandoc_downloads]: https://github.com/jgm/pandoc/releases/
+[tex_live]: https://tug.org/texlive/
diff --git a/pandoc/docs/PROJECT.md b/pandoc/docs/PROJECT.md
new file mode 100644
index 000000000000..13fd337eef02
--- /dev/null
+++ b/pandoc/docs/PROJECT.md
@@ -0,0 +1,117 @@
+# <span id="top">More about the project</span> <span style="size:25%;"><a href="../README.md" title="Back to README">↩</a></span>
+<!-- created by mics (https://github.com/michelou/) on December 2020 -->
+
+The `pandoc/` directory is organized as follows:
+
+<table>
+
+</tr>
+<tr>
+  <td><a href="../build"><code>build</code></a></td>
+  <td><a href="https://linuxconfig.org/bash-scripting-tutorial">Bash script</a> for MacOS and Unix-like environments (e.g. <a href="https://ubuntu.com/">Ubuntu</a>, <a href="https://www.cygwin.com/">Cygwin</a>, <a href="https://www.msys2.org/">MSYS2</a>).<br/>
+  <a href="../build"><code>build</code></a> provides user-friendly facilities (e.g. removal of output directory) besides calling <a href="../md2pdf"><code>md2pdf</code></a> (see also <a href="EXAMPLES.md"><code>EXAMPLES.md</code></a>).</td>
+</tr>
+<tr>
+  <td><a href="../build.bat"><code>build.bat</code></a></td>
+  <td><a href="https://en.wikibooks.org/wiki/Windows_Batch_Scripting">Batch file</a> for the MS Windows environment.<br/>
+  <a href="../build.bat"><code>build.bat</code></a> provides user-friendly facilities (e.g. removal of the output directory) besides calling <a href="../md2pdf.bat"><code>md2pdf.bat</code></a> (see also <a href="EXAMPLES.md"><code>EXAMPLES.md</code></a>).</td>
+</tr>
+<tr>
+  <td><a href="../md2pdf"><code>md2pdf</code></a></td>
+  <td><a href="https://linuxconfig.org/bash-scripting-tutorial">Bash script</a> for Unix automated tasks (e.g. <a href="https://linuxconfig.org/using-cron-scheduler-on-linux-systems">cron</a>, <a href="https://docs.github.com/en/free-pro-team@latest/actions/learn-github-actions/introduction-to-github-actions">GitHub Actions</a>).<br/>
+  <a href="../md2pdf"><code>md2pdf</code></a> executes the <a href="https://pandoc.org/MANUAL.html">Pandoc</a> command line tool with the appropriate settings.</td>
+</tr>
+<tr>
+  <td><a href="../md2pdf.bat"><code>md2pdf.bat</code></a></td>
+  <td><a href="https://en.wikibooks.org/wiki/Windows_Batch_Scripting">Batch file</a> for MS Windows automated tasks (e.g. <a href="https://docs.microsoft.com/en-us/windows/win32/taskschd/task-scheduler-start-page">Task Scheduler</a>, <a href="https://docs.github.com/en/free-pro-team@latest/actions/learn-github-actions/introduction-to-github-actions">GitHub Actions</a>).<br/><a href="../md2pdf.bat"><code>md2pdf.bat</code></a> executes the <a href="https://pandoc.org/MANUAL.html">Pandoc</a> command line tool with the appropriate settings.</td>
+</tr>
+<tr>
+<td><a href="../.dockerignore"><code>.dockerignore</code></a></td>
+<td>Directories/files to be ignored in the root directory of the Docker context (see also section <a href="https://docs.docker.com/engine/reference/builder/#dockerignore-file">"<code>.dockerignore</code> file"</a> in the Docker documentation).</td>
+</tr>
+<tr>
+<td><a href="../Dockerfile"><code>Dockerfile</code></a></td>
+<td>Text file to assemble an image for running <a href="../md2pdf"><code>md2pdf</code></a> on Docker.</td>
+</tr>
+<tr style="background-color:#eeeeee;">
+  <td><i><code>data/</code></i></td>
+  <td>contains master Markdown files for projects <a href="https://github.com/lampepfl/dotty/tree/master/docs/docs/internals"><code>internals</code></a>, <a href="https://github.com/lampepfl/dotty/tree/master/docs/docs/reference"><code>reference</code></a> and <a href="https://github.com/lampepfl/dotty/tree/master/docs/docs/usage"><code>usage</code></a>.</td>
+</tr>
+<tr>
+  <td>&emsp;<a href="../data/defaults.yaml"><code>defaults.yaml</code></a></td>
+  <td>YAML file defining <a href="https://pandoc.org/MANUAL.html#default-files">default Pandoc options</a>, including filters, e.g. <a href="../data/filters/include-files.lua"><code>include-file.lua</code></a>.</td>
+</tr>
+<tr>
+  <td>&emsp;<a href="../data/internals.md"><code>internals.md</code></a></td>
+  <td>Markdown file defining structure of the <a href="https://dotty.epfl.ch/docs/internals/backend.html"><i>Scala 3 Internals</i></a> documentation.</td>
+</tr>
+<tr>
+  <td>&emsp;<a href="../data/reference.md"><code>reference.md</code></a></td>
+  <td>Markdown file defining the structure of the <a href="https://dotty.epfl.ch/docs/reference/overview.html"><i>Scala 3 Reference</i></a> documentation.</td>
+</tr>
+<tr>
+  <td>&emsp;<a href="../data/usage.md"><code>usage.md</code></a></td>
+  <td>Markdown file defining the structure of the <a href="https://dotty.epfl.ch/docs/usage/getting-started.html"><i>Scala 3 Usage</i></a> documentation.</td>
+</tr>
+<tr style="background-color:#eeeeee;">
+  <td><i><code>data/filters/</code></i> <sup id="anchor_01"><a href="#footnote_01">[1]</a></sup></td>
+  <td>contains the <a href="https://pandoc.org/filters.html">Pandoc filters</a></td>
+</tr>
+<tr>
+  <td style="min-width:170px;">&emsp;<a href="../data/filters/include-files.lua"><code>include-file.lua</code></a></td>
+  <td><a href="https://pandoc.org/lua-filters.html">Lua filter</a> to include other Markdown files into the <i>master</i> document.</td>
+</tr>
+<tr style="background-color:#eeeeee;">
+  <td><i><code>data/images/</code></i></td>
+  <td>contains image files referenced in the Markdown files.</td>
+</tr>
+<tr>
+  <td>&emsp;<a href="../data/images/external.png"><code>external.png</code></a></td>
+  <td>PNG image file used to refer to the sibling online HTML page (image source listed in <a href="../data/images/external.txt"><code>external.txt</code></a>).</td>
+</tr>
+<tr>
+  <td>&emsp;<a href="../data/images/scala-spiral.png"><code>scala-spiral.png</code></a></td>
+  <td>PNG image file to be added on the title page</td>
+</tr>
+<tr style="background-color:#eeeeee;">
+  <td><i><code>data/templates/</code></i></td>
+  <td>contains syntax and template files</td>
+</tr>
+<tr>
+  <td>&emsp;<a href="../data/templates/scala.xml"><code>scala.xml</code></a> <sup id="anchor_02"><a href="#footnote_02">[2]</a></sup></td>
+  <td><a href="https://kate-editor.org/syntax/">Kate</a> syntax file defining the highlighting rules for the <a href="http://dotty.epfl.ch/docs/reference/syntax.html"><i>Scala 3 language</i></a>.</td>
+</tr>
+<tr>
+  <td>&emsp;<a href="../data/templates/template.tex"><code>template.tex</code></a> <sup id="anchor_03"><a href="#footnote_03">[3]</a></sup></td>
+  <td><a href="https://pandoc.org/MANUAL.html#templates">Pandoc template</a> file defining the layout of the generated PDF file.</td>
+</tr>
+<tr>
+</table>
+
+## <span id="footnotes">Footnotes</span>
+
+<span id="footnote_01">[1]</span> ***Pandoc filters*** [↩](#anchor_01)
+
+<dl><dd>
+<a href="https://pandoc.org/filters.html">Pandoc filters</a> can be written in any programming language (<a href="<a href="https://pandoc.org/lua-filters.html">Lua</a>, <a href="https://metacpan.org/pod/Pandoc::Filter">Perl</a>, <a href="https://github.com/vinai/pandocfilters-php">PHP</a>, <a href="https://pypi.org/project/pandocfilters/">Python</a>, <a href="https://cran.r-project.org/web/packages/pandocfilters/">R</a>, etc.). However using a <a href="https://pypi.org/project/pandocfilters/">Python-based Pandoc filter</a>, for instance, requires a Python installation to be present. Starting with version 2.0, <a href="https://pandoc.org/">Pandoc</a> makes it possible to write <a href="https://pandoc.org/lua-filters.html">filters in Lua</a> without any external dependencies.
+</dd></dl>
+
+<span id="footnote_02">[2]</span> ***Kate syntax files*** [↩](#anchor_02)
+
+<dl><dd>
+File <a href="../data/templates/scala.xml"><code>data/templates/scala.xml</code></a> is derived from the Scala 2 syntax file <a href="https://github.com/KDE/syntax-highlighting/tree/master/data/syntax"><code>scala.xml</code></a> available from the <a href="https://github.com/KDE">KDE project</a>. Note that file <a href="../data/templates/scala.xml"><code>data/templates/scala.xml</code></a> <i>must be adapted</i> to any syntax change of the Scala 3 language.
+</dd></dl>
+
+<span id="footnote_03">[3]</span> ***Pandoc templates*** [↩](#anchor_03)
+
+<dl><dd>
+File <a href="../data/templates/template.tex"><code>data/templates/template.tex</code></a> is derived from the default TeX template bundled with <a href="https://pandoc.org/">Pandoc</a>; for instance it contains additional LaTeX code to set up the title page.<br/>The default TeX template file bundled with <a href="https://pandoc.org/">Pandoc</a> can be saved with the following command : <code>$PANDOC_HOME/pandoc -D latex &gt; default-template.tex</code>.
+</dd></dl>
+
+***
+
+*[mics](https://github.com/michelou/)/January 2022* [**&#9650;**](#top "Back to top")
+<span id="bottom">&nbsp;</span>
+
+[github_dotty]: https://github.com/lampepfl/dotty/#dotty
+[github_scala3doc]: https://github.com/lampepfl/dotty/tree/master/scala3doc#scala3doc
diff --git a/pandoc/docs/TEXLIVE.md b/pandoc/docs/TEXLIVE.md
new file mode 100644
index 000000000000..739556048187
--- /dev/null
+++ b/pandoc/docs/TEXLIVE.md
@@ -0,0 +1,168 @@
+# <span id="top">More about TeX Live</span> <span style="size:25%;"><a href="../README.md" title="Back to README">↩</a></span>
+<!-- created by mics (https://github.com/michelou/) on December 2020 -->
+
+The [TeX Live][tex_live] software is free and available on Linux, MacOS and MS Windows.
+
+Our first task is to set up a *minimal* [TeX Live][tex_live]  installation providing the needed PDF engine for [Pandoc], namely [`lualatex`][lualatex] or [`xelatex`][xelatex]. The [TeX Live][tex_live] installer (see [GitHub repository][tex_live_repository]) offers five installation schemes :
+
+<table style="max-width:600px;">
+<tr style="color:#aaaaaa;">
+<td style="text-align:right;">7135 MB</td><td>full</td><td>everything</td>
+</tr>
+<tr>
+<td style="text-align:right;">1647 MB</td><td>medium</td><td>small + more packages and languages</td>
+</tr>
+<tr>
+<td style="text-align:right;">524 MB</td><td>small</td><td>basic + xetex, metapost, a few languages</td>
+</tr>
+<tr>
+<td style="text-align:right;">250 MB</td><td>basic</td><td>plain and latex</td>
+</tr>
+<tr style="color:#aaaaaa;">
+<td style="text-align:right;">73 MB</td><td>minimal</td><td>&nbsp;<td>
+</tr>
+</table>
+
+We eliminate both the *minimal* and *full* schemes straight away and choose the *basic* scheme which fits best our needs.
+
+In the next sections we describe our setup of [TeX Live 2020][tex_live] in the MS Windows 10, Ubuntu 18.04 and Docker environments:
+- [MS Windows 10](#windows) <sup>(*)</sup>
+- [Ubuntu 18.04](#ubuntu) (Bionic)
+- [Docker](#docker) (Ubuntu)
+<div style="font-size:90%;margin:-10px 0 0 24px;"><sup>(*)</sup> Previous versions not tested (tested Windows 10 environments : <a href="https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/windows-commands#command-shell-overview">Windows Command Prompt</a> and MSYS2 Bash Shell).</div>
+
+## <span id="windows">Setting up TeX Live 2021 on MS Windows 10</span> 
+
+We start with the following two steps :
+
+1. We download the setup archive [`install-tl.zip`][tex_live_setup] from the [TUG website][tex_live_tug] and extract the folder `install-tl-20210121\` (where suffix `YYYYMMDD` corresponds to the download date).
+2. We run the [`install-tl-windows.bat --no-gui`][tex_live_install] command  and set the following installation options:
+   <table style="max-width:650px;">
+   <tr>
+   <td>Scheme</td><td><code>d ☒ basic scheme</code></td><td>250 MB</td>
+   </tr>
+   <tr>
+   <td>Collections</td><td><code>a+f+D+G+N ☒</code><sup>(*)</sup></td><td>547 MB</td>
+   </tr>
+   <tr>
+   <td>Directories</td><td><code>c:/opt/texlive/2020</code></td><td>Default: <code>c:/texlive/2020</code></td>
+   </tr>
+   <tr>
+   <td>Options</td><td><code>D+S+L ☐</code> and <code>M+N [None]</code></td><td>356 MB</td>
+   </tr>
+   </table>
+   <div style="font-size:80%;"><sup>(*)</sup> <code>D</code>=LaTeX fundamental packages, <code>G</code>=LuaTeX packages, <code>N</code>=Windows-only support programs.</div>
+
+   **NB.** The [TeX Live][tex_live] installer also creates the directory `c:\opt\texlive\texmf-local\` where private TeX packages can be installed depending on the selected TeX template.
+
+As we run [`md2pdf.bat`](../md2pdf.bat) for the first time we get several error messages reporting missing TeX packages (available from the [TeX Live Archive](https://texlive.info/tlnet-archive/2021/01/20/tlnet/archive/)). From our usage of [`data/templates/template.tex`](../data/templates/template.tex) we have come up with the following additional TeX packages : `environ.tar.xz`, `fancyvrb.tar.xz`, `fontspec.tar.xz`, `gnu-freefont.tar.xz`, `l3backend.tar.xz`, `l3kernel.tar.xz`, `l3packages.tar.xz`, `pgf.tar.xz`, `tcolorbox.tar.xz`, `trimspaces.tar.xz`, `unicode-math.tar.xz`, `xcolor.tar.xz`.
+
+> **:mag_right:** We use the batch file [`extras\install-tex-fonts.bat`](../extras/install-tex-fonts.bat) to download and install the additional TeX fonts (database indices updated with `texhash`). 
+
+We can now do a quick check of our LaTeX installation :
+
+<pre style="font-size:90%; max-width:600px;">
+<b>&gt; <a href="https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/ver">ver</a> | findstr version</b>
+Microsoft Windows [version 10.0.18363.1316]
+&nbsp;
+<b>&gt; <a href="https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/where">where</a> /r %TEXLIVE_HOME%\bin *latex.exe</b>
+c:\opt\texlive\2021\bin\win32\dvilualatex.exe
+c:\opt\texlive\2021\bin\win32\latex.exe
+c:\opt\texlive\2021\bin\win32\lualatex.exe
+c:\opt\texlive\2021\bin\win32\pdflatex.exe
+&nbsp;
+<b>&gt; %TEXLIVE_HOME%\bin\win32\lualatex.exe --version | findstr Version</b>
+This is LuaHBTeX, Version 1.13.2 (TeX Live 2020/W32TeX)
+&nbsp;
+<b>&gt; <a href="https://docs.microsoft.com/en-us/windows-server/administration/windows-commands/where">where</a> /r %PANDOC_HOME% *.exe</b>
+c:\opt\pandoc-2.16.2\pandoc.exe
+</pre>
+
+> **:mag_right:** One may be curious about the directory sizes after performing the above installation steps :
+> <pre style="font-size:90%; max-width:584px;">
+> <b>&gt; powershell -c "function f{param($path);$n=[math]::Round((ls -r $path | measure -sum Length).sum/1024/1024);\"{0,4}M $path\" -f $n};f('c:\opt\texlive\2021');f('c:\opt\texlive\texmf-local')"</b>
+> 354M c:\opt\texlive\2021
+>  48M c:\opt\texlive\texmf-local
+> </pre>
+
+## <span id="ubuntu">Setting up TeX Live 2020 on Ubuntu 18.04</span>
+
+On Ubuntu we follow the same steps as for MS Windows 10 :
+
+1. We download the setup archive [`install-tl-unx.tar.gz`][tex_live_setup] from the [TUG website](https://tug.org/) and extract the folder `install-tl-20210121\` (where suffix `YYYYMMDD` corresponds to the download date).
+2. We run the [`install-tl`][tex_live_install] command  and set the following installation options :
+   <table style="max-width:650px;">
+   <tr>
+   <td>Scheme</td><td><code>d ☒ basic scheme</code></td><td>250 MB</td>
+   </tr>
+   <tr>
+   <td>Collections</td><td><code>a+f+D+G ☒</code><sup>(*)</sup></td><td>423 MB</td>
+   </tr>
+   <tr>
+   <td>Directories</td><td><code>/opt/texlive/2020</code></td><td>Default: <code>/usr/local/texlive/2020</code></td>
+   </tr>
+   <tr>
+   <td>Options</td><td><code>D+S ☐</code> and <code>M+N [None]</code></td><td>233 MB</td>
+   </tr>
+   </table>
+   <div style="font-size:80%;"><sup>(*)</sup> <code>D</code>=LaTeX fundamental packages, <code>G</code>=LuaTeX packages.</div>
+
+   **NB.** The [TeX Live][tex_live] installer also creates the directory `/opt/texlive/texmf-local/` where private TeX packages can be installed depending on the selected TeX template.
+
+> **:mag_right:** We rely on the bash script [`extras\install-tex-fonts`](../extras/install-tex-fonts) to download and install the additional TeX fonts (database indices updated with `texhash`) .  
+
+We can now do a quick check of our LaTeX installation :
+
+<pre style="font-size:90%; max-width:600px;">
+<b>$ <a href="https://man7.org/linux/man-pages/man1/uname.1.html">uname</a> -ior</b>
+4.4.0-18362-Microsoft x86_64 GNU/Linux
+&nbsp;
+<b>$ <a href="https://man7.org/linux/man-pages/man1/find.1.html">find</a> $TEXLIVE_HOME/bin -name *latex</b>
+/opt/texlive/2021/bin/x86_64-linux/dvilualatex
+/opt/texlive/2021/bin/x86_64-linux/latex
+/opt/texlive/2021/bin/x86_64-linux/lualatex
+/opt/texlive/2021/bin/x86_64-linux/pdflatex
+&nbsp;
+<b>$ /opt/texlive/2021//bin/x86_64-linux/lualatex --version | grep Version</b>
+This is LuaHBTeX, Version 1.13.2 (TeX Live 2020)
+</pre>
+
+> **:mag_right:** One may be curious about the directory sizes after performing the above installation steps :
+> <pre style="font-size:90%; max-width:584px;">
+> <b>$ du -sh /opt/texlive/2020 /opt/texlive/texmf-local/</b>
+> 246M    /opt/texlive/2020
+> 25M     /opt/texlive/texmf-local/
+> </pre>
+
+## <span id="docker">Setting up TeX Live 2020 on Docker</span>
+
+We use [`pandoc/ubuntu-latex`][docker_pandoc], a Ubuntu based image which bundles [TeX Live][tex_live] and [Pandoc]; the Docker image is available from the [Docker Hub][docker_hub].
+
+> See document [`DOCKER.md`](./DOCKER.md) for further information, e.g. `Dockerfile` usage.
+
+<!--
+## <span id="footnotes">Footnotes</span>
+
+<span id="footnote_01">[1]</span> ***Pandoc software*** [↩](#anchor_01)
+
+<p style="margin:0 0 1em 20px;">
+ (version: 2.11.3.2, compressed size: 240.96 MB)
+</p>
+-->
+***
+
+*[mics](https://github.com/michelou/)/January 2022* [**&#9650;**](#top "Back to top")
+<span id="bottom">&nbsp;</span>
+
+[docker_entrypoint]: https://docs.docker.com/engine/reference/builder/#entrypoint "ENTRYPOINT instruction"
+[docker_env]: https://docs.docker.com/engine/reference/builder/#env
+[docker_hub]: https://hub.docker.com/
+[docker_pandoc]: https://hub.docker.com/r/pandoc/ubuntu-latex
+[lualatex]: http://www.luatex.org/
+[pandoc]: https://pandoc.org/ "A universal document converter"
+[tex_live]: https://tug.org/texlive/
+[tex_live_repository]: https://github.com/TeX-Live/installer "TeX Live installer repository"
+[tex_live_install]: https://tug.org/texlive/doc/install-tl.html "TeX Live cross-platform installer"
+[tex_live_setup]: https://tug.org/texlive/acquire-netinstall.html
+[tex_live_tug]: https://tug.org/ "TeX Users Group website"
+[xelatex]: https://sourceforge.net/projects/xetex/
diff --git a/pandoc/extras/build_image b/pandoc/extras/build_image
new file mode 100644
index 000000000000..6177184a1eaf
--- /dev/null
+++ b/pandoc/extras/build_image
@@ -0,0 +1,208 @@
+#!/usr/bin/env bash
+
+## Created by mics (https://github.com/michelou/) on December 2020.
+
+##############################################################################
+## Subroutines
+
+getHome() {
+    local source="${BASH_SOURCE[0]}"
+    while [ -h "$source" ] ; do
+        local linked="$(readlink "$source")"
+        local dir="$( cd -P $(dirname "$source") && cd -P $(dirname "$linked") && pwd )"
+        source="$dir/$(basename "$linked")"
+    done
+    ( cd -P "$(dirname "$source")/.." && pwd )
+}
+
+getOS() {
+    local os
+    case "$(uname -s)" in
+        Linux*)  os=Linux;;
+        Darwin*) os=Mac;;
+        CYGWIN*) os=Win;; # os=Cygwin;;
+        MINGW*)  os=Win;; # os=MinGw;;
+        *)       os=Unknown
+    esac
+    echo $os
+}
+
+# use variables EXITCODE, TIMER_START
+cleanup() {
+    [[ $1 =~ ^[0-1]$ ]] && EXITCODE=$1
+
+    if $TIMER; then
+        local timer_end=$(date +'%s')
+        local duration=$((timer_end - TIMER_START))
+        echo "Total elapsed time: $(date -d @$duration +'%H:%M:%S')" 1>&2
+    fi
+    debug "EXITCODE=$EXITCODE"
+    exit $EXITCODE
+}
+
+verbose() {
+    $VERBOSE && echo "$1" 1>&2
+}
+
+debug() {
+    local debug_label="[DEBUG]"
+    $DEBUG && echo "$debug_label $1" 1>&2
+}
+
+error() {
+    local error_label="Error:"
+    echo "$error_label $1" 1>&2
+}
+
+args() {
+    [[ $# -eq 0 ]] && HELP=true && return 1
+
+    for arg in "$@"; do
+        case "$arg" in
+        ## options
+        -debug)   DEBUG=true ;;
+        -help)    HELP=true ;;
+        -timer)   TIMER=true ;;
+        -verbose) VERBOSE=true ;;
+        -*)
+            error "Unknown option $arg"
+            EXITCODE=1 && return 0
+            ;;
+        ## subcommands
+        help)     HELP=true ;;
+        run)      RUN=true ;;
+        save)     SAVE=true ;;
+        *)
+           error "Error: Unknown subcommand $arg"
+           EXITCODE=1 && return 0
+           ;;
+        esac
+    done
+    $HELP || $RUN || $SAVE || HELP=true
+    debug "Options    : DEBUG=$DEBUG TIMER=$TIMER VERBOSE=$VERBOSE"
+    debug "Subcommands: HELP=$HELP RUN=$RUN SAVE=$SAVE"
+    # See http://www.cyberciti.biz/faq/linux-unix-formatting-dates-for-display/
+    $TIMER && TIMER_START=$(date +"%s")
+}
+
+help() {
+    cat << EOS
+Usage: $BASENAME { <option> | <subcommand> }
+
+  Options:
+    -debug      show commands executed by this script
+    -timer      display total elapsed time
+    -verbose    display progress messages
+
+  Subcommands:
+    help        display this help message
+    run         create image "$IMAGE_NAME:$TAG_NAME"
+    save        save image as a tar archive file
+EOS
+}
+
+run() {
+    local container="$($DOCKER_CMD container ps --all --format "{{.Names}}" | grep $CONTAINER_NAME)"
+    if [ $container ]; then
+        debug "$DOCKER_CMD container rm $CONTAINER_NAME"
+        verbose "Remove container $CONTAINER_NAME based on image ${IMAGE_NAME}:$TAG_NAME"
+        $DOCKER_CMD container rm $CONTAINER_NAME
+        [[ $? -eq 0 ]] || ( EXITCODE=1 & return 0 )
+    fi
+    local image="$($DOCKER_CMD image ls --format "{{.Repository}}" | grep ${IMAGE_NAME}:$TAG_NAME)"
+    if [ $image ]; then
+        debug "docker image rm ${IMAGE_NAME}:$TAG_NAME"
+        verbose "Remove container $CONTAINER_NAME based on image ${IMAGE_NAME}:$TAG_NAME"
+        $DOCKER_CMD image rm ${IMAGE_NAME}:$TAG_NAME
+        [[ $? -eq 0 ]] || ( EXITCODE=1 & return 0 )
+    fi
+    local build_opts="--tag ${IMAGE_NAME}:$TAG_NAME --build-arg BUILD_DATE=$(date +%FT%T%z)"
+    [ $DEBUG ] || build_opts="--quiet $build_opts"
+
+    debug "$DOCKER_CMD build $build_opts ."
+    verbose "Build docker image ${IMAGE_NAME}:$TAG_NAME"
+    $DOCKER_CMD build $build_opts .
+    [[ $? -eq 0 ]] || ( EXITCODE=1 & return 0 )
+
+    local run_opts="--name $CONTAINER_NAME --env GIT_HASH=$(git_hash)"
+    [ $DEBUG ] && run_opts="$run_opts --env DEBUG=1"
+
+    debug "$DOCKER_CMD container run $run_opts ${IMAGE_NAME}:$TAG_NAME"
+    verbose "Start container $CONTAINER_NAME based on image ${IMAGE_NAME}:$TAG_NAME"
+    $DOCKER_CMD container run $run_opts ${IMAGE_NAME}:$TAG_NAME
+    [[ $? -eq 0 ]] || ( EXITCODE=1 & return 0 )
+
+    debug "$DOCKER_CMD cp ${CONTAINER_NAME}:/app/target/$FILE_NAME $OUTPUT_FILE"
+    verbose "Copy file $FILE_NAME to directory ${TARGET_DIR/$PROG_HOME\//}/"
+    $DOCKER_CMD cp ${CONTAINER_NAME}:/app/target/$FILE_NAME $OUTPUT_FILE
+    [[ $? -eq 0 ]] || ( EXITCODE=1 & return 0 )
+}
+
+git_hash() {
+    local git_url="https://github.com/lampepfl/dotty.git"
+    local hash="$(git ls-remote $git_url master)"
+    ${hash:0:10}
+}
+
+save() {
+    debug "$DOCKER_CMD save -o $TAR_FILE ${IMAGE_NAME}:$TAG_NAME"
+    verbose "Save image ${IMAGE_NAME}:$TAG_NAME to archive file ${TAR_FILE/$PROG_HOME\//}"
+    $DOCKER_CMD save -o $TAR_FILE ${IMAGE_NAME}:$TAG_NAME
+    [[ $? -eq 0 ]] || ( EXITCODE=1 & return 0 )
+
+    debug "$GZIP_CMD --force --keep $TAR_FILE"
+    verbose "Compress archive file ${TAR_FILE/$PROG_HOME\//}"
+    $GZIP_CMD --force --keep $TAR_FILE
+    [[ $? -eq 0 ]] || ( EXITCODE=1 & return 0 )
+}
+
+##############################################################################
+## Environment setup
+
+BASENAME=$(basename "${BASH_SOURCE[0]}")
+
+EXITCODE=0
+
+PROG_HOME="$(getHome)"
+
+OS="$(getOS)"
+[ $OS == "Unknown" ] && error "Unsuppored OS"
+[ $OS == "Win" ] && EXT=".exe" || EXT=""
+
+DOCKER_CMD="$(which docker)$EXT"
+GIT_CMD="$(which git)$EXT"
+GZIP_CMD="$(which gzip)$EXT"
+
+## see https://frightanic.com/computers/docker-default-container-names/
+CONTAINER_NAME="scala3_docs"
+IMAGE_NAME="scala3/md2pdf"
+TAG_NAME="1.0"
+
+DEBUG=false
+HELP=false
+RUN=false
+SAVE=false
+TIMER=false
+VERBOSE=false
+
+FILE_NAME="scala3_reference.pdf"
+TARGET_DIR="$PROG_HOME/target"
+OUTPUT_FILE="$TARGET_DIR/$FILE_NAME"
+TAR_FILE="$TARGET_DIR/${IMAGE_NAME/\//_}-$TAG_NAME.tar"
+
+args "$@"
+[[ $EXITCODE -eq 0 ]] || cleanup 1
+
+##############################################################################
+## Main
+
+$HELP && help && cleanup
+
+if $RUN; then
+    run || cleanup 1
+fi
+if $SAVE; then
+    save || cleanup 1
+fi
+
+cleanup
diff --git a/pandoc/extras/build_image.bat b/pandoc/extras/build_image.bat
new file mode 100644
index 000000000000..1330862e5928
--- /dev/null
+++ b/pandoc/extras/build_image.bat
@@ -0,0 +1,237 @@
+@rem ## Created by mics (https://github.com/michelou/) on December 2020.
+
+@echo off
+setlocal enabledelayedexpansion
+
+set _DEBUG=0
+
+@rem #########################################################################
+@rem ## Environment setup
+
+set _EXITCODE=0
+
+call :env
+if not %_EXITCODE%==0 goto end
+
+call :args %*
+if not %_EXITCODE%==0 goto end
+
+@rem #########################################################################
+@rem ## Main
+
+if %_HELP%==1 (
+    call :help
+    exit /b !_EXITCODE!
+)
+if %_BUILD%==1 (
+    call :build
+    if not !_EXITCODE!==0 goto end
+)
+if %_TEST%==1 (
+    call :test
+    if not !_EXITCODE!==0 goto end
+)
+if %_SAVE%==1 (
+    call :save
+    if not !_EXITCODE!==0 goto end
+)
+goto end
+
+@rem #########################################################################
+@rem ## Subroutines
+
+:env
+set _BASENAME=%~n0
+for %%f in ("%~dp0\..") do set "_ROOT_DIR=%%~dpf"
+for %%f in ("%~dp0\.") do set "_PANDOC_DIR=%%~dpf"
+
+set _DEBUG_LABEL=[DEBUG]
+set _ERROR_LABEL=Error:
+
+@rem see https://frightanic.com/computers/docker-default-container-names/
+set _CONTAINER_NAME=scala3_docs
+set _IMAGE_NAME=scala3/md2pdf
+set _TAG_NAME=1.0
+
+set "_DOCKER_CMD=docker.exe"
+set "_GIT_CMD=git.exe"
+
+set "_GZIP_CMD=gzip.exe"
+where /q "%_GZIP_CMD%" 2>NUL
+if %ERRORLEVEL%==1 (
+    set "_GZIP_CMD=%GIT_HOME%\usr\bin\gzip.exe"
+    if !ERRORLEVEL!==1 (
+        echo %_ERROR_LABEL% Gzip executable not found 1>&2
+        set _EXITCODE=1
+        goto :eof
+    )
+)
+set "_TARGET_DIR=%_ROOT_DIR%\out\pandoc"
+set "_TAR_FILE=%_TARGET_DIR%\%_IMAGE_NAME:/=_%-%_TAG_NAME%.tar"
+goto :eof
+
+@rem input parameter: %*
+:args
+set _CLEAN=0
+set _HELP=0
+set _BUILD=0
+set _PROJECT_NAME=internals
+set _SAVE=0
+set _TEST=0
+set _VERBOSE=0
+set __N=0
+:args_loop
+set "__ARG=%~1"
+if not defined __ARG (
+    if !__N!==0 set _HELP=1
+    goto args_done
+)
+if "%__ARG:~0,1%"=="-" (
+    @rem option
+    if "%__ARG%"=="-debug" ( set _DEBUG=1
+    ) else if "%__ARG%"=="-help" ( set _HELP=1
+    ) else if "%__ARG%"=="-verbose" ( set _VERBOSE=1
+    ) else (
+        echo %_ERROR_LABEL% Unknown option %__ARG% 1>&2
+        set _EXITCODE=1
+        goto args_done
+    )
+) else (
+    @rem subcommand
+    if "%__ARG%"=="build" ( set _BUILD=1
+	) else if "%__ARG%"=="help" ( set _HELP=1
+    ) else if "%__ARG%"=="save" ( set _SAVE=1
+    ) else if "%__ARG%"=="test" ( set _TEST=1
+    ) else (
+        echo %_ERROR_LABEL% Unknown subcommand %__ARG% 1>&2
+        set _EXITCODE=1
+        goto args_done
+    )
+    set /a __N+=1
+)
+shift
+goto args_loop
+:args_done
+set _REDIRECT_STDOUT=1^>NUL
+if %_DEBUG%==1 set _REDIRECT_STDOUT=1^>^&2
+
+set "_FILE_NAME=scala3_%_PROJECT_NAME%.pdf
+set "_OUTPUT_FILE=%_TARGET_DIR%\%_FILE_NAME%"
+
+if %_DEBUG%==1 (
+    echo %_DEBUG_LABEL% Options    : _VERBOSE=%_VERBOSE% 1>&2
+    echo %_DEBUG_LABEL% Subcommands: _BUILD=%_BUILD% _SAVE=%_SAVE% _TEST=%_TEST% 1>&2
+)
+goto :eof
+
+:help
+echo Usage: %_BASENAME% { ^<option^> ^| ^<subcommand^> }
+echo.
+echo   Options:
+echo     -debug      show commands executed by this script
+echo     -help       display this help message
+echo     -verbose    display progress messages
+echo.
+echo   Subcommands:
+echo     build       create image "%_IMAGE_NAME%:%_TAG_NAME%"
+echo     help        display this help message
+echo     save        save image as a tar archive file
+echo     test        test image "%_IMAGE_NAME%:%_TAG_NAME%" with project %_PROJECT_NAME%
+goto :eof
+
+:build
+for /f %%i in ('%_DOCKER_CMD% container ps --all --format "{{.Names}}" ^| findstr /c:"%_CONTAINER_NAME%"') do (
+    if %_DEBUG%==1 ( echo %_DEBUG_LABEL% "%_DOCKER_CMD%" container rm "%_CONTAINER_NAME%" 1>&2
+    ) else if %_VERBOSE%==1 ( echo Remove container "%_CONTAINER_NAME%" based on image "%_IMAGE_NAME%" 1>&2
+    )
+    call "%_DOCKER_CMD%" container rm "%_CONTAINER_NAME%" %_REDIRECT_STDOUT%
+    if not !ERRORLEVEL!==0 ( set _EXITCODE=1& goto :eof )
+)
+for /f %%i in ('%_DOCKER_CMD% image ls --format "{{.Repository}}" ^| findstr /c:"%_IMAGE_NAME%:%_TAG_NAME%"') do (
+    if %_DEBUG%==1 ( echo %_DEBUG_LABEL% "%_DOCKER_CMD%" image rm "%_IMAGE_NAME%:%_TAG_NAME%" 1>&2
+    ) else if %_VERBOSE%==1 ( echo Remove docker image "%_IMAGE_NAME%:%_TAG_NAME%" 1>&2
+    )
+    call "%_DOCKER_CMD%" image rm "%_IMAGE_NAME%:%_TAG_NAME%" %_REDIRECT_STDOUT%
+    if not !ERRORLEVEL!==0 ( set _EXITCODE=1& goto :eof )
+)
+@rem check path of Docker build context
+if /i not "%CD%\"=="%_PANDOC_DIR%" (
+    echo %_ERROR_LABEL% Docker build context must be the pandoc directory 1>&2
+    set _EXITCODE=1
+	goto :eof
+)
+xcopy /e /y "%_ROOT_DIR%docs\docs" "%_PANDOC_DIR%tmp\docs\" %_REDIRECT_STDOUT%
+if not %ERRORLEVEL%==0 (
+    echo %_ERROR_LABEL% Failed to copy directory docs\docs 1>&2
+    set _EXITCODE=1
+    goto :eof
+)
+set __BUILD_OPTS=--tag "%_IMAGE_NAME%:%_TAG_NAME%"
+
+if %_DEBUG%==1 ( echo %_DEBUG_LABEL% "%_DOCKER_CMD%" image build %__BUILD_OPTS% . 1>&2
+) else if %_VERBOSE%==1 ( echo Build docker image "%_IMAGE_NAME%:%_TAG_NAME%" 1>&2
+)
+call "%_DOCKER_CMD%" image build %__BUILD_OPTS% . %_REDIRECT_STDOUT%
+if not %ERRORLEVEL%==0 (
+    set _EXITCODE=1
+    goto :eof
+)
+goto :eof
+
+:test
+call :hash
+if not %_EXITCODE%==0 goto :eof
+
+@rem see https://docs.docker.com/engine/reference/commandline/run/
+set __RUN_OPTS=--name "%_CONTAINER_NAME%"
+
+if %_DEBUG%==1 ( echo %_DEBUG_LABEL% "%_DOCKER_CMD%" container run %__RUN_OPTS% "%_IMAGE_NAME%:%_TAG_NAME%" 1>&2
+) else if %_VERBOSE%==1 ( echo Start container "%_CONTAINER_NAME%" based on image "%_IMAGE_NAME%:%_TAG_NAME%" 1>&2
+)
+call "%_DOCKER_CMD%" container run %__RUN_OPTS% "%_IMAGE_NAME%:%_TAG_NAME%" %_REDIRECT_STDOUT%
+if not %ERRORLEVEL%==0 ( set _EXITCODE=1& goto :eof )
+
+if %_DEBUG%==1 ( echo %_DEBUG_LABEL% "%_DOCKER_CMD%" cp "%_CONTAINER_NAME%:/dotty/out/pandoc/%_FILE_NAME%" "%_OUTPUT_FILE%" 1>&2
+) else if %_VERBOSE%==1 ( echo Copy file %_FILE_NAME% to directory "!_TARGET_DIR:%_ROOT_DIR%\=!" 1>&2
+)
+call "%_DOCKER_CMD%" cp "%_CONTAINER_NAME%:/dotty/out/pandoc/%_FILE_NAME%" "%_OUTPUT_FILE%"
+if not %ERRORLEVEL%==0 ( set _EXITCODE=1& goto :eof )
+
+if %_DEBUG%==1 dir "%_TARGET_DIR%" 1>&2
+goto :eof
+
+@rem output parameter: _HASH
+:hash
+set _HASH=0000000000
+
+set __GIT_URL=https://github.com/lampepfl/dotty.git
+for /f "tokens=1,*" %%i in ('%_GIT_CMD% ls-remote "%__GIT_URL%" master') do set _HASH=%%i
+set _HASH=%_HASH:~0,10%
+goto :eof
+
+:save
+if %_DEBUG%==1 ( echo %_DEBUG_LABEL% "%_DOCKER_CMD%" save -o "%_TAR_FILE%" "%_IMAGE_NAME%:%_TAG_NAME%" 1>&2
+) else if %_VERBOSE%==1 ( echo Save image "%_IMAGE_NAME%:%_TAG_NAME%" to archive file "!_TAR_FILE:%_ROOT_DIR%\=!" 1>&2
+)
+call "%_DOCKER_CMD%" save -o "%_TAR_FILE%" "%_IMAGE_NAME%:%_TAG_NAME%"
+if not %ERRORLEVEL%==0 (
+    set _EXITCODE=1
+    goto :eof
+)
+if %_DEBUG%==1 ( echo %_DEBUG_LABEL% "%_GZIP_CMD%" --force --keep "%_TAR_FILE%" 1>&2
+) else if %_VERBOSE%==1 ( echo Compress archive file "!_TAR_FILE:%_ROOT_DIR%\=!" 1>&2
+) 
+call "%_GZIP_CMD%" --force --keep "%_TAR_FILE%"
+if not %ERRORLEVEL%==0 (
+    set _EXITCODE=1
+    goto :eof
+)
+goto :eof
+
+@rem #########################################################################
+@rem ## Cleanups
+
+:end
+if %_DEBUG%==1 echo %_DEBUG_LABEL% _EXITCODE=%_EXITCODE% 1>&2
+exit /b %_EXITCODE%
+endlocal
diff --git a/pandoc/extras/install-tex-fonts b/pandoc/extras/install-tex-fonts
new file mode 100644
index 000000000000..f4f1939046a7
--- /dev/null
+++ b/pandoc/extras/install-tex-fonts
@@ -0,0 +1,130 @@
+#!/bin/sh
+
+## DEBUG=1
+
+##############################################################################
+## Subroutines
+
+getHome() {
+    # local source="${BASH_SOURCE[0]}"
+    local source="$0"
+    while [ -h "$source" ] ; do
+        local linked="$(readlink "$source")"
+        local dir="$( cd -P $(dirname "$source") && cd -P $(dirname "$linked") && pwd )"
+        source="$dir/$(basename "$linked")"
+    done
+    ( cd -P "$(dirname "$source")" && pwd )
+}
+
+getOS() {
+    local os
+    case "$(uname -s)" in
+        Linux*)  os=Linux;;
+        Darwin*) os=Mac;;
+        CYGWIN*) os=Win;; # os=Cygwin;;
+        MINGW*)  os=Win;; # os=MinGw;;
+        *)       os=Unknown
+    esac
+    echo $os
+}
+
+download() {
+    local status=0
+    ## Update path part '2022/01/04' to retrieve the latest archive files
+    local archive_url=https://texlive.info/tlnet-archive/2022/01/04/tlnet/archive
+    local archive_files="dejavu environ fancyvrb fontspec gnu-freefont"
+    archive_files="$archive_files l3backend l3kernel l3packages pgf"
+    archive_files="$archive_files tcolorbox trimspaces unicode-math xcolor"
+    local wget_opts="--tries=3 --no-verbose"
+    #[ $DEBUG ] && wget_opts="$wget_opts --show-progress"
+
+    for i in $archive_files; do
+        local xz_name=${i}.tar.xz
+        local xz_file=$DOWNLOADS_DIR/$xz_name
+        local xz_url=$archive_url/$xz_name
+        [ $DEBUG ] && echo "Download file $xz_name to directory $DOWNLOADS_DIR" >>$LOG_FILE
+        wget $wget_opts -O $xz_file $xz_url
+        [ $? -eq 0 ] || { echo "Error: Failed to download $xz_name" >>$LOG_FILE; status=1; }
+    done
+    echo $status
+}
+
+install() {
+    [ -d "$TEXMF_LOCAL_DIR" ] || mkdir -p "$TEXMF_LOCAL_DIR"
+
+    local status=0
+    for f in $(ls $DOWNLOADS_DIR/*.tar.xz); do
+        local xz_file=$f
+        [ $DEBUG ] && echo "Extract TeX fonts from archive file $xz_file" >>$LOG_FILE
+        $TAR_CMD -C $TEXMF_LOCAL_DIR/ -xf $xz_file
+        [ $? -eq 0 ] || { status=1; break; }
+    done
+    echo $status
+}
+
+##############################################################################
+## Environment setup
+
+PROG_HOME="$(getHome)"
+
+OS="$(getOS)"
+[ $OS == "Unknown" ] && { echo "Error: Unsuppored OS" >>$LOG_FILE; exit 1; }
+[ $OS == "Win" ] && EXT=".exe" || EXT=""
+
+if [ $OS == "Win" ]; then
+    CYGPATH=cygpath.exe
+    CYGPATH_CMD="$(command -v $CYGPATH)"
+    if ! [ -x "$CYGPATH_CMD" ]; then
+        CYGPATH_CMD="$MSYS2_HOME/usr/bin/$CYGPATH"
+        [ -x "$CYGPATH_CMD" ] || { echo "$CYGPATH executable not found" >>$LOG_FILE; exit 1; }
+    fi
+    TAR=tar.exe
+    TAR_CMD="$(command -v $TAR)"
+    if ! [ -x "$TAR_CMD" ]; then
+        TAR_CMD="$MSYS2_HOME/usr/bin/$TAR"
+        [ -x "$TAR_CMD" ] || { echo "$TAR executable not found" >>$LOG_FILE; exit 1; }
+    fi
+    XZ=xz.exe
+    XZ_CMD="$(command -v $XZ)"
+    if ! [ -x "$XZ_CMD" ]; then
+        XZ_CMD="$MSYS2_HOME/mingw64/bin/$XZ"
+        [ -x "$XZ_CMD" ] || { echo "$XZ executable not found" >>$LOG_FILE; exit 1; }
+    fi
+else
+    TAR_CMD=tar
+    XZ_CMD=xz
+fi
+TEXHASH=texhash$EXT
+## We give priority to commands from the installation directory defined by TEXLIVE_HOME
+if [ -d "$TEXLIVE_HOME" ]; then
+    TEXHASH_CMD="$(find $TEXLIVE_HOME $TEXHASH)"
+else
+    TEXHASH_CMD="$(command -v $TEXHASH)"
+fi
+[ -x "$TEXHASH_CMD" ] || { echo "Error: $TEXHASH executable not found (check variable TEXLIVE_HOME)" >>$LOG_FILE; exit 1; }
+
+BASENAME="$(basename "$0")"
+DOWNLOADS_DIR=$PROG_HOME/downloads
+TEXMF_LOCAL_DIR=$PROG_HOME/texmf-local
+
+LOG_FILE=$PROG_HOME/log.txt
+
+##############################################################################
+## Main
+
+[ -d "$DOWNLOADS_DIR" ] || mkdir -p "$DOWNLOADS_DIR"
+
+STATUS="$(download)"
+[ $STATUS -eq 0 ] || { echo "Error: Download failed ($STATUS)" >>$LOG_FILE; exit 1; }
+
+STATUS="$(install)"
+[ $STATUS -eq 0 ] || { echo "Error: Installation failed $STATUS" >>$LOG_FILE; exit 1; }
+
+TEXHASH_OPTS=--quiet
+[ $DEBUG ] && TEXHASH_OPTS=--verbose
+
+[ $DEBUG ] && echo "Rebuild database indices" >>$LOG_FILE
+$TEXHASH_CMD $TEXHASH_OPTS
+[ $? -eq 0 ] || exit 1
+
+exit 0
diff --git a/pandoc/extras/install-tex-fonts.bat b/pandoc/extras/install-tex-fonts.bat
new file mode 100644
index 000000000000..1eee2c7b9b0e
--- /dev/null
+++ b/pandoc/extras/install-tex-fonts.bat
@@ -0,0 +1,195 @@
+@echo off
+setlocal enabledelayedexpansion
+
+@rem only for interactive debugging
+set _DEBUG=0
+
+@rem #########################################################################
+@rem ## Environment setup
+
+set _EXITCODE=0
+
+call :env
+if not %_EXITCODE%==0 goto end
+
+call :args %*
+if not %_EXITCODE%==0 goto end
+
+@rem #########################################################################
+@rem ## Main
+
+if %_HELP%==1 (
+    call :help
+    exit /b !_EXITCODE!
+)
+if %_RUN%==1 (
+    call :run
+    if not !_EXITCODE!==0 goto end
+)
+goto end
+
+@rem #########################################################################
+@rem ## Subroutines
+
+:env
+set _BASENAME=%~n0
+set "_ROOT_DIR=%~dp0"
+
+set _DEBUG_LABEL=[DEBUG]
+set _ERROR_LABEL=Error:
+
+set "_DOWNLOADS_DIR=%_ROOT_DIR%downloads"
+set "_TEXMF_LOCAL_DIR=%_ROOT_DIR%texmf-local"
+
+@rem We extract tar.xz archives with commands tar and xz
+if not exist "%GIT_HOME%\usr\bin\tar.exe" (
+    echo %_ERROR_LABEL% tar executable not found 1>&2
+    set _EXITCODE=1
+    goto :eof
+)
+set "_TAR_CMD=%GIT_HOME%\usr\bin\tar.exe"
+set "_CYGPATH_CMD=%GIT_HOME%\usr\bin\cygpath.exe"
+
+if not exist "%GIT_HOME%\mingw64\bin\xz.exe" (
+    echo %_ERROR_LABEL% xz executable not found 1>&2
+    set _EXITCODE=1
+    goto :eof
+)
+set "_XZ_CMD=%GIT_HOME%\mingw64\bin\xz.exe"
+
+if not exist "%TEXLIVE_HOME%\bin\win32\texhash.exe" (
+    echo %_ERROR_LABEL% texhash executable not found ^(check variable TEXLIVE_HOME^) 1>&2
+    set _EXITCODE=1
+    goto :eof
+)
+set "_TEXHASH_CMD=%TEXLIVE_HOME%\bin\win32\texhash.exe"
+goto :eof
+
+@rem input parameter: %*
+@rem output parameters: _HELP, _RUN, _VERBOSE
+:args
+set _HELP=0
+set _RUN=0
+set _VERBOSE=0
+set __N=0
+:args_loop
+set "__ARG=%~1"
+if not defined __ARG (
+    if !__N!==0 set _HELP=1
+    goto args_done
+)
+if "%__ARG:~0,1%"=="-" (
+    @rem option
+    if "%__ARG%"=="-debug" ( set _DEBUG=1
+    ) else if "%__ARG%"=="-help" ( set _HELP=1
+    ) else if "%__ARG%"=="-verbose" ( set _VERBOSE=1
+    ) else (
+        echo %_ERROR_LABEL% Unknown option %__ARG% 1>&2
+        set _EXITCODE=1
+        goto args_done
+    )
+) else (
+    @rem subcommand
+    if "%__ARG%"=="help" ( set _HELP=1
+    ) else if "%__ARG%"=="run" ( set _RUN=1
+    ) else (
+        echo %_ERROR_LABEL% Unknown subcommand %__ARG% 1>&2
+        set _EXITCODE=1
+        goto args_done
+    )
+    set /a __N+=1
+)
+shift
+goto args_loop
+:args_done
+set _REDIRECT_STDOUT=1^>NUL
+if %_DEBUG%==1 set _REDIRECT_STDOUT=1^>^&2
+
+if %_DEBUG%==1 (
+    echo %_DEBUG_LABEL% Options    : _HELP=%_HELP% _VERBOSE=%_VERBOSE% 1>&2
+    echo %_DEBUG_LABEL% Subcommands: _RUN=%_RUN% 1>&2
+    echo %_DEBUG_LABEL% Variables  : TEXLIVE_HOME=%TEXLIVE_HOME% 1>&2
+)
+goto :eof
+
+:help
+echo Usage: %_BASENAME% { ^<option^> ^| ^<subcommand^> }
+echo.
+echo   Options:
+echo     -debug      display commands executed by this script
+echo     -verbose    display environment settings
+echo.
+echo   Subcommands:
+echo     help        display this help message
+echo     run         download and install additional TeX fonts
+goto :eof
+
+:run
+if not exist "%_DOWNLOADS_DIR%" mkdir "%_DOWNLOADS_DIR%"
+
+call :download
+if not !_EXITCODE!==0 goto :eof
+
+call :install
+if not !_EXITCODE!==0 goto :eof
+
+goto :eof
+
+:install
+for /f %%f in ('dir /b "%_DOWNLOADS_DIR%\*.tar.xz"') do (
+    set "__XZ_FILE=%_DOWNLOADS_DIR%\%%f"
+    set "__TAR_FILE=!__XZ_FILE:~0,-3!"
+    if not exist "!__TAR_FILE!" (
+        if %_DEBUG%==1 echo %_DEBUG_LABEL% "%_XZ_CMD%" -dk "!__XZ_FILE!" 1>&2
+        call "%_XZ_CMD%" -dk "!__XZ_FILE!"
+    )
+    for /f %%i in ('%_CYGPATH_CMD% "%_TEXMF_LOCAL_DIR%"') do set "__C_ARG=%%i"
+    for /f %%i in ('%_CYGPATH_CMD% "!__TAR_FILE!"') do set "__XF_ARG=%%i"
+    if %_DEBUG%==1 ( echo %_DEBUG_LABEL% "%_TAR_CMD%" -C "!__C_ARG!" -xf "!__XF_ARG!" 1>&2
+    ) else if %_VERBOSE%==1 ( echo Extract fonts from archive file "!__TAR_FILE:%TEMP%=%%TEMP%%!" 1>&2
+    )
+    call "%_TAR_CMD%" -C "!__C_ARG!" -xf "!__XF_ARG!"
+    @rem del "!__TAR_FILE!"
+)
+if %_DEBUG%==1 ( echo %_DEBUG_LABEL% "%_TEXHASH_CMD%" 1>&2
+) else if %_VERBOSE%==1 echo Rebuild database indices 1>&2
+)
+call "%_TEXHASH_CMD%" %_REDIRECT_STDOUT%
+if not %ERRORLEVEL%==0 (
+    set _EXITCODE=1
+    goto :eof
+)
+goto :eof
+
+:download
+@rem Update path part '2021/01/20' to retrieve newer archive files
+set __ARCHIVE_URL=https://texlive.info/tlnet-archive/2021/01/20/tlnet/archive
+set __ARCHIVE_FILES=environ fancyvrb fontspec gnu-freefont
+set __ARCHIVE_FILES=%__ARCHIVE_FILES% l3backend l3kernel l3packages pgf
+set __ARCHIVE_FILES=%__ARCHIVE_FILES% tcolorbox trimspaces unicode-math xcolor
+
+for %%i in (%__ARCHIVE_FILES%) do (
+    set "__XZ_NAME=%%i.tar.xz"
+    set "__XZ_FILE=%_DOWNLOADS_DIR%\!__XZ_NAME!"
+    if not exist "!__XZ_FILE!" (
+        set "__XZ_URL=%__ARCHIVE_URL%/!__XZ_NAME!"
+        if %_DEBUG%==1 ( echo %_DEBUG_LABEL% powershell -c "Invoke-WebRequest -Uri '!__XZ_URL!' -Outfile '!__XZ_FILE!'" 1>&2
+        ) else if %_VERBOSE%==1 ( echo Download archive file !__XZ_NAME! to directory "!_DOWNLOADS_DIR:%TEMP%=%%TEMP%%!" 1>&2
+        )
+        powershell -c "$progressPreference='silentlyContinue';Invoke-WebRequest -Uri '!__XZ_URL!' -Outfile '!__XZ_FILE!'"
+        if not !ERRORLEVEL!==0 (
+            echo %_ERROR_LABEL% Failed to download file %__XZ_NAME% 1>&2
+            set _EXITCODE=1
+            goto :eof
+        )
+    )
+)
+goto :eof
+
+@rem #########################################################################
+@rem ## Cleanups
+
+:end
+if %_DEBUG%==1 echo %_DEBUG_LABEL% _EXITCODE=%_EXITCODE% 1>&2
+exit /b %_EXITCODE%
+endlocal
diff --git a/pandoc/md2pdf b/pandoc/md2pdf
new file mode 100644
index 000000000000..b66a50480cbb
--- /dev/null
+++ b/pandoc/md2pdf
@@ -0,0 +1,188 @@
+#!/bin/sh
+
+## Created by mics (https://github.com/michelou/) on December 2020.
+
+##############################################################################
+## Subroutines
+
+getHome() {
+    # local source="${BASH_SOURCE[0]}"
+    local source="$0"
+    while [ -h "$source" ] ; do
+        local linked="$(readlink "$source")"
+        local dir="$( cd -P $(dirname "$source") && cd -P $(dirname "$linked") && pwd )"
+        source="$dir/$(basename "$linked")"
+    done
+    ( cd -P "$(dirname "$source")" && pwd )
+}
+
+getOS() {
+    local os
+    case "$(uname -s)" in
+        Linux*)  os=Linux;;
+        Darwin*) os=Mac;;
+        CYGWIN*) os=Win;; # os=Cygwin;;
+        MINGW*)  os=Win;; # os=MinGw;;
+        *)       os=Unknown
+    esac
+    echo $os
+}
+
+getSubtitle() {
+    local subtitle="Internal Draft"
+    local hash=$GIT_HASH
+    if [ $hash ]; then
+        echo "$subtitle (rev ${hash:0:10})"
+    else
+        local git_url="https://github.com/lampepfl/dotty.git"
+        local git=git$EXT
+        local git_cmd="$(command -v $git)"
+        if [ -x "$git_cmd" ]; then
+            hash=$($git_cmd ls-remote $git_url master 2>/dev/null)
+        else
+            git_cmd="$GIT_HOME/bin/$git"
+            [ -x "$git_cmd" ] && hash=$($git_cmd ls-remote $git_url master 2>/dev/null)
+        fi
+        [ $hash ] && echo "$subtitle (rev ${hash:0:10})" || echo "$subtitle"
+    fi
+}
+
+##############################################################################
+## Environment setup
+
+PROG_HOME="$(getHome)"
+
+OS="$(getOS)"
+[ $OS == "Unknown" ] && { echo "Unsuppored OS" 1>&2; exit 1; }
+[ $OS == "Win" ] && EXT=".exe" || EXT=""
+
+PANDOC=pandoc$EXT
+PANDOC_CMD="$(command -v $PANDOC)"
+if ! [ -x "$PANDOC_CMD" ]; then
+    case $OS in
+        Win) PANDOC_CMD=$PANDOC_HOME/$PANDOC ;;
+        *)   PANDOC_CMD=$PANDOC_HOME/bin/$PANDOC
+    esac
+    [ -x "$PANDOC_CMD" ] || { echo "$PANDOC executable not found" 1>&2; exit 1; }
+fi
+
+LATEX=lualatex$EXT
+## We only consider commands from the installation directory defined by TEXLIVE_HOME
+LATEX_CMD="$(command -v $LATEX)"
+if ! [ -x "$LATEX_CMD" ]; then
+    case $OS in
+        Win) LATEX_CMD=$TEXLIVE_HOME/bin/win32/$LATEX ;;
+        Mac) LATEX_CMD=$TEXLIVE_HOME/bin/x86_64-darwin/$LATEX ;;
+        *)   LATEX_CMD=$TEXLIVE_HOME/bin/x86_64-linux/$LATEX
+    esac
+    [ -x "$LATEX_CMD" ] || { echo "$LATEX executable not found" 1>&2; exit 1; }
+fi
+
+SOURCE_DIR=$(dirname "$PROG_HOME")/docs/docs
+DATA_DIR=$PROG_HOME/data
+IMAGES_DIR=$DATA_DIR/images
+TARGET_DIR=$(dirname "$PROG_HOME")/out/pandoc
+
+DEBUG=0
+
+if [ $# -eq 0 ]; then
+    PROJECT_NAME=reference
+	GIT_HASH=
+else
+    case $1 in
+    internals) PROJECT_NAME=internals ;;
+    reference) PROJECT_NAME=reference ;;
+    usage)     PROJECT_NAME=usage ;;
+    *)         echo "Unknown option \"$1\"" 1>&2; exit 1;
+    esac
+	GIT_HASH="$2"
+fi
+[ -d "$SOURCE_DIR/$PROJECT_NAME" ] || { echo "directory \"$PROJECT_NAME/\" not found" 1>&2; exit 1; }
+
+OUTPUT_FILE=$TARGET_DIR/scala3_$PROJECT_NAME.pdf
+
+INPUT_FILE=$DATA_DIR/$PROJECT_NAME.md
+[ -f "$INPUT_FILE" ] || { echo "Main Markdown file not found" 1>&2; exit 1; }
+
+DEFAULTS_FILE=$DATA_DIR/defaults.yaml
+[ -f "$DEFAULTS_FILE" ] || { echo "Pandoc defaults file not found" 1>&2; exit 1; }
+
+TEMPLATE_FILE=$DATA_DIR/templates/template.tex
+[ -f "$TEMPLATE_FILE" ] || { echo "Pandoc template file not found" 1>&2; exit 1; }
+
+SYNTAX_FILE=$DATA_DIR/templates/scala.xml
+[ -f "$SYNTAX_FILE" ] || { echo "Kate syntax file not found" 1>&2; exit 1; }
+
+SUBTITLE="$(getSubtitle)"
+TODAY="$(LC_ALL=en_US date +'%d %B %Y')"
+
+PANDOC_OPTS="--data-dir=$DATA_DIR"
+PANDOC_OPTS="$PANDOC_OPTS --defaults=$DEFAULTS_FILE"
+PANDOC_OPTS="$PANDOC_OPTS --syntax-definition=$SYNTAX_FILE"
+PANDOC_OPTS="$PANDOC_OPTS -V geometry=a4paper -V geometry:margin=30mm"
+## DejaVuSerif font fails to display greek characters correctly (e.g. β-reduce) 
+# PANDOC_OPTS="$PANDOC_OPTS -V mainfont:DejaVuSerif.ttf
+# PANDOC_OPTS="$PANDOC_OPTS -V mainfont:FreeSerif.ttf"
+# PANDOC_OPTS="$PANDOC_OPTS -V sansfont:DejaVuSans.ttf"
+# PANDOC_OPTS="$PANDOC_OPTS -V monofont:DejaVuSansMono.ttf
+# PANDOC_OPTS="$PANDOC_OPTS -V mathfont:texgyredejavu-math.otf"
+PANDOC_OPTS="$PANDOC_OPTS -V fontsize=12pt"
+## see https://www.htmlcsscolor.com/hex/66001E
+PANDOC_OPTS="$PANDOC_OPTS -V urlcolor=blue -V linkcolor=[HTML]{66001E}"
+PANDOC_OPTS="$PANDOC_OPTS -V subtitle='$SUBTITLE' -V date='$TODAY'"
+PANDOC_OPTS="$PANDOC_OPTS --template=$TEMPLATE_FILE"
+PANDOC_OPTS="$PANDOC_OPTS --pdf-engine=$LATEX_CMD"
+PANDOC_OPTS="$PANDOC_OPTS --output=$OUTPUT_FILE"
+
+[ $DEBUG ] && PANDOC_OPS="--verbose $PANDOC_OPTS" || PANDOC_OPTS="--quiet $PANDOC_OPTS"
+
+##############################################################################
+## Main
+
+[[ -d "$TARGET_DIR" ]] || mkdir -p "$TARGET_DIR"
+
+## copy image files to target directory
+if [[ -d "$IMAGES_DIR" ]]; then
+    TARGET_IMAGES_DIR=$TARGET_DIR/images
+    [ -d "$TARGET_IMAGES_DIR" ] || mkdir -p "$TARGET_IMAGES_DIR"
+    [ $DEBUG ] && echo "Copy image files to directory \"${TARGET_IMAGES_DIR/$PROG_HOME\//}\"" 1>&2
+    cp -r "$IMAGES_DIR" "$TARGET_DIR/"
+    [ $? -eq 0 ] || { echo "Failed to copy image files to directory \"$TARGET_IMAGES_DIR\"" 1>&2; exit 1; }
+fi
+
+## transform anchors in Markdown files
+SRC_DIR=$SOURCE_DIR/$PROJECT_NAME
+SRC_MANAGED_DIR=$TARGET_DIR/src_managed/$PROJECT_NAME
+[ -d "$SRC_MANAGED_DIR" ] || mkdir -p "$SRC_MANAGED_DIR"
+
+MD_FILES="$(find "$SRC_DIR" -type f -name "*.md")"
+for f in $MD_FILES; do
+    IN_FILE="$f"
+    OUT_FILE="${IN_FILE/$SRC_DIR/$SRC_MANAGED_DIR}"
+    OUT_DIR="$(dirname $OUT_FILE)"
+    [ -d "$OUT_DIR" ] || mkdir -p "$OUT_DIR"
+    [ $DEBUG ] && echo "Preprocess file \"${IN_FILE/$PROG_HOME\//}\"" 1>&2
+    ## We specifies 2 regexs in case another anchor exists on same line
+    sed -e "s/\[\(.\+\)\](\(.*\/\)*\(.\+\)\.md)/[\1](#\3)/g" -e "s/\[\(.\+\)\](\(.*\/\)*\(.\+\)\.md)/[\1](#\3)/g" $IN_FILE > $OUT_FILE
+
+    ## Markdown file contains image urls
+    #if [[ "$OUT_FILE" =~ -nulls\.md$ ]]; then
+    if [[ "$OUT_FILE" == *-nulls\.md* ]]; then
+        TMP_FILE=$OUT_FILE.tmp
+        cp "$OUT_FILE" "$TMP_FILE"
+        [ $DEBUG ] && echo "Update file \"${OUT_FILE/$PROG_HOME\//}\"" 1>&2
+        ## e.g. ![](../../../images/image.png "Image")
+        sed "s/\!\[\(.*\)\](\(\.\.\/\)*\(.*\))/![\1](\.\.\/out\/pandoc\/\3)/g" $TMP_FILE > $OUT_FILE
+    fi
+done
+
+[ $DEBUG ] && echo "$PANDOC_CMD $PANDOC_OPTS $INPUT_FILE" 1>&2
+if [ $OS == "Win" ]; then
+    ## direct call to Pandoc executable fails in Cygwin/MinGw
+    eval "$PANDOC_CMD $PANDOC_OPTS $INPUT_FILE"
+else
+    eval "$PANDOC_CMD $PANDOC_OPTS $INPUT_FILE"
+fi
+[ $? -eq 0 ] || exit 1
+
+exit 0
diff --git a/pandoc/md2pdf.bat b/pandoc/md2pdf.bat
new file mode 100644
index 000000000000..e189f89fe58e
--- /dev/null
+++ b/pandoc/md2pdf.bat
@@ -0,0 +1,195 @@
+@rem ## Created by mics (https://github.com/michelou/) on December 2020.
+
+@echo off
+setlocal enabledelayedexpansion
+
+@rem #########################################################################
+@rem ## Environment setup
+
+set _EXITCODE=0
+
+call :env
+if not %_EXITCODE%==0 goto end
+
+call :args %*
+if not %_EXITCODE%==0 goto end
+
+@rem #########################################################################
+@rem ## Main
+
+call :compile
+if not %_EXITCODE%==0 goto end
+
+goto end
+
+@rem #########################################################################
+@rem ## Subroutines
+
+:env
+set "_ROOT_DIR=%~dp0"
+
+if not exist "%GIT_HOME%\usr\bin\sed.exe" (
+    echo Error: Git installation not found ^(check variable GIT_HOME^) 1>&2
+    set _EXITCODE=1
+    goto :eof
+)
+set "_SED_CMD=%GIT_HOME%\usr\bin\sed.exe"
+
+if not exist "%PANDOC_HOME%\pandoc.exe" (
+    echo Error: Pandoc 2 installation not found ^(check variable PANDOC_HOME^) 1>&2
+    set _EXITCODE=1
+    goto :eof
+)
+set "_PANDOC_CMD=%PANDOC_HOME%\pandoc.exe"
+
+@rem either 'lualatex.exe' or 'xelatex.exe' (both support UTF-8)
+if not exist "%TEXLIVE_HOME%\bin\win32\lualatex.exe" (
+    echo Error: TexLive installation not found ^(check variable TEXLIVE_HOME^) 1>&2
+    set _EXITCODE=1
+    goto :eof
+)
+set "__LATEX_CMD=%TEXLIVE_HOME%\bin\win32\lualatex.exe"
+
+for %%f in ("%~dp0\.") do set "_SOURCE_DIR=%%~dpfdocs\docs"
+set "_DATA_DIR=%_ROOT_DIR%data"
+set "_IMAGES_DIR=%_DATA_DIR%\images"
+set "_TEMPLATES_DIR=%_DATA_DIR%\templates"
+for %%f in ("%~dp0\.") do set "_TARGET_DIR=%%~dpfout\pandoc"
+
+if not exist "%_DATA_DIR%\defaults.yaml" (
+    echo Error: Pandoc defaults file not found 1>&2
+    set _EXITCODE=1
+    goto :eof
+)
+set "__DEFAULTS_FILE=%_DATA_DIR%\defaults.yaml"
+
+if not exist "%_TEMPLATES_DIR%\template.tex" (
+    echo Error: Pandoc template file not found 1>&2
+    set _EXITCODE=1
+    goto :eof
+)
+set "__TEMPLATE_FILE=%_TEMPLATES_DIR%\template.tex"
+
+if not exist "%_TEMPLATES_DIR%\scala.xml" (
+    echo Error: Kate syntax file not found 1>&2
+    set _EXITCODE=1
+    goto :eof
+)
+set "__SYNTAX_FILE=%_TEMPLATES_DIR%\scala.xml"
+
+set __SUBTITLE=Internal Draft
+for /f "usebackq tokens=1,*" %%i in (`"%GIT_HOME%\bin\git.exe" ls-remote https://github.com/lampepfl/dotty.git master 2^>NUL`) do (
+   set __HASH=%%i
+   set "__SUBTITLE=%__SUBTITLE% (rev !__HASH:~0,10!^)"
+)
+for /f "usebackq delims=" %%d in (`powershell -c "$culture=[CultureInfo]'en-us'; (Get-Date).ToString('dd MMMM yyyy', $culture)"`) do set "__TODAY=%%d"
+
+@rem set _PANDOC_OPTS=--verbose
+set _PANDOC_OPTS=--quiet
+set _PANDOC_OPTS=%_PANDOC_OPTS% --data-dir="%_DATA_DIR%"
+set _PANDOC_OPTS=%_PANDOC_OPTS% --defaults="%__DEFAULTS_FILE%"
+@rem CAUTION: option --syntax-definition does not work with absolute paths
+set _PANDOC_OPTS=%_PANDOC_OPTS% --syntax-definition="!__SYNTAX_FILE:%_ROOT_DIR%=!"
+set _PANDOC_OPTS=%_PANDOC_OPTS% -V geometry=a4paper -V geometry:margin=30mm
+@rem DejaVuSerif font fails to display greek characters correctly (e.g. β-reduce)
+@rem set _PANDOC_OPTS=%_PANDOC_OPTS% -V "mainfont:DejaVuSerif.ttf"
+@rem set _PANDOC_OPTS=%_PANDOC_OPTS% -V "mainfont:FreeSerif.ttf"
+@rem set _PANDOC_OPTS=%_PANDOC_OPTS% -V "sansfont:DejaVuSans.ttf"
+@rem set _PANDOC_OPTS=%_PANDOC_OPTS% -V monofont:DejaVuSansMono.ttf
+@rem set _PANDOC_OPTS=%_PANDOC_OPTS% -V mathfont:texgyredejavu-math.otf
+set _PANDOC_OPTS=%_PANDOC_OPTS% -V fontsize=12pt
+@rem see https://www.htmlcsscolor.com/hex/66001E
+set _PANDOC_OPTS=%_PANDOC_OPTS% -V urlcolor=blue -V linkcolor="[HTML]{66001E}"
+set _PANDOC_OPTS=%_PANDOC_OPTS% -V subtitle="%__SUBTITLE%" -V date="%__TODAY%"
+set _PANDOC_OPTS=%_PANDOC_OPTS% --template="%__TEMPLATE_FILE%"
+set _PANDOC_OPTS=%_PANDOC_OPTS% --pdf-engine="%__LATEX_CMD%"
+goto :eof
+
+@rem input parameter: %*
+@rem output parameters: _INPUT_FILE, _OUTPUT_FILE
+:args
+set "__ARG=%~1"
+if not defined __ARG ( set __PROJECT_NAME=reference
+) else if "%__ARG%"=="reference" ( set __PROJECT_NAME=reference
+) else if "%__ARG%"=="internals" ( set __PROJECT_NAME=internals
+) else if "%__ARG%"=="usage" ( set __PROJECT_NAME=usage
+) else (
+    echo Error: Unknown project %__ARG% ^(expected: internals, reference or usage^) 1>&2
+    set _EXITCODE=1
+    goto :eof
+)
+if not exist "%_DATA_DIR%\%__PROJECT_NAME%.md" (
+    echo Error: Main Markdown file not found 1>&2
+    set _EXITCODE=1
+    goto :eof
+)
+set "_INPUT_FILE=%_DATA_DIR%\%__PROJECT_NAME%.md"
+
+set "_OUTPUT_FILE=%_TARGET_DIR%\scala3_%__PROJECT_NAME%.pdf"
+set _PANDOC_OPTS=%_PANDOC_OPTS% --output="%_OUTPUT_FILE%"
+goto :eof
+
+:compile
+call :compile_images
+if not %_EXITCODE%==0 goto :eof
+
+call :compile_anchors
+if not %_EXITCODE%==0 goto :eof
+
+call "%_PANDOC_CMD%" %_PANDOC_OPTS% "%_INPUT_FILE%"
+if not %ERRORLEVEL%==0 (
+    set _EXITCODE=1
+    goto :eof
+)
+goto :eof
+
+:compile_images
+set "__TARGET_IMAGES_DIR=%_TARGET_DIR%\images"
+
+xcopy /s /y "%_IMAGES_DIR%\*" "%__TARGET_IMAGES_DIR%\" 1>NUL
+if not %ERRORLEVEL%==0 (
+    echo Error: Failed to copy image files to directory "%__TARGET_IMAGES_DIR%" 1>&2
+    set _EXITCODE=1
+    goto :eof
+)
+goto :eof
+
+@rem https://docs.microsoft.com/en-us/powershell/module/microsoft.powershell.core/about/about_comparison_operators#replacement-operator
+:compile_anchors
+set "__SRC_DIR=%_SOURCE_DIR%\%_PROJECT_DIR%"
+set "__SRC_MANAGED_DIR=%_TARGET_DIR%\src_managed\%_PROJECT_DIR%"
+if not exist "%__SRC_MANAGED_DIR%" mkdir "%__SRC_MANAGED_DIR%"
+
+for /f "usebackq delims=" %%f in (`dir /s /b "%__SRC_DIR%\*.md"`) do (
+    set "__IN_FILE=%%f"
+    set "__OUT_FILE=!__IN_FILE:%__SRC_DIR%=%__SRC_MANAGED_DIR%!"
+    for %%i in ("!__OUT_FILE!") do set "__OUT_DIR=%%~dpi"
+    if not exist "!__OUT_DIR!" mkdir "!__OUT_DIR!"
+
+    @rem We specifies 2 regexs in case another anchor exists on same line
+    call "%_SED_CMD%" -e "s/\[\(.\^+\)\](\(.*\/\)*\(.\^+\)\.md)/[\1](#\3)/g" -e "s/\[\(.\^+\)\](\(.*\/\)*\(.\^+\)\.md)/[\1](#\3)/g" "!__IN_FILE!" > "!__OUT_FILE!"
+    if not !ERRORLEVEL!==0 (
+        set _EXITCODE=1
+        goto :eof
+    )
+    @rem Markdown file contains image urls
+    if "!__OUT_FILE:~-9!"=="-nulls.md" (
+        set "__TMP_FILE=!__OUT_FILE!.tmp"
+        copy "!__OUT_FILE!" "!__TMP_FILE!" 1>NUL
+
+        @rem e.g. ![](../../../images/image.png "Image")
+        call "%_SED_CMD%" "s/\^!\[\(.*\)\](\(\.\.\/\)*\(.*\))/^![\1](\.\.\/out\/pandoc\/\3)/g" "!__TMP_FILE!" > "!__OUT_FILE!"
+        if not !ERRORLEVEL!==0 (
+            set _EXITCODE=1
+            goto :eof
+        )
+    )
+)
+goto :eof
+
+@rem #########################################################################
+@rem ## Cleanups
+
+:end
+exit /b %_EXITCODE%
+endlocal
diff --git a/project/Build.scala b/project/Build.scala
index e21956e4c123..f8c2866a6acb 100644
--- a/project/Build.scala
+++ b/project/Build.scala
@@ -1248,12 +1248,9 @@ object Build {
         baseDirectory.value / "../language-server/src/dotty/tools/languageserver/config",
       sbtTestDirectory := baseDirectory.value / "sbt-test",
 
-      // ensure that sbt-dotty is built with sbt 1.4
+      // ensure that sbt-dotty is built on sbt 1.4
       pluginCrossBuild / sbtVersion := "1.4.9",
 
-      // scritped tests are run with current sbt version
-      scriptedSbt := sbtVersion.value,
-
       // The batch mode accidentally became the default with no way to disable
       // it in sbt 1.4 (https://github.com/sbt/sbt/issues/5913#issuecomment-716003195).
       // We enable it explicitly here to make it clear that we're using it.