diff --git a/README.md b/README.md
index bc9a969..2cadca2 100644
--- a/README.md
+++ b/README.md
@@ -10,16 +10,15 @@ https://zuul-ci.org/docs/zuul/
 
 There are two Zuul-related mailing lists:
 
-`zuul-announce <http://lists.zuul-ci.org/cgi-bin/mailman/listinfo/zuul-announce>`_
-  A low-traffic announcement-only list to which every Zuul operator or
-  power-user should subscribe.
+[zuul-announce](http://lists.zuul-ci.org/cgi-bin/mailman/listinfo/zuul-announce)
+is a low-traffic announcement-only list to which every Zuul operator or power-user
+should subscribe.
 
-`zuul-discuss <http://lists.zuul-ci.org/cgi-bin/mailman/listinfo/zuul-discuss>`_
-  General discussion about Zuul, including questions about how to use
-  it, and future development.
+[zuul-discuss](http://lists.zuul-ci.org/cgi-bin/mailman/listinfo/zuul-discuss)
+is for general discussions about Zuul, including questions about how to use it,
+and future development
 
-You will also find Zuul developers in the `#zuul` channel on Freenode
-IRC.
+You will also find Zuul developers in the `#zuul` channel on Freenode IRC.
 
 ## License