diff --git a/README.txt b/README.md
similarity index 50%
rename from README.txt
rename to README.md
index 7f3c258..76a7048 100644
--- a/README.txt
+++ b/README.md
@@ -2,25 +2,22 @@ nanohtml2text
 =============
 
 0-dependency library to convert HTML to text; an alternative to
-https://crates.io/crates/html2text that doesn't use a full browser-grade HTML
-parser
+[html2text](https://crates.io/crates/html2text) that doesn't use a full
+browser-grade HTML parser
 
-Based on https://github.com/k3a/html2text 
+Based on [this go html2text library](https://github.com/k3a/html2text)
 
 Primarily useful for displaying HTML emails as text. YMMV depending on the
-structure of the HTML you're trying to convert. Built for the needs of
-Crabmail: https://git.alexwennerberg.com/crabmail/
+structure of the HTML you're trying to convert. 
 
 This library has one function, html2text, which takes a an html &str and
 returns a plain text String
 
-on crates.io:
-https://crates.io/crates/nanohtml2text
+On [crates.io](https://crates.io/crates/nanohtml2text)
 
 Comes with a command line utility in main.rs to process from stdin if you want
 to test/experiment with it
 
 Contributing
 ------------
-git-send-email or git-request-pull to my mailing list:
-https://lists.flounder.online/patches/
+git-send-email or git-request-pull to [my mailing list](https://lists.flounder.online/patches/)