diff --git a/README.md b/README.md
index 526cb02b..5b7055b2 100644
--- a/README.md
+++ b/README.md
@@ -2,6 +2,13 @@
 
 The JavaScript library for tailored creative coding.
 
+- [Charming: Charming Computing](https://observablehq.com/d/dd59b4c4f9f1d9d3) - a detailed introduction
+- [What is Charming](https://observablehq.com/d/477368f7e5423ff6) - a brief introduction
+- [Why Charming](https://observablehq.com/d/535654add5972bd2) - motivation
+- [How is Charming](https://observablehq.com/d/c5e87fb195e2166d) - features
+- [Examples](https://observablehq.com/d/2f9bf9f52cb24090) - for released version
+- [Examples](https://observablehq.com/d/18b3d6f3affff5bb) - for developing version
+
 <img alt="examples" src="./img/examples.png" />
 
 > [!NOTE]