diff --git a/README.md b/README.md
index 04a533fd0..1b7fa7a51 100644
--- a/README.md
+++ b/README.md
@@ -17,4 +17,4 @@ As you make changes your browser should auto-reload within a few seconds.
 
 For contents and style see [contribution guide](CONTRIBUTING.md).
 
-For syntax see [RST/Sphinx Cheatsheet](https://sphinx-tutorial.readthedocs.io/cheatsheet/).
+Content is written in MyST, a superset of CommonMark. For its syntax, see the [MyST docs](https://myst-parser.readthedocs.io/en/latest/syntax/typography.html#syntax-core).
diff --git a/source/conf.py b/source/conf.py
index b6507c03c..e303f9ba2 100644
--- a/source/conf.py
+++ b/source/conf.py
@@ -57,6 +57,7 @@
 # GitHub-style automatic anchors for headings
 myst_heading_anchors = 3
 
+myst_number_code_blocks = [ "nix", "python" ]
 
 copybutton_prompt_text = r"# |\$ "
 copybutton_prompt_is_regexp = True