diff --git a/lisp/org.el b/lisp/org.el index 947037559..ad2394ae3 100644 --- a/lisp/org.el +++ b/lisp/org.el @@ -3267,7 +3267,7 @@ When using LaTeXML set this option to (string :tag "\nShell command"))) (defcustom org-latex-to-html-convert-command nil - "Command to convert LaTeX fragments to HTML. + "Shell command to convert LaTeX fragments to HTML. This command is very open-ended: the output of the command will directly replace the LaTeX fragment in the resulting HTML. Replace format-specifiers in the command as noted below and use @@ -3275,7 +3275,12 @@ Replace format-specifiers in the command as noted below and use %i: The LaTeX fragment to be converted. For example, this could be used with LaTeXML as -\"latexmlc \\='literal:%i\\=' --profile=math --preload=siunitx.sty 2>/dev/null\"." +\"latexmlc \\='literal:%i\\=' --profile=math --preload=siunitx.sty 2>/dev/null\". + +The LaTeX fragment is replaced as is, without escaping special shell +syntax. It may be necessary to use single-quotes around \\='%i\\=', not +double-quotes. Else a math fragment such as \"$y = 200$\" may be +expanded to \" = 200\"." :group 'org-latex :package-version '(Org . "9.4") :type '(choice