Fix formatting of Markdown code blocks (#2750) (#2755)

* Fix formatting of Markdown code blocks

* Fix lint

(cherry picked from commit 3599f01)

Co-authored-by: Quentin Pradet <[email protected]>

Author: github-actions[bot]

docs/sphinx/_static/css/custom.css

@@ -0,0 +1,16 @@
+/* Display GitHub Flavored Markdown code blocks correctly */
+
+.rst-content pre {
+  background-color: #f5f5f5;
+  border-radius: 6px;
+  padding: 16px;
+  margin: 16px 0;
+  overflow-x: auto;
+}
+
+.rst-content pre code {
+  background-color: #f5f5f5;
+  white-space: pre;
+  border: none;
+  padding: 0;
+}

docs/sphinx/conf.py

@@ -44,6 +44,8 @@
 pygments_style = "sphinx"
 
 html_theme = "sphinx_rtd_theme"
+html_static_path = ["_static"]
+html_css_files = ["css/custom.css"]
 
 intersphinx_mapping = {
     "python": ("https://docs.python.org/3", None),