docsify-latex

A docsify.js plugin for typesetting LaTeX with display engines from markdown.

Docsify + LaTeX = ❤️

Installation

Add JavaScript LaTeX display engine, and docsify-latex plugin after docsify and engine scirpts all to your index.html.

For example, I recommend MathJax, and load scripts from the content delivery network (CDN):

<!-- Docsify v4 -->
<script src="//cdn.jsdelivr.net/npm/docsify@4"></script>
<!-- LaTeX display engine -->
<script src="//cdn.jsdelivr.net/npm/mathjax@3/es5/tex-mml-chtml.js"></script>
<!--  docsify-latex plugin -->
<script src="//cdn.jsdelivr.net/npm/docsify-latex@latest/dist/docsify-latex.js"></script>

Configure latex plugin options:

window.$docsify = {
  // ...
  latex: {
    inlineMath   : [['$', '$'], ['\\(', '\\)']], // default
    displayMath  : [['$$', '$$']],               // default
  }
};

Notice:

You should put docsify-latex plugin script below docsify and LaTeX display engine scripts, because plugin script depends on them.

To keep loading scripts in order, you also should remove async attribute from the script element.

See Documentation site for more usage and more details.

Usage

Put LaTeX within symbols you configured.

For example, by default we configured $$ for marking section inner LaTeX in display mode, then:

$$
E=mc^2
$$

Go to display engine official website for more details about supported LaTeX functions.

See Documentation site for more usage and more details.

Demos

Notes-ML-AndrewNg

Features

This plugin helps you typeset LaTeX with some JavaScript LaTeX display engines.

List of integrated engines:

• MathJax V3
• MathJax V2
• KaTeX

If you want to integrate more, feel free to fire an issue to explain the reason, or more well, you can directly make a pull request.

Supported engine features:

• Equation cross-reference jump (same page only)
• Handling complex LaTeX

License

This project is licensed under the MIT License.

See the LICENSE for details.

Copyright (c) Scruel Tao (@scruel)