diff --git a/README.md b/README.md
index fb7d8711dd2fb38c338b6ddc050798a0678053b2..f50c732e677d044b5bb429f752d0409d8020eec9 100644
--- a/README.md
+++ b/README.md
@@ -2,19 +2,19 @@
 
 This is the source code for the reference Java implementation of I2P.
 
-Latest release: https://geti2p.net/download
+Latest release: [https://geti2p.net/download](https://geti2p.net/download) 
 
 ## Installing
 
-See INSTALL.txt or https://geti2p.net/download for installation instructions.
+See [INSTALL.txt](INSTALL.txt) or [https://geti2p.net/download](https://geti2p.net/download) for installation instructions.
 
 ## Documentation
 
-https://geti2p.net/how
+[https://geti2p.net/how](https://geti2p.net/how)
 
-FAQ: https://geti2p.net/faq
+FAQ: [https://geti2p.net/faq](https://geti2p.net/faq) 
 
-API: http://docs.i2p-projekt.de/javadoc/
+API: [http://docs.i2p-projekt.de/javadoc/](http://docs.i2p-projekt.de/javadoc/) 
 or run 'ant javadoc' then start at build/javadoc/index.html
 
 ## How to contribute / Hack on I2P
@@ -23,17 +23,17 @@ Please check out [HACKING.md](docs/HACKING.md) and other documents in the docs d
 
 ## Building packages from source
 
-To get development branch from source control: https://geti2p.net/newdevelopers
+To get development branch from source control: [https://geti2p.net/newdevelopers](https://geti2p.net/newdevelopers) 
 
 ### Prerequisites
 
 - Java SDK (preferably Oracle/Sun or OpenJDK) 1.8.0 or higher
-  - Non-linux operating systems and JVMs: See https://trac.i2p2.de/wiki/java
+  - Non-linux operating systems and JVMs: See [https://trac.i2p2.de/wiki/java](https://trac.i2p2.de/wiki/java) 
   - Certain subsystems for embedded (core, router, mstreaming, streaming, i2ptunnel)
     require only Java 1.6
 - Apache Ant 1.7.0 or higher
 - The xgettext, msgfmt, and msgmerge tools installed from the GNU gettext package
-  http://www.gnu.org/software/gettext/
+ [http://www.gnu.org/software/gettext/](http://www.gnu.org/software/gettext/) 
 - Build environment must use a UTF-8 locale.
 
 ### Ant build process
@@ -68,13 +68,13 @@ your `~/.gradle/gradle.properties`:
 
 Need help? See the IRC channel #i2p on irc.freenode.net
 
-Bug reports: https://trac.i2p2.de/report/1
+Bug reports: [https://trac.i2p2.de/report/1](https://trac.i2p2.de/report/1) 
 
-Contact information, security issues, press inquiries: https://geti2p.net/en/contact
+Contact information, security issues, press inquiries: [https://geti2p.net/en/contact](https://geti2p.net/en/contact) 
 
-Twitter: @i2p, @geti2p
+Twitter: [@i2p](https://twitter.com/i2p), [@geti2p](https://twitter.com/GetI2P)
 
 ## Licenses
 
-See LICENSE.txt
+See [LICENSE.txt](LICENSE.txt)