# Notebooks URL: /docs/content/authoring/notebooks/ Section: notebooks -------------------------------------------------------------------------------- Notebooks in Bengal Bengal renders Jupyter notebooks (.ipynb) natively. Drop a notebook into your content directory and it builds as a page—no conversion step, no extra tooling. Tip Tip New to notebooks? Follow the Setup Guide for a step-by-step walkthrough—add your first notebook, configure Download/Binder/Colab, and override metadata. How It Works Add analysis.ipynb to content/docs/ (or any content section) Bengal discovers it via Patitas parse_notebook (zero dependencies, stdlib JSON) Cells become Markdown: markdown cells as-is, code cells as fenced blocks, outputs as HTML The page uses the notebook/single.html template with download badge, kernel info, and optional Binder/Colab links (Colab auto-generated when repo_url is set) Example Notebooks The notebooks below are live examples—they live in this docs site and render as pages. Hello Notebook Minimal demo: one markdown cell, one code cell with output. Content Features Markdown, code, math (E=mc^2), and outputs—the full pipeline. What Gets Rendered Cell Type Result Markdown Rendered as Markdown (headings, lists, bold, math, etc.) Code Fenced code block with syntax highlighting (Rosettes) Code output (stream) <div class="nb-output"><pre>...</pre></div> — compact styling Code output (execute_result) Text as nb-output, images as nb-output--image, HTML as nb-output--html Code output (error) <div class="nb-output nb-output--error"><pre class="notebook-error">...</pre></div> Metadata Notebook metadata flows into page frontmatter: title — from notebook.metadata.title or filename stem type — notebook (for template selection) notebook.kernel_name — e.g. python3 notebook.cell_count — number of cells Override in notebook metadata (Jupyter Book / JupyterLab conventions) or via cascade from section _index.md. Requirements nbformat 4 or 5 — Modern notebooks only No nbformat dependency — Patitas parses JSON with stdlib; Bengal has zero extra deps for notebooks Info Seealso Code Blocks — Syntax highlighting for code cells Math and LaTeX — Inline and block equations in markdown cells Patitas — The parser that powers notebook conversion -------------------------------------------------------------------------------- Metadata: - Author: lbliii - Word Count: 291 - Reading Time: 1 minutes