diff --git a/README.md b/README.md
index 0eb87d7..cbed087 100644
--- a/README.md
+++ b/README.md
@@ -1,19 +1,19 @@
 # Markdown for papers
 
-== Taken from:
+## Taken from:
 
-https://gist.github.com/maxogden/97190db73ac19fc6c1d9beee1a6e4fc8
+[How to make a scientific looking PDF from markdown (with bibliography)](https://gist.github.com/maxogden/97190db73ac19fc6c1d9beee1a6e4fc8)
 
 
 Another good example, dat project paper:
-https://github.com/datproject/docs
+[Dat Project Documentation](https://github.com/datproject/docs)
 
-== how does it work?
+## How does it work?
 
 The paper is edited in paper.md, and the converted into latex and pdf by [pandoc](https://pandoc.org/)
 
 
-== Paper generation
+## Paper generation
 
 ```
 python3 conversion_script.py