Awesome
katex-elements
Web Components for easily using KaTeX in HTML
Installation
> npm i katex-elements
Usage
1. Import the elements
From HTML:
Import all the elements:
<script type="module" src="./node_modules/katex-elements/index.js"></script>
Import each element individually:
<script type="module" src="./node_modules/katex-elements/katex-expr.js"></script>
<script type="module" src="./node_modules/katex-elements/katex-display.js"></script>
<script type="module" src="./node_modules/katex-elements/katex-inline.js"></script>
Note: the path to the JavaScript modules may depend on your npm installation
From JavaScript:
Import all the elements:
import {KatexDisplay} from 'katex-elements';
Import each element individually:
import {KatexDisplay} from 'katex-elements/katex-expr.js';
import {KatexDisplay} from 'katex-elements/katex-display.js';
import {KatexInline} from 'katex-elements/katex-inline.js';
Note that this package uses "bare module specifiers" to import the katex
package. You will need a server or bundler that resolves these specifiers to URLs that will work in a browser, such as Rollup or @web/dev-server
.
2. Use the elements
<katex-inline>
Renders its text content in inline mode.
markup:
<katex-inline>c = \pm\sqrt{a^2 + b^2}</katex-inline>
output:
<img src="readme-katex-inline.png"><katex-display>
Renders its text content in display mode, which will put the math in display style (so \int
and \sum
are large, for example), and will center the math in a block element.
markup:
<katex-display>c = \pm\sqrt{a^2 + b^2}</katex-display>
output:
<img src="readme-katex-display.png"><katex-expr>
<katex-expr>
is the base class for <katex-inline>
and <katex-display>
. It renders inline or display based on the display-mode
attribute.
<katex-expr display-mode>c = \pm\sqrt{a^2 + b^2}</katex-expr>