On Sat, 25 May 2024 13:32:31 +0300
Lassi Kortela <xxxxxx@lassi.io> wrote:

>    #markup("# Title
>
>             paragraph")

Why not use normal string that will be simple to implement and put special
syntax inside the string as part of the markup that tools that generate
documentation will understand like:

"#!markdown

 # Title

 Paragraph"

With this when new documentation language will be create there will be no
need to change the Scheme interpreter to support it. Scheme code will be the
same only the tool will change. When some tool will support LaTeX you only
need:

"#!latext

\section*{This is the title}

 Paragraph"

The tool that generate documentation can even allow to write plugins for
those markup languages, so the tool also could stay the same and person that
write documentation for new Scheme that he just created can invent his own
markup languages and plug into the tool.

--
Jakub T. Jankiewicz, Senior Front-End Developer
https://jcubic.pl/me
https://lips.js.org
https://koduj.org