diff --git a/doc/preview.txt b/doc/preview.txt
index ed3c13e..fb133d8 100644
--- a/doc/preview.txt
+++ b/doc/preview.txt
@@ -197,13 +197,19 @@ The `markdown` and `github` presets use `--mathml` by default, which converts
 TeX math to native MathML markup rendered by the browser. This is the only
 math option compatible with `--embed-resources` (self-contained HTML).
 
-`--mathjax` and `--katex` insert `<script>` tags that load JavaScript and
-fonts from a CDN at runtime. Pandoc's `--embed-resources` cannot inline these
-dynamic dependencies, so math fails to render in the output.
+`--katex` and `--mathjax` load fonts and JavaScript from a CDN. With
+`--embed-resources`, pandoc inlines these dependencies — KaTeX adds ~15s of
+compile time and ~1.7MB to the output; MathJax fails entirely because it
+loads modules dynamically at runtime (pandoc/pandoc#682).
 
-To use KaTeX or MathJax instead, override `args` to drop `--embed-resources`
-(the output will require internet access). For example, to work with
-github-flavored markdown (gfm): >lua
+KaTeX via `extra_args` (simple, slow — self-contained output): >lua
+
+    vim.g.preview = {
+      github = { extra_args = { '--katex' } },
+    }
+<
+
+KaTeX via `args` override (fast — requires internet): >lua
 
     vim.g.preview = {
       github = {