diff --git a/.github/workflows/build_docs.yml b/.github/workflows/build_docs.yml
deleted file mode 100644
index e0c9ef6..0000000
--- a/.github/workflows/build_docs.yml
+++ /dev/null
@@ -1,22 +0,0 @@
-name: sphinx-docs
-
-on:
-  push:
-  pull_request:
-
-jobs:
-  build:
-    runs-on: ubuntu-latest
-    steps:
-      - uses: actions/checkout@v2
-      - name: Set up Python
-        uses: actions/setup-python@v4
-        with:
-          python-version: "3.11"
-      - name: Install dependencies
-        run: |
-          python -m pip install --upgrade pip
-          pip install -r docs/requirements.txt
-
-      - name: Build documentation
-        run: cd docs && make html
diff --git a/docs/requirements.txt b/docs/requirements.txt
index db72b7b..2b919fd 100644
--- a/docs/requirements.txt
+++ b/docs/requirements.txt
@@ -1,3 +1,4 @@
 sphinx
+nbsphinx
 myst-parser
 furo
diff --git a/docs/source/conf.py b/docs/source/conf.py
index 779af44..5678883 100644
--- a/docs/source/conf.py
+++ b/docs/source/conf.py
@@ -3,7 +3,8 @@
 author = 'Fabiola Curion, Xichen Wu, Lukas Heumos'
 release = '1.0.0'
 
-extensions = ['myst_parser']
+extensions = ['myst_parser',
+              'nbsphinx']
 
 source_suffix = {
     '.rst': 'restructuredtext',
@@ -13,8 +14,9 @@
 
 templates_path = ['_templates']
 
-exclude_patterns = []
+exclude_patterns = ['_build', '**.ipynb_checkpoints']
 
 html_theme = "furo"
+html_static_path = ['_static']
 
-html_static_path = ['_static']
\ No newline at end of file
+nbsphinx_execute = 'never'
diff --git a/notebook.ipynb b/docs/source/hadge_output.ipynb
similarity index 99%
rename from notebook.ipynb
rename to docs/source/hadge_output.ipynb
index ecd6e92..ac881e7 100644
--- a/notebook.ipynb
+++ b/docs/source/hadge_output.ipynb
@@ -1,5 +1,12 @@
 {
  "cells": [
+  {
+   "cell_type": "markdown",
+   "metadata": {},
+   "source": [
+    "# Working with hadge output"
+   ]
+  },
   {
    "cell_type": "code",
    "execution_count": 1,
@@ -16,7 +23,7 @@
    "cell_type": "markdown",
    "metadata": {},
    "source": [
-    "This notebook serves to get familiar with the ouput of hadge and reproduce some figures from the manuscript."
+    "This notebook serves to get familiar with the output of hadge and reproduce some figures from the manuscript."
    ]
   },
   {
diff --git a/docs/source/index.md b/docs/source/index.md
index fb0656e..6d74528 100644
--- a/docs/source/index.md
+++ b/docs/source/index.md
@@ -56,7 +56,7 @@ nextflow run main.nf -profile test
 
 ## Notebook
 
-Check[](../../notebook.ipynb) to get familiar with the output of hadge.
+Check[](hadge_output.ipynb) to get familiar with the output of hadge.
 
 ## **Pipeline output**
 
@@ -98,6 +98,7 @@ general
 genetic
 hashing
 rescue
+hadge_output
 ```
 
 # Indices and tables