diff --git a/README b/README.md
rename from README
rename to README.md
--- a/README
+++ b/README.md
@@ -1,13 +1,10 @@
-= WHAT IS ARCANIST? =
-
-Arcanist is the command-line tool for [[http://phabricator.org/ | Phabricator]].
+Arcanist is the command-line tool for [Phabricator](http://phabricator.org).
 It allows you to interact with Phabricator installs to send code for review,
 download patches, transfer files, view status, make API calls, and various other
-things. You can find a complete user guide
-[[http://www.phabricator.com/docs/phabricator/article/Arcanist_User_Guide.html |
-here]].
+things. You can read more in the [User Guide](https://secure.phabricator.com/book/phabricator/article/arcanist/)
 
 For more information about Phabricator, see http://phabricator.org/.
 
-= LICENSE =
+**LICENSE**
+
 Arcanist is released under the Apache 2.0 license except as otherwise noted.