diff --git a/README.md b/README.md
index f35c4999..e52fde49 100644
--- a/README.md
+++ b/README.md
@@ -104,27 +104,39 @@ d = sierpinski(5, 4).fill_color(papaya)
 
 ![sierpinski](https://raw.githubusercontent.com/danoneata/chalk/master/examples/output/intro-04.png)
 
-For more examples, please check the `examples` folder.
+### Gallery of examples
+
+For more examples, please check the `examples` folder;
+their output is illustrated below:
+
+<table>
+<tr>
+<td align="center"><img src="doc/imgs/squares.png"><br><code><a href="https://github.com/danoneata/chalk/tree/master/examples/squares.py">squares.py</a></code></td>
+<td align="center"><img src="doc/imgs/logo.png"><br><code><a href="https://github.com/danoneata/chalk/tree/master/examples/logo.py">logo.py</a></code></td>
+<td align="center"><img src="doc/imgs/escher-square-limit.png"><br><code><a href="https://github.com/danoneata/chalk/tree/master/examples/escher_square.py">escher_square.py</a></code></td>
+</tr>
+<tr>
+<td align="center"><img src="doc/imgs/hilbert.png"><br><code><a href="https://github.com/danoneata/chalk/tree/master/examples/hilbert.py">hilbert.py</a></code></td>
+<td align="center"><img src="doc/imgs/koch.png"><br><code><a href="https://github.com/danoneata/chalk/tree/master/examples/koch.py">koch.py</a></code></td>
+<td align="center"><img src="doc/imgs/hex-variation.png"><br><code><a href="https://github.com/danoneata/chalk/tree/master/examples/hex_variation.py">hex-variation.py</a></code></td>
+</tr>
+<tr>
+<td align="center"><img src="doc/imgs/lenet.png"><br><code><a href="https://github.com/danoneata/chalk/tree/master/examples/lenet.py">lenet.py</a></code></td>
+<td align="center"><img src="doc/imgs/tensor.png"><br><code><a href="https://github.com/danoneata/chalk/tree/master/examples/tensor.py">tensor.py</a></code></td>
+<td align="center"><img src="doc/imgs/hanoi.png"><br><code><a href="https://github.com/danoneata/chalk/tree/master/examples/hanoi.py">hanoi.py</a></code></td>
+</tr>
+<!--<tr>
+<td align="center"><img src="doc/imgs/latex.svg"><br><code><a href="https://github.com/danoneata/chalk/tree/master/examples/latex.py">latex.py</a></code></td>
+</tr>
+-->
+</table>
+
 These scripts can be run as follows:
 
 ```bash
 python examples/squares.py
 ```
 
-![squares](https://raw.githubusercontent.com/danoneata/chalk/master/examples/output/squares.png)
-
-```bash
-python examples/escher_square_limit.py
-```
-
-![escher](https://raw.githubusercontent.com/danoneata/chalk/master/examples/output/escher-square-limit.png)
-
-```bash
-python examples/hanoi.py
-```
-
-![hanoi](https://raw.githubusercontent.com/danoneata/chalk/master/examples/output/hanoi.png)
-
 ## Authors
 
 - [Dan Oneață](http://doneata.bitbucket.io/)
diff --git a/doc/crop-images.sh b/doc/crop-images.sh
new file mode 100644
index 00000000..74870f06
--- /dev/null
+++ b/doc/crop-images.sh
@@ -0,0 +1,4 @@
+for img in squares hanoi escher-square-limit lenet logo hilbert koch tensor hex-variation; do
+    # convert examples/output/${img}.png -gravity center -crop 200x200+0+0 +repage doc/imgs/${img}.png
+    convert -define png:size=200x200 examples/output/${img}.png  -thumbnail 200x200^ -gravity center -extent 200x200  doc/imgs/${img}.png
+done
diff --git a/doc/imgs/escher-square-limit.png b/doc/imgs/escher-square-limit.png
new file mode 100644
index 00000000..1b59d2e7
Binary files /dev/null and b/doc/imgs/escher-square-limit.png differ
diff --git a/doc/imgs/hanoi.png b/doc/imgs/hanoi.png
new file mode 100644
index 00000000..a3b1fde7
Binary files /dev/null and b/doc/imgs/hanoi.png differ
diff --git a/doc/imgs/hex-variation.png b/doc/imgs/hex-variation.png
new file mode 100644
index 00000000..14b72b49
Binary files /dev/null and b/doc/imgs/hex-variation.png differ
diff --git a/doc/imgs/hilbert.png b/doc/imgs/hilbert.png
new file mode 100644
index 00000000..b0e319aa
Binary files /dev/null and b/doc/imgs/hilbert.png differ
diff --git a/doc/imgs/koch.png b/doc/imgs/koch.png
new file mode 100644
index 00000000..40b45729
Binary files /dev/null and b/doc/imgs/koch.png differ
diff --git a/doc/imgs/lenet.png b/doc/imgs/lenet.png
new file mode 100644
index 00000000..5f1ca3fb
Binary files /dev/null and b/doc/imgs/lenet.png differ
diff --git a/doc/imgs/logo.png b/doc/imgs/logo.png
new file mode 100644
index 00000000..a4ddd5c8
Binary files /dev/null and b/doc/imgs/logo.png differ
diff --git a/doc/imgs/squares.png b/doc/imgs/squares.png
new file mode 100644
index 00000000..4af29743
Binary files /dev/null and b/doc/imgs/squares.png differ
diff --git a/doc/imgs/tensor.png b/doc/imgs/tensor.png
new file mode 100644
index 00000000..10706cc8
Binary files /dev/null and b/doc/imgs/tensor.png differ