diff a/README b/README.md
--- a/README
+++ b/README.md
@@ -1,12 +1,11 @@
+# Welcome to the JDK!
 
-Welcome to the JDK!
-===================
+For build instructions please see the
+[online documentation](https://openjdk.java.net/groups/build/doc/building.html),
+or either of these files:
 
-For build instructions, please see either of these files:
+- [doc/building.html](doc/building.html) (html version)
+- [doc/building.md](doc/building.md) (markdown version)
 
-  * doc/building.html   (html version)
-  * doc/building.md     (markdown version)
-
-See https://openjdk.java.net/ for more information about
+See <https://openjdk.java.net/> for more information about
 the OpenJDK Community and the JDK.
-