Extended MathJax

approved

by Xavier Denis & Ng Wei En

Enable additional MathJax packages and adds a global preamble for MathJax.

★ 183 stars↓ 53,153 downloadsUpdated 3y agoMIT
View on GitHub

Obsidian Extended MathJax

This plugin extends the MathJax support in Obsidian with a MathJax preamble file which is loaded at startup. It also enables some additional MathJax extensions (notably mhchem and bussproofs).

The preamble is stored in a preamble.sty file in the root of the vault.

Installation

  1. Install 'Extended MathJax' from the Obsidian community plugin browser or by navigating to this link: obsidian://show-plugin?id=obsidian-latex.
  2. Create a preamble.sty file in the root of your vault using your choice of text editor.
  3. Add your macros to preamble.sty

Changing your preamble

If you make changes to your preamble you will need to run the command "Reload app without saving". This will reload all your Obsidian plugins and your preamble.

Help, my preamble is not read!

There are two common reasons why your preamble is not read:

  1. preamble.sty needs to be present before running "Reload app without saving". If it is not present on startup, the plugin will disable itself and you need to manually enable it again.
  2. Make sure the preamble is indeed named preamble.sty (with the correct file extension .sty).
    • Within Obsidian, check that the preamble matches the top row and not the bottom row: image
    • Check that your file browser does not hide file extensions (e.g. default behaviour in Windows' File Explorer).

Example

Look at examples/stlc for an example of an obsidian vault using a preamble to define custom macros.

For plugin developers

Search results and similarity scores are powered by semantic analysis of your plugin's README. If your plugin isn't appearing for searches you'd expect, try updating your README to clearly describe your plugin's purpose, features, and use cases.