diff --git a/README.md b/README.md
index 307c6988f2b04e29f29b597eafdb8c8ea2d6cf0d..67d34fdf825e7ad8f4ee6f7531c34091d59fe583 100644
--- a/README.md
+++ b/README.md
@@ -2,7 +2,7 @@
 
 Simple (and not so simple) examples of mapping data with R
 
-You might also like https://git.soton.ac.uk/twr1m15/la_emissions_viz which drives https://rushby.shinyapps.io/LAemissions/
+You might also like [https://git.soton.ac.uk/twr1m15/la_emissions_viz](https://git.soton.ac.uk/twr1m15/la_emissions_viz) which drives [https://rushby.shinyapps.io/LAemissions/](https://rushby.shinyapps.io/LAemissions/)
 
 ## data
 
@@ -12,13 +12,18 @@ The following example data is provided in this repository:
 * Energy - area-based statistics for domestic electricity consumption (LSOA, MSOA)
 * Lookup table for geographies
 
-## rMappingExample
+## Examples
+### rMappingExample
 
-A simple example of mapping using R. Examples use Local Authority (LA) and Middle-layer Super Output Area (MSOA) geography and electricity consumption data (provided in `data` subfolder).
+A [simple example of mapping using R](rMappingExample.html). Examples use Local Authority (LA) and Middle-layer Super Output Area (MSOA) geography and electricity consumption data (provided in `data` subfolder).
 
-## ONS-open-geography
+### ONS-open-geography
 
-An example and resources for using the [ONS Open Geography portal](https://geoportal.statistics.gov.uk) to download geographical data and create maps  using `Leaflet` package.
+An [example and resources](lsoaExample.html) for using the [ONS Open Geography portal](https://geoportal.statistics.gov.uk) to download geographical data and create maps  using `Leaflet` package.
+
+### fun with cartograms
+
+What it says [on the tin](/cartograms/hex-cartograms.html)
 
 ## Resources