Fix formatting of Markdown code blocks (#2750)

* Fix formatting of Markdown code blocks

* Fix lint

Author: pquentin

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),