diff --git a/orx-easing/README.md b/orx-easing/README.md
index 5ded2103..ada7322e 100644
--- a/orx-easing/README.md
+++ b/orx-easing/README.md
@@ -32,5 +32,7 @@ val et = Easing.QuadIn.function(t, 0.0, 1.0, 1.0)
 
 <!-- __demos__ -->
 ## Demos
-[DemoEasings01Kt](src/demo/kotlin/DemoEasings01Kt.kt)
-![DemoEasings01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-easing/images/DemoEasings01Kt.png)
\ No newline at end of file
+### DemoEasings01
+[source code](src/demo/kotlin/DemoEasings01.kt)
+
+![DemoEasings01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-easing/images/DemoEasings01Kt.png)
diff --git a/orx-fx/README.md b/orx-fx/README.md
index 2a4fff48..b5c4be32 100644
--- a/orx-fx/README.md
+++ b/orx-fx/README.md
@@ -101,5 +101,7 @@ All distortion effects are opacity preserving
 ![DemoFluidDistort01Kt](https://github.com/openrndr/orx/blob/media/orx-fx/images/DemoFluidDistort01Kt.png
 <!-- __demos__ -->
 ## Demos
-[DemoFluidDistort01Kt](src/demo/kotlin/DemoFluidDistort01Kt.kt)
-![DemoFluidDistort01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-fx/images/DemoFluidDistort01Kt.png)
\ No newline at end of file
+### DemoFluidDistort01
+[source code](src/demo/kotlin/DemoFluidDistort01.kt)
+
+![DemoFluidDistort01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-fx/images/DemoFluidDistort01Kt.png)
diff --git a/orx-gui/README.md b/orx-gui/README.md
index c7b07f78..5d5fa19d 100644
--- a/orx-gui/README.md
+++ b/orx-gui/README.md
@@ -169,7 +169,12 @@ import org.openrndr.extra.parameters.DoubleParameter
 ![DemoSimple01Kt](https://github.com/openrndr/orx/blob/media/orx-gui/images/DemoSimple01Kt.png
 <!-- __demos__ -->
 ## Demos
-[DemoOptions01Kt](src/demo/kotlin/DemoOptions01Kt.kt)
+### DemoOptions01
+[source code](src/demo/kotlin/DemoOptions01.kt)
+
 ![DemoOptions01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-gui/images/DemoOptions01Kt.png)
-[DemoSimple01Kt](src/demo/kotlin/DemoSimple01Kt.kt)
-![DemoSimple01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-gui/images/DemoSimple01Kt.png)
\ No newline at end of file
+
+### DemoSimple01
+[source code](src/demo/kotlin/DemoSimple01.kt)
+
+![DemoSimple01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-gui/images/DemoSimple01Kt.png)
diff --git a/orx-jumpflood/README.md b/orx-jumpflood/README.md
index 6dee3154..ea3de3b5 100644
--- a/orx-jumpflood/README.md
+++ b/orx-jumpflood/README.md
@@ -155,5 +155,7 @@ fun main() = application {
 ```
 <!-- __demos__ -->
 ## Demos
-[DemoSkeleton01Kt](src/demo/kotlin/DemoSkeleton01Kt.kt)
-![DemoSkeleton01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-jumpflood/images/DemoSkeleton01Kt.png)
\ No newline at end of file
+### DemoSkeleton01
+[source code](src/demo/kotlin/DemoSkeleton01.kt)
+
+![DemoSkeleton01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-jumpflood/images/DemoSkeleton01Kt.png)
diff --git a/orx-keyframer/README.md b/orx-keyframer/README.md
index e6627df0..2b66591b 100644
--- a/orx-keyframer/README.md
+++ b/orx-keyframer/README.md
@@ -149,15 +149,32 @@ Supported functions in expressions:
 ![DemoSimpleRepetitions01Kt](https://github.com/openrndr/orx/blob/media/orx-keyframer/images/DemoSimpleRepetitions01Kt.png
 <!-- __demos__ -->
 ## Demos
-[DemoFull01Kt](src/demo/kotlin/DemoFull01Kt.kt)
+### DemoFull01
+[source code](src/demo/kotlin/DemoFull01.kt)
+
 ![DemoFull01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-keyframer/images/DemoFull01Kt.png)
-[DemoScrub01Kt](src/demo/kotlin/DemoScrub01Kt.kt)
+
+### DemoScrub01
+[source code](src/demo/kotlin/DemoScrub01.kt)
+
 ![DemoScrub01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-keyframer/images/DemoScrub01Kt.png)
-[DemoSimple01Kt](src/demo/kotlin/DemoSimple01Kt.kt)
+
+### DemoSimple01
+[source code](src/demo/kotlin/DemoSimple01.kt)
+
 ![DemoSimple01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-keyframer/images/DemoSimple01Kt.png)
-[DemoSimple02Kt](src/demo/kotlin/DemoSimple02Kt.kt)
+
+### DemoSimple02
+[source code](src/demo/kotlin/DemoSimple02.kt)
+
 ![DemoSimple02Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-keyframer/images/DemoSimple02Kt.png)
-[DemoSimpleExpressions01Kt](src/demo/kotlin/DemoSimpleExpressions01Kt.kt)
+
+### DemoSimpleExpressions01
+[source code](src/demo/kotlin/DemoSimpleExpressions01.kt)
+
 ![DemoSimpleExpressions01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-keyframer/images/DemoSimpleExpressions01Kt.png)
-[DemoSimpleRepetitions01Kt](src/demo/kotlin/DemoSimpleRepetitions01Kt.kt)
-![DemoSimpleRepetitions01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-keyframer/images/DemoSimpleRepetitions01Kt.png)
\ No newline at end of file
+
+### DemoSimpleRepetitions01
+[source code](src/demo/kotlin/DemoSimpleRepetitions01.kt)
+
+![DemoSimpleRepetitions01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-keyframer/images/DemoSimpleRepetitions01Kt.png)
diff --git a/orx-mesh-generators/README.md b/orx-mesh-generators/README.md
index 91d4cb03..85e9b75e 100644
--- a/orx-mesh-generators/README.md
+++ b/orx-mesh-generators/README.md
@@ -59,15 +59,32 @@ fun boxMesh(
 ![DemoComplex05Kt](https://github.com/openrndr/orx/blob/media/orx-mesh-generators/images/DemoComplex05Kt.png
 <!-- __demos__ -->
 ## Demos
-[DemoBoxKt](src/demo/kotlin/DemoBoxKt.kt)
+### DemoBox
+[source code](src/demo/kotlin/DemoBox.kt)
+
 ![DemoBoxKt](https://raw.githubusercontent.com/openrndr/orx/media/orx-mesh-generators/images/DemoBoxKt.png)
-[DemoComplex01Kt](src/demo/kotlin/DemoComplex01Kt.kt)
+
+### DemoComplex01
+[source code](src/demo/kotlin/DemoComplex01.kt)
+
 ![DemoComplex01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-mesh-generators/images/DemoComplex01Kt.png)
-[DemoComplex02Kt](src/demo/kotlin/DemoComplex02Kt.kt)
+
+### DemoComplex02
+[source code](src/demo/kotlin/DemoComplex02.kt)
+
 ![DemoComplex02Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-mesh-generators/images/DemoComplex02Kt.png)
-[DemoComplex03Kt](src/demo/kotlin/DemoComplex03Kt.kt)
+
+### DemoComplex03
+[source code](src/demo/kotlin/DemoComplex03.kt)
+
 ![DemoComplex03Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-mesh-generators/images/DemoComplex03Kt.png)
-[DemoComplex04Kt](src/demo/kotlin/DemoComplex04Kt.kt)
+
+### DemoComplex04
+[source code](src/demo/kotlin/DemoComplex04.kt)
+
 ![DemoComplex04Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-mesh-generators/images/DemoComplex04Kt.png)
-[DemoComplex05Kt](src/demo/kotlin/DemoComplex05Kt.kt)
-![DemoComplex05Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-mesh-generators/images/DemoComplex05Kt.png)
\ No newline at end of file
+
+### DemoComplex05
+[source code](src/demo/kotlin/DemoComplex05.kt)
+
+![DemoComplex05Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-mesh-generators/images/DemoComplex05Kt.png)
diff --git a/orx-noise/README.md b/orx-noise/README.md
index 9b7c99e1..14fd8737 100644
--- a/orx-noise/README.md
+++ b/orx-noise/README.md
@@ -169,9 +169,17 @@ val v8 = billow(seed, x, y, z, ::perlinLinear, octaves, lacunarity, gain)
 ![DemoPoissonDiskSamplingKt](https://github.com/openrndr/orx/blob/media/orx-noise/images/DemoPoissonDiskSamplingKt.png
 <!-- __demos__ -->
 ## Demos
-[DemoGradientPerturb2DKt](src/demo/kotlin/DemoGradientPerturb2DKt.kt)
+### DemoGradientPerturb2D
+[source code](src/demo/kotlin/DemoGradientPerturb2D.kt)
+
 ![DemoGradientPerturb2DKt](https://raw.githubusercontent.com/openrndr/orx/media/orx-noise/images/DemoGradientPerturb2DKt.png)
-[DemoGradientPerturb3DKt](src/demo/kotlin/DemoGradientPerturb3DKt.kt)
+
+### DemoGradientPerturb3D
+[source code](src/demo/kotlin/DemoGradientPerturb3D.kt)
+
 ![DemoGradientPerturb3DKt](https://raw.githubusercontent.com/openrndr/orx/media/orx-noise/images/DemoGradientPerturb3DKt.png)
-[DemoPoissonDiskSamplingKt](src/demo/kotlin/DemoPoissonDiskSamplingKt.kt)
-![DemoPoissonDiskSamplingKt](https://raw.githubusercontent.com/openrndr/orx/media/orx-noise/images/DemoPoissonDiskSamplingKt.png)
\ No newline at end of file
+
+### DemoPoissonDiskSampling
+[source code](src/demo/kotlin/DemoPoissonDiskSampling.kt)
+
+![DemoPoissonDiskSamplingKt](https://raw.githubusercontent.com/openrndr/orx/media/orx-noise/images/DemoPoissonDiskSamplingKt.png)
diff --git a/orx-shade-styles/README.md b/orx-shade-styles/README.md
index e0d5ab7f..5410c30d 100644
--- a/orx-shade-styles/README.md
+++ b/orx-shade-styles/README.md
@@ -5,5 +5,7 @@
 ![DemoRadialGradient01Kt](https://github.com/openrndr/orx/blob/media/orx-shade-styles/images/DemoRadialGradient01Kt.png
 <!-- __demos__ -->
 ## Demos
-[DemoRadialGradient01Kt](src/demo/kotlin/DemoRadialGradient01Kt.kt)
-![DemoRadialGradient01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shade-styles/images/DemoRadialGradient01Kt.png)
\ No newline at end of file
+### DemoRadialGradient01
+[source code](src/demo/kotlin/DemoRadialGradient01.kt)
+
+![DemoRadialGradient01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-shade-styles/images/DemoRadialGradient01Kt.png)
diff --git a/orx-time-operators/README.md b/orx-time-operators/README.md
index 40efcc28..dfa1ea9c 100644
--- a/orx-time-operators/README.md
+++ b/orx-time-operators/README.md
@@ -48,7 +48,12 @@ drawer.circle(0.0, 0.0, size.sine(freq, phase))
 ![DemoLFOKt](https://github.com/openrndr/orx/blob/media/orx-time-operators/images/DemoLFOKt.png
 <!-- __demos__ -->
 ## Demos
-[DemoEnvelopeKt](src/demo/kotlin/DemoEnvelopeKt.kt)
+### DemoEnvelope
+[source code](src/demo/kotlin/DemoEnvelope.kt)
+
 ![DemoEnvelopeKt](https://raw.githubusercontent.com/openrndr/orx/media/orx-time-operators/images/DemoEnvelopeKt.png)
-[DemoLFOKt](src/demo/kotlin/DemoLFOKt.kt)
-![DemoLFOKt](https://raw.githubusercontent.com/openrndr/orx/media/orx-time-operators/images/DemoLFOKt.png)
\ No newline at end of file
+
+### DemoLFO
+[source code](src/demo/kotlin/DemoLFO.kt)
+
+![DemoLFOKt](https://raw.githubusercontent.com/openrndr/orx/media/orx-time-operators/images/DemoLFOKt.png)
diff --git a/orx-timer/README.md b/orx-timer/README.md
index 25d805a2..ca0411a7 100644
--- a/orx-timer/README.md
+++ b/orx-timer/README.md
@@ -47,9 +47,17 @@ Note that drawing inside the `repeat` action has no effect. Have a look at the d
 ![DemoTimeOut01Kt](https://github.com/openrndr/orx/blob/media/orx-timer/images/DemoTimeOut01Kt.png
 <!-- __demos__ -->
 ## Demos
-[DemoRepeat01Kt](src/demo/kotlin/DemoRepeat01Kt.kt)
+### DemoRepeat01
+[source code](src/demo/kotlin/DemoRepeat01.kt)
+
 ![DemoRepeat01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-timer/images/DemoRepeat01Kt.png)
-[DemoRepeat02Kt](src/demo/kotlin/DemoRepeat02Kt.kt)
+
+### DemoRepeat02
+[source code](src/demo/kotlin/DemoRepeat02.kt)
+
 ![DemoRepeat02Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-timer/images/DemoRepeat02Kt.png)
-[DemoTimeOut01Kt](src/demo/kotlin/DemoTimeOut01Kt.kt)
-![DemoTimeOut01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-timer/images/DemoTimeOut01Kt.png)
\ No newline at end of file
+
+### DemoTimeOut01
+[source code](src/demo/kotlin/DemoTimeOut01.kt)
+
+![DemoTimeOut01Kt](https://raw.githubusercontent.com/openrndr/orx/media/orx-timer/images/DemoTimeOut01Kt.png)