fix(presets): add --mathml to markdown and github pandoc args

Problem: pandoc's default HTML math renderer cannot handle most TeX and
dumps raw LaTeX source into the output. `--mathjax` and `--katex` are
incompatible with `--embed-resources` because pandoc cannot inline
dynamically-loaded JavaScript modules and fonts.

Solution: add `--mathml` to both `markdown` and `github` preset args.
MathML is rendered natively by all modern browsers with no external
dependencies, making it the only math option compatible with
self-contained HTML output.
This commit is contained in:
Barrett Ruth 2026-03-06 13:23:31 -05:00
parent d1fd2b2a73
commit 872a8edd71
Signed by: barrett
GPG key ID: A6C96C9349D2FC81

View file

@ -224,7 +224,7 @@ M.markdown = {
ft = 'markdown',
cmd = { 'pandoc' },
args = function(ctx)
return { ctx.file, '-s', '--embed-resources', '-o', ctx.output }
return { ctx.file, '-s', '--embed-resources', '--mathml', '-o', ctx.output }
end,
output = function(ctx)
return (ctx.file:gsub('%.md$', '.html'))
@ -250,6 +250,7 @@ M.github = {
ctx.file,
'-s',
'--embed-resources',
'--mathml',
'--css',
'https://cdn.jsdelivr.net/gh/pixelbrackets/gfm-stylesheet@master/dist/gfm.css',
'-o',