diff --git a/docs/gen_ref_pages.py b/docs/gen_ref_pages.py
index 2893888804ad0c3670200df5f3c18a3f988dbf65..af1a47724e40db0968693254899a2d3228ff2609 100644
--- a/docs/gen_ref_pages.py
+++ b/docs/gen_ref_pages.py
@@ -32,11 +32,9 @@ for directory in ["src"]:
 
             identifier = ".".join(parts)
             if "calcat_interface" == full_doc_path.stem:
-                print(  # adding an note and image for calcat_interface.py
-    """
-    ??? Note "This module help in skipping calibrationDBRemote"
-        ![Calibration DB Remote avoided](xfel-calibrate_cli_process_no_caldbremote.png)
-    """,
+                # adding an note and image for calcat_interface.py
+                print("""??? Note "This module help in skipping calibrationDBRemote"\n\t[Calibration DB Remote avoided](xfel-calibrate_cli_process_no_caldbremote.png)
+                      """,
                     file=fd)
             print("::: " + "src." + identifier, file=fd)
 
diff --git a/docs/operation/available_notebooks.md b/docs/operation/available_notebooks.md
index 8251b83cccfe3f765c62293f2959203721f3798a..4b517c510d12fd97f60e0b92be4bf5ab7bcf9e34 100644
--- a/docs/operation/available_notebooks.md
+++ b/docs/operation/available_notebooks.md
@@ -277,7 +277,7 @@ The following notebook provides gain characterization for the pnCCD. It relies o
 
 ??? warning "No description"
 
-    TODO: Add description for this notebook
+      TODO: Add description for this notebook
 
 ---------------------------------------------------------------------------------------
 
@@ -303,7 +303,7 @@ Dark characterization evaluates offset and noise of the detector and gives infor
 
 ??? warning "Detector notebooks are outdated."
 
-   FastCCD notebooks are outdated as the detector hasn't been used for years.
+      FastCCD notebooks are outdated as the detector hasn't been used for years.
 
 ### [FastCCD Data Correction](https://git.xfel.eu/calibration/pycalibration/-/blob/master/notebooks/FastCCD/CorrectionNotebook_NewDAQ_FastCCD_NBC.ipynb)