1
0
silverbullet/website/🔌 KaTeX.md

49 lines
1.3 KiB
Markdown

---
type: plug
uri: github:silverbulletmd/silverbullet-katex/katex.plug.json
repo: https://github.com/silverbulletmd/silverbullet-katex
author: Zef Hemel
---
<!-- #include [[https://raw.githubusercontent.com/silverbulletmd/silverbullet-katex/main/README.md]] -->
# SilverBullet KaTeX plug
## Installation
Run the {[Plugs: Add]} command and paste in: `github:silverbulletmd/silverbullet-katex/katex.plug.json`
That's all!
## Use
Put a latex block in your markdown:
```latex
c = \pm\sqrt{a^2 + b^2}
```
And move your cursor outside of the block to live preview it!
**Note:** [KaTeX](https://katex.org) itself is not bundled with this plug, it pulls the JavaScript, CSS and fonts from the JSDelivr CDN. This means _this plug will not work without an Internet connection_. The reason for this limitation is that it is not yet possible to distribute font files via plugs, and KaTeX depends on specific web fonts.
## Build
Assuming you have Deno and SilverBullet installed, simply build using:
```shell
deno task build
```
Or to watch for changes and rebuild automatically
```shell
deno task watch
```
Then, load the locally built plug, add it to your `PLUGS` note with an absolute path, for instance:
```
- file:/Users/you/path/to/katex.plug.json
```
And run the `Plugs: Update` command in SilverBullet.
<!-- /include -->