# ipynb2html-core
> Convert Jupyter Notebook to static HTML
Latest version **0.4.0-rc.1** (published 2022-10-25) · MIT license · 0 weekly downloads
## Install
```sh
npm install ipynb2html-core
pnpm add ipynb2html-core
yarn add ipynb2html-core
bun add ipynb2html-core
```
## Health
**Score 25/100 (F)** — status: abandoned.
Positive: has types; no vulnerabilities; high quality score.
Warnings: low downloads; no esm support; pre 1.0.
Negative: abandoned; low maintenance score.
## Facts
| | |
|---|---|
| Version | 0.4.0-rc.1 |
| Published | 2022-10-25 |
| First published | 2019-10-19 |
| Weekly downloads | 0 |
| License | MIT |
| TypeScript types | bundled |
| Module format | CommonJS |
| Node | >=10.13.0 |
| Dependencies | 0 |
| Unpacked size | 92.5 KB |
| Known vulnerabilities | 0 |
| Install scripts | no |
| GitHub stars | 41 |
| Author | Jakub Jirutka |
| Maintainers | jirutka |
| Keywords | converter, html, ipython, jupyter, notebook |
## Links
- npm: https://www.npmjs.com/package/ipynb2html-core
- Repository: https://github.com/jirutka/ipynb2html
- Issues: https://github.com/jirutka/ipynb2html/issues
- npm.io page: https://npm.io/package/ipynb2html-core
## Alternatives
- [@tsparticles/shape-image](https://npm.io/package/@tsparticles/shape-image.md) — 303.7K weekly downloads
- [@tsparticles/shape-line](https://npm.io/package/@tsparticles/shape-line.md) — 233.7K weekly downloads
- [stringify-attributes](https://npm.io/package/stringify-attributes.md) — 58.6K weekly downloads
- [mobile-drag-drop](https://npm.io/package/mobile-drag-drop.md) — 46.3K weekly downloads
- [@comunica/actor-rdf-parse-html](https://npm.io/package/@comunica/actor-rdf-parse-html.md) — 29.2K weekly downloads
## Recent versions
- 0.4.0-rc.1 (latest) — 2022-10-25
- 0.3.0 — 2020-10-28
- 0.2.1 — 2020-04-10
- 0.2.0 — 2020-04-08
- 0.1.0 — 2020-01-23
- 0.1.0-beta.8 — 2019-10-29
- 0.1.0-beta.7 — 2019-10-23
- 0.1.0-beta.6 — 2019-10-19
## README
ipynb2html is a converter (renderer) of the [Jupyter Notebook
Format](https://nbformat.readthedocs.io/en/stable/) 4.0+ to static HTML.
It works both in Node.js and browser environment.
Packages
--------
This repository contains the following packages, all published on
[npm](https://www.npmjs.com/).
### ipynb2html-core
This package provides the converter itself and some utilities with **no
dependencies**. You have to provide your own syntax highlighter and
Markdown, math and ANSI sequences renderer; or not, if you don’t need
them.
### ipynb2html
This package builds on the ipynb2html-core and provides a complete,
ready-to-go renderer configured with:
- [marked](https://github.com/markedjs/marked) as Markdown renderer,
- [KaTeX](https://github.com/KaTeX/KaTeX) as math renderer,
- [anser](https://github.com/IonicaBizau/anser) as ANSI sequences
renderer,
- [highlight.js](https://github.com/highlightjs/highlight.js) as
syntax highlighter.
It also provides a reference stylesheet which you can find in
`dist/notebook.min.css` (or non-minified
[`styles/notebook.css`](packages/ipynb2html/styles/notebook.css)).
### ipynb2html-cli
This package provides a CLI interface for ipynb2html.
Usage
-----
### CLI
ipynb2html notebook.ipynb notebook.html
Run `ipynb2html --help` for more information.
### Node.js (server-side)
To render HTML in Node.js (server-side rendering), you need some (fake)
DOM implementation. The recommended one is
[nodom](https://github.com/redom/nodom/) — it’s lightweight,
[small](https://bundlephobia.com/result?p=nodom), doesn’t have any
external dependencies and ipynb2html is tested against it. However, you
can choose any other if you like.
npm install ipynb2html nodom
``` js
import * as fs from 'fs'
import * as ipynb from 'ipynb2html'
import { Document } from 'nodom'
const renderNotebook = ipynb.createRenderer(new Document())
const notebook = JSON.parse(fs.readFileSync('./example.ipynb', 'utf8'))
console.log(renderNotebook(notebook).outerHTML)
```
### Browser (client-side)
You have basically two options how to use ipynb2html in the browser: use
the browser bundles provided in the ipynb2html package, or build your
own bundle (using e.g. [Rollup](https://rollupjs.org) or
[webpack](https://webpack.js.org/)).
The provided bundles are in UMD format (AMD, CommonJS and IIFE in one
file), so they should work in all environments (old and modern browsers,
Node.js). They are transpiled and have injected
[core-js](https://github.com/zloirock/core-js/) polyfills to be
compatible with browsers that have [>0.5% global coverage, Firefox
ESR, and not dead
browsers](https://browserl.ist/?q=%3E0.5%25%2C+Firefox+ESR%2C+not+dead).
#### Full Bundle
`ipynb2html-full.min.js` is a self-contained bundle with all the
external dependencies included (marked, KaTeX, Anser and Highlight.js).
You can link it from [jsDelivr CDN](https://www.jsdelivr.com/), for
example:
``` html
...
```
The bundle exposes global variable `ipynb2html`:
``` js
const element = ipynb2html.render(notebook)
document.body.appendChild(element)
```
ipynb2html also provides function `autoRender` that renders each
notebook on the page embedded (as JSON) inside
``.[1]
``` html
```
#### Slim Bundle
`ipynb2html.min.js` contains only ipynb2html and ipynb2html-core code
(plus polyfills). If you load marked, KaTeX, AnsiUp, and Highlight.js in
the page, you will get the same functionality as with
`ipynb2html-full.min.js`:
``` html
...
```
Or you may use any other implementations and provide them to the
`ipynb2html.createRenderer` function. All of them are optional, but you
usually need at least a Markdown renderer.
Credits
-------
- The renderer module is originally based on
[notebookjs](https://github.com/jsvine/notebookjs) 0.4.2 developed
by [Jeremy Singer-Vine](https://github.com/jsvine) and distributed
under the [MIT License](http://opensource.org/licenses/MIT/).
- The mathExtractor module is based on
[mathjaxutils.js](https://github.com/jupyter/notebook/blob/6.0.1/notebook/static/notebook/js/mathjaxutils.js)
from the [Jupyter Notebook](https://github.com/jupyter/notebook)
6.0.1 distributed under the [Modified BSD
License](https://github.com/jupyter/notebook/blob/6.0.1/COPYING.md).
License
-------
This project is licensed under [MIT
License](http://opensource.org/licenses/MIT/). For the full text of the
license, see the [LICENSE](LICENSE) file.
[1] Don’t forget to escape HTML special characters: `<`, `>`, and `&`.
---
_Source: https://npm.io/package/ipynb2html-core · Machine-readable twin of the npm.io package page. Health data is recomputed on every publish._