diff --git a/README.mkd b/README.mkd
index 965a83d..45536c1 100644
--- a/README.mkd
+++ b/README.mkd
@@ -24,7 +24,8 @@ Get and load antigen.
     source antigen.zsh
 
 There. You now have all the antigen goodies. Let's try install some plugins. How
-about some color to start with. Get the syntax highlighting plugin by running
+about some color to start with. Get the [syntax highlighting plugin][] by
+running
 
     antigen-bundle zsh-users/zsh-syntax-highlighting
 
@@ -51,7 +52,7 @@ And themes? How would you like a fancy new prompt for yourself?
     antigen-theme funky
 
 No? Not your taste? There are many themes available to you, check out the
-oh-my-zsh's page on themes. (You can currently only install themes from
+oh-my-zsh's [page on themes][]. (You can currently only install themes from
 robbyrussell's, i.e., the canonical oh-my-zsh repo).
 
 Note: Many of those plugins and especially themes, assume you have the core
@@ -325,6 +326,10 @@ Defaults to `$HOME/.antigen`.
 were used previously but are now removed. Please use `ADOTDIR` instead, as
 mentioned above.
 
+# Notes on writing plugins
+
+> *TBD*
+
 # Meta
 
 Project is licensed with the [MIT License][license]. To contribute, just fork,
@@ -336,6 +341,8 @@ Any comments/suggestions/feedback welcome. Please join the discussion on the
 [@sharat87](twitter).
 
 [Vundle]: https://github.com/gmarik/vundle
+[page on themes]: https://github.com/robbyrussell/oh-my-zsh/wiki/Themes
+[syntax highlighting plugin]: https://github.com/zsh-users/zsh-syntax-highlighting
 [oh-my-zsh]: https://github.com/robbyrussell/oh-my-zsh
 [issue]: https://github.com/sharat87/antigen/issues
 [license]: http://mit.sharats.me