diff --git a/README.md b/README.md
index f655e5f..ee019e7 100644
--- a/README.md
+++ b/README.md
@@ -1,103 +1,81 @@
-
-
- JBinHex
-
-
+# JBinHex
-JBinHex
-
-
JBinHex is both a library and a command-line tool to decode files in
the Apple Macintosh BinHex 4.0 format.
-
-Current version: 0.5
+## Current version: 0.5
-Version history:
+## Version history
-
- - 0.5
-
- First released version
-
+ * 0.5 First released version
-Limitations in this version:
+## Limitations in this version
-
-Possible future features:
+## Possible future features
-
- - Encoding of BinHex files
-
- File-based interface that allows to switch between data and
+ * Encoding of BinHex files
+ * File-based interface that allows to switch between data and
resource fork at any moment, instead of the predetermined order
that the stream-based interface dictates
-
-Command-line tool
+## Command-line tool
-The class name of the command-line tool is org.gjt.convert.binhex.DeBinHex
+The class name of the command-line tool is `org.gjt.convert.binhex.DeBinHex`
-It accepts the following command line parameters:
+It accepts the following command line parameters:
-
+ present, `DeBinHex` will decode the data fork as if
+ the `-d` options was specified.
+ * `-h` to only show the header of the BinHex file
+ on `stdout`. The decoding options are ignored.
-Javadoc
-The Javadoc of the classes is included in the
+## Javadoc
+
+The [Javadoc of the classes](https://www.klomp.org/JBinHex/javadoc/index.html) is included in the
distribution and available online.
-Download
+## Download
-Download the complete package including source, javadoc and jarfile with classes (36 Kb).
+[Download the complete package](http://www.klomp.org/packages/JBinHex.tar.gz) including source, javadoc and jarfile with classes (36 Kb).
-License
+## License
-The package is licensed under the GNU General Public License,
-also known as the GPL license. See file COPYING for
-details.
+The package is licensed under the **GNU General Public License**,
+also known as the GPL license. See file [COPYING](https://www.klomp.org/JBinHex/COPYING) for
+details.
-References
+## References
-
+ * Article written by Yves Lempereur, available as Appendix A in [rfc1741](http://www.rfc.net/get2.php3/rfc1741.html)
+ * Article titled [BinHex 4.0 Definition](http://wuarchive.wustl.edu/systems/mac/umich.edu/misc/documentation/binhex4.0specs.txt) by Peter N Lewis
-Copyright
+## Copyright
-All files in the package and on this site Copyright 2000 by Erwin
-Bolwidt, <ejb@klomp.org>
+All files in the package and on this site Copyright 2000 by Erwin
+Bolwidt, <[ejb@klomp.org](mailto:ejb@klomp.org)>
-
-This page was last updated at april 8, 2000.
-
-
-
-
+----
+This page was last updated at april 8, 2000.