pandoc 给讲师/读者的评论和笔记

例如，当使用pandoc将 Markdown 文件转换为 pdf 文件进行讲座时，除了评论之外的所有内容

<!---
comment
-->

将出现在输出 pdf 文件中。

但是有没有更优雅的方式在源 Markdown 文件中添加注释而不是使用此类注释？也许生成两个输出文件：

• 一个带有幻灯片的 pdf 文件，供内容较少的观众使用
• 一个带有注释和注释的 pdf 文件，供讲师/读者阅读，内容更多

是否已经有机制、标签、命令等？或者这样的评论是要走的路吗？

目前我在 KUBUNTU 20 上使用以下设置，但我不需要坚持下去。我需要的只是最后的幻灯片 pdf 和注释 pdf 文件（或带有附加文本的幻灯片）：

依赖项：

• 潘多克
• XeTeX（带sudo apt install texlive-xetex）
• latexmk（带sudo apt install latexmk）
• mtheme全局安装make install

项目结构：

• slides.md用 Markdown 编写的带有演示内容的文件，例如

---
author: Author
title: Presentation Title
date: \today
---

# first chapter

## sub title

<!---
a comment for `point 1` with additional information to
say but not to display for the listeners.
-->
- point 1

<!---
a comment for `point 2` with additional information to
say but not to display for the listeners.
-->
- point 2

• 一个类似的makefile东西：

default:
    @pandoc -t beamer -H settings.tex \
        --pdf-engine=xelatex --highlight-style=espresso \
        -V lang=en -V theme:metropolis \
        -o dist/output.pdf slides.md

• 和settings.tex：

%% Metro Settings
\metroset{numbering=fraction,
            progressbar=frametitle,
            background=dark,
            block=fill}