upupming / docsify-katex

:symbols: KaTeX support for docsify
https://upupming.site/docsify-katex/docs
MIT License
85 stars 33 forks source link
demo docsify docsify-katex katex katex-support mathjax

docsify-katex

jsdelivr npm bundle size (minified) npm

Add KaTeX support to your docsify project.

Usage

Add docsify-katex JS and CSS scripts to your index.html:

<script src="https://github.com/upupming/docsify-katex/raw/master//cdn.jsdelivr.net/npm/katex@latest/dist/katex.min.js"></script>
<link rel="stylesheet" href="https://github.com/upupming/docsify-katex/blob/master//cdn.jsdelivr.net/npm/katex@latest/dist/katex.min.css" />
<script src="https://github.com/upupming/docsify-katex/raw/master//cdn.jsdelivr.net/npm/marked@4"></script>

<!-- CDN files for docsify-katex -->
<script src="https://github.com/upupming/docsify-katex/raw/master//cdn.jsdelivr.net/npm/docsify-katex@latest/dist/docsify-katex.js"></script>
<!-- or <script src="https://github.com/upupming/docsify-katex/raw/master//cdn.jsdelivr.net/gh/upupming/docsify-katex@latest/dist/docsify-katex.js"></script> -->

Note:

  1. gh/upupming/docsify-katex@latest/dist/docsify-katex.js will always fetch the latest version of docsify-katex on GitHub, you can use it when you want to try the latest dev features.

Demo projects

Name Website Source code
docsify-katex documentation upupming.site/docsify-katex/docs upupming/docsify-katex/docs
Firebook yngtodd.github.io/firebook yngtodd/firebook

If you have an awesome project using docsify-katex and want to share it with others, please leave it at this issue. I will add it here as soon as possible.

LaTeX quick reference

Inspired by

  1. vscode-markdown
  2. yzhang-gh/markdown-it-katex

Credits

  1. KaTeX

Known issues

Making KaTeX work properly with docsify is a hard work, this repo is just a workaround. We used an extra marked instance to do the syntax parsing.