Registry / web-framework / jupyterlab-mathjax3

jupyterlab-mathjax3

library4.3.0pypypiunverified

A JupyterLab extension that renders LaTeX math using MathJax version 3. Provides improved performance and modern rendering compared to the default MathJax 2 renderer. Current version 4.3.0 (requires Python >=3.6) with a history of breaking changes across major releases (v2->v3, v3->v4).

web-framework ai-ml

pip install jupyterlab-mathjax3

github ↗package ↗

INSTALL

IMPORT

SIG · JUPYTERLAB-MATHJAX

jupyterlab-mathjax3

web-frameworkpythonv4.3.0

Install

1.6s avg

Import

—

Disk

17MB

Pass rate

10/ 10

Env Coverage10 / 10

glibc

3.9–3.13

musl

3.9–3.13

Install & Compatibility

Where this runs

tested against v4.3.0 · pip install

no network on importno background threads

Install × environment matrix

Each cell = how many times install + import succeeded across repeated harness runs. Partial = flaky.
glibc = Debian/Ubuntu slim · musl = Alpine Linux

musl

py 3.10–3.95 runs

installs and imports cleanly · install 0.0s · import 0.000s · 19MB

glibc

py 3.10–3.95 runs

installs and imports cleanly · install 1.6s · import 0.000s · 20MB

17MB installed

● package 17MB

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

MathJax3Extension

✓ from jupyterlab_mathjax3 import MathJax3Extension

✗ from jupyterlab_mathjax3 import MathJax3Extension

Enable MathJax 3 as the default renderer via JupyterLab settings. The extension activates automatically when installed.

# Create a JupyterLab settings file to enable MathJax 3 import json import os settings = { "renderer": "MathJax 3", "latex": { "inlineMath": [["$", "$"], ["\$", "\$"]], "displayMath": [["$$", "$$"], ["\\[", "\\]"]] } } os.makedirs(os.path.expanduser("~/.jupyter/lab/user-settings/@jupyterlab/mathjax3-extension/"), exist_ok=True) with open(os.path.expanduser("~/.jupyter/lab/user-settings/@jupyterlab/mathjax3-extension/plugin.jupyterlab-settings"), 'w') as f: json.dump(settings, f) print("MathJax 3 configured as renderer")

Debug

Known issues

breakingIn v4, the settings schema changed. The 'renderer' setting is now a string instead of an object. Old settings may cause errors if not updated.

fix

Update user settings to use 'renderer': 'MathJax 3' (string) instead of the previous object format.

affects: 4.0.0 - 4.3.0

deprecatedPython 3.6 and 3.7 are no longer supported. Upgrade to Python 3.8+ if you encounter import errors.

fix

Use Python 3.8 or later. Python 3.6 support was dropped in v4.

affects: >=4.0.0

gotchaCommon mistake: Users try to import 'jupyterlab_mathjax3' in notebooks to programmatically configure it. The extension works via JupyterLab settings, not Python imports. Importing the module does not enable the renderer.

fix

Configure MathJax 3 via JupyterLab settings (see quickstart). Do not rely on Python imports for activation.

affects: all

Upgrade

Version history

4.3.0latest on PyPI · released Jan 17, 2022

Audit

Dependencies

jupyterlaboptionalthe extension is a JupyterLab plugin

Agent activity

4 hits · last 30 days

node

Resources

githubhttps://github.com/jupyterlab/jupyter-renderers ↗

packagehttps://pypi.org/project/jupyterlab-mathjax3/ ↗