diff --git a/README.jl b/README.jl
new file mode 100644
index 0000000..fe2a324
--- /dev/null
+++ b/README.jl
@@ -0,0 +1,34 @@
+# # Literate
+#
+# | **Documentation**                       | **Build Status**                                                                                |
+# |:--------------------------------------- |:----------------------------------------------------------------------------------------------- |
+# | [![][docs-latest-img]][docs-latest-url] | [![][travis-img]][travis-url] [![][appveyor-img]][appveyor-url] [![][codecov-img]][codecov-url] |
+#
+# Literate is a package for [Literate Programming](https://en.wikipedia.org/wiki/Literate_programming).
+# The main purpose is to facilitate writing Julia examples/tutorials that can be included in
+# your package documentation.
+
+# Literate can generate markdown pages
+# (for e.g. [Documenter.jl](https://github.com/JuliaDocs/Documenter.jl)), and
+# [Jupyter notebooks](http://jupyter.org/), from the same source file. There is also
+# an option to "clean" the source from all metadata, and produce a pure Julia script.
+# Using a single source file for multiple purposes reduces maintenance, and makes sure
+# your different output formats are synced with each other.
+# 
+# This readme is generated directly from this [source file](https://github.com/fredrikekre/Literate.jl) with these two commands:
+
+using Literate
+Literate.markdown("README.jl", ".")
+
+# [docs-latest-img]: https://img.shields.io/badge/docs-latest-blue.svg
+# [docs-latest-url]: https://fredrikekre.github.io/Literate.jl/stable/
+# 
+# [travis-img]: https://travis-ci.org/fredrikekre/Literate.jl.svg?branch=master
+# [travis-url]: https://travis-ci.org/fredrikekre/Literate.jl
+# 
+# [appveyor-img]: https://ci.appveyor.com/api/projects/status/xe0ghtyas12wv555/branch/master?svg=true
+# [appveyor-url]: https://ci.appveyor.com/project/fredrikekre/Literate-jl/branch/master
+# 
+# [codecov-img]: https://codecov.io/gh/fredrikekre/Literate.jl/branch/master/graph/badge.svg
+# [codecov-url]: https://codecov.io/gh/fredrikekre/Literate.jl
+# 
\ No newline at end of file
diff --git a/README.md b/README.md
index 213c677..a6eb8b2 100644
--- a/README.md
+++ b/README.md
@@ -1,3 +1,7 @@
+```@meta
+EditURL = "https://github.com/TRAVIS_REPO_SLUG/blob/master/"
+```
+
 # Literate
 
 | **Documentation**                       | **Build Status**                                                                                |
@@ -15,7 +19,12 @@ an option to "clean" the source from all metadata, and produce a pure Julia scri
 Using a single source file for multiple purposes reduces maintenance, and makes sure
 your different output formats are synced with each other.
 
+This readme is generated directly from this [source file](https://github.com/fredrikekre/Literate.jl) with these two commands:
 
+```@example README
+using Literate
+Literate.markdown("README.jl", ".")
+```
 
 [docs-latest-img]: https://img.shields.io/badge/docs-latest-blue.svg
 [docs-latest-url]: https://fredrikekre.github.io/Literate.jl/stable/
@@ -28,3 +37,6 @@ your different output formats are synced with each other.
 
 [codecov-img]: https://codecov.io/gh/fredrikekre/Literate.jl/branch/master/graph/badge.svg
 [codecov-url]: https://codecov.io/gh/fredrikekre/Literate.jl
+#-
+*This page was generated using [Literate.jl](https://github.com/fredrikekre/Literate.jl).*
+