diff --git a/README.asciidoc b/README.asciidoc
index e7408a70..0b486b2b 100644
--- a/README.asciidoc
+++ b/README.asciidoc
@@ -1,5 +1,7 @@
-image:https://rawgit.com/mawww/kakoune/master/doc/kakoune_logo.svg[K,30,30] Kakoune image:https://travis-ci.org/mawww/kakoune.svg[link="https://travis-ci.org/mawww/kakoune"]
-=============================================================================================================================================================================
+= image:{logo}[K,30,30] Kakoune image:{travis-img}[link="{travis-url}"]
+:logo: https://rawgit.com/mawww/kakoune/master/doc/kakoune_logo.svg
+:travis-img: https://travis-ci.org/mawww/kakoune.svg
+:travis-url: https://travis-ci.org/mawww/kakoune
 
 TL;DR
 -----
@@ -18,8 +20,10 @@ make userconfig
 See http://github.com/mawww/golf for kakoune solutions to vimgolf challenges,
 regularly beating the best vim solution.
 
-Introduction:
--------------
+:numbered:
+
+Introduction
+------------
 
 Kakoune is a code editor heavily inspired by Vim, as such most of it's
 commands are similar to vi's ones.