diff --git a/README b/README
deleted file mode 100644
index 5d75fb9..0000000
--- a/README
+++ /dev/null
@@ -1,25 +0,0 @@
- ===========================
- Imaging with Python
- ===========================
-
- A Python script to generate random colour gradients. Output is in
- SVG format and the image consists of a combination of two random
- colours (rgb 0-255) in a random linear gradient.
-
- The Python script will output one gradient file. Combine it with
- 10.sh to generate 10 random gradients.
-
-
- Examples
---------
-
- Examples are provided in the /examples folder of this project. I
- use some as image backgrounds on my blog -- see https://cybrkyd.com
-
-
- Licence
--------
-
- This project is made available under a GPL3 licence -- see COPYING
- for the full text.
-
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..85a1ca0
--- /dev/null
+++ b/README.md
@@ -0,0 +1,21 @@
+ # Imaging with Python
+
+ A Python script to generate random colour gradients. Output is in SVG format and the image consists of a combination of two random colours (rgb 0-255) in a random linear gradient.
+
+ The Python script will output one gradient file; combine it with `10.sh` to generate 10 random gradients.
+
+ ## Examples
+
+ Further examples are provided in the `/examples` folder of this project. I use some as image backgrounds on my blog -- see https://cybrkyd.com
+
+ 
+
+ 
+
+ 
+
+ 
+
+ ## Licence
+
+ This project is made available under a GPL3 licence -- see COPYING for the full text.