sphinxcontrib-jsmath
A sphinx extension which renders display math in HTML via JavaScript
Decision gist · record as of 2026-08-14
No, unless you are maintaining an existing Sphinx project that already uses this extension. The package is abandoned with no updates since 2019-01-21, and modern Sphinx installations should use maintained alternatives for math rendering. For new projects, choose a currently supported math extension.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires Python >=3.5 and Sphinx; no guarantee of compatibility with Sphinx versions released after 2019-01-21.
- Low install friction with no runtime dependencies.
- However, the package is abandoned—last released 2019-01-21 with no maintenance since.
License · maintenance · safety
BSD (permissive) — BSD license is permissive and poses no restrictions on use, modification, or redistribution in open-source or commercial projects.
last release 2019-01-21 (2762 days)
0 known vulnerabilities (OSV.dev, 2026-08-14) · 26,617,556 downloads/mo, #876 on PyPI
Alternatives
Verify before relying
pip install sphinxcontrib-jsmath==1.0.1
# In conf.py:
extensions = ['sphinxcontrib.jsmath']
# In .rst:
.. math::
E = mc^2- Whether this extension remains compatible with current Sphinx versions beyond Python 3.5–3.7.
- Whether JavaScript-based math rendering remains the preferred approach versus modern Sphinx alternatives.
- Current browser compatibility and whether jsmath library itself is still maintained.
What it is and what it does
sphinxcontrib-jsmath is a Sphinx extension that handles mathematical notation in HTML documentation by delegating rendering to JavaScript at display time rather than converting equations to images or other static formats. It integrates with Sphinx's math role and directive, allowing you to write standard LaTeX-style math in your documentation source and have it rendered dynamically in the browser.
The extension has no runtime dependencies and installs with minimal friction. However, it has been abandoned since 2019-01-21 and receives no maintenance. It is classified as Production/Stable but should be treated as legacy. If your documentation build is locked to an older Sphinx version and you need JavaScript-based math rendering, it will work; if you are building new projects or upgrading Sphinx, consider whether a maintained alternative better suits your needs.
Use it for
- Rendering mathematical equations in Sphinx HTML documentation without generating image files.
- Enabling client-side math display in web-based documentation where LaTeX rendering is preferred.
- Legacy Sphinx projects that already depend on jsmath and need to maintain existing builds.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
No, unless you are maintaining an existing Sphinx project that already uses this extension.
The package is abandoned with no updates since 2019-01-21, and modern Sphinx installations should use maintained alternatives for math rendering. For new projects, choose a currently supported math extension.
Install
sphinxcontrib-jsmath on PyPI
Before you install
Low install friction with no runtime dependencies. However, the package is abandoned—last released 2019-01-21 with no maintenance since. Use only if your Sphinx documentation setup is stable and requires no updates.
Requires Python >=3.5 and Sphinx; no guarantee of compatibility with Sphinx versions released after 2019-01-21.
License in practice
BSD license is permissive and poses no restrictions on use, modification, or redistribution in open-source or commercial projects.
Quickstart
pip install sphinxcontrib-jsmath==1.0.1
# In conf.py:
extensions = ['sphinxcontrib.jsmath']
# In .rst:
.. math::
E = mc^2Verify before relying
- Whether this extension remains compatible with current Sphinx versions beyond Python 3.5–3.7.
- Whether JavaScript-based math rendering remains the preferred approach versus modern Sphinx alternatives.
- Current browser compatibility and whether jsmath library itself is still maintained.
Package facts
| License | BSD permissive |
| Python support | Supports the current Python release >=3.5 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | None |
| Maintenance | Abandoned 2,762 days since the last release |
| First released | |
| Downloads | 26,617,556 / month, #876 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 5 - Production/StableEnvironment :: ConsoleEnvironment :: Web EnvironmentFramework :: SphinxFramework :: Sphinx :: ExtensionIntended Audience :: DevelopersIntended Audience :: EducationLicense :: OSI Approved :: BSD LicenseOperating System :: OS IndependentProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3.5Programming Language :: Python :: 3.6Programming Language :: Python :: 3.7Topic :: DocumentationTopic :: Documentation :: SphinxTopic :: Text ProcessingTopic :: Utilities |
Evidence: sphinxcontrib_jsmath-1.0.1-py2.py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “sphinx math rendering javascript”
- sphinxcontrib-jsmathA Sphinx extension that renders mathematical display equations in…
- sphinxcontrib-katexA Sphinx extension that renders mathematical equations in HTML…
- sphinx-math-dollarA Sphinx extension that lets you write LaTeX math in reStructuredText…
Give your agent the search over MCP, or paste the wish link into any chat.
More Utilities packages
Converts domain names between Unicode and ASCII-compatible encoding (Punycode) according to IDNA 2008 and Unicode Technical Standard 46, with security validation and broader script coverage than the standard library.
Install it if you work with internationalized domain names, need to validate domains, or use HTTP clients that depend on it transitively.
Detects and normalizes text encoding from unknown or ambiguous sources, supporting all IANA character sets that Python's core library provides codecs for, with the ability to register custom codecs.
Setuptools is a Python build backend and package management tool that handles building, distributing, and installing Python packages, including support for C/C++ extension modules.
Pluggy provides a plugin system that lets you define hook specifications and register implementations to be called in sequence, enabling extensible Python applications without tight coupling.
Install it if you're building an extensible application or framework.
Pygments is a syntax highlighter that colorizes source code and text in over 500 languages and formats, outputting to HTML, LaTeX, RTF, SVG, images, or ANSI terminal sequences.
Install it if you need to display or transform source code.
Six provides utility functions to write Python code that runs on both Python 2.7 and Python 3.3+, smoothing over language differences between the two versions.
See also simple-equ · sphinx-math-dollar · sphinxcontrib-katex · sphinxcontrib-jquery · python-markdown-math · sphinxcontrib-htmlhelp · math-verify · litestar-htmx · passagemath-homfly · manim