diff --git a/.tx/howto.md b/.tx/howto.md
new file mode 100644
index 00000000..90897d5b
--- /dev/null
+++ b/.tx/howto.md
@@ -0,0 +1,65 @@
+Go to the [Transifex client documentation](http://help.transifex.com/features/client/index.html) for more info.
+
+## Initializing a new project on Transifex
+
+<pre>
+tx init
+tx set --auto-local -r hexchat.main "po\<lang>.po" --source-lang en --source-file po\hexchat.pot --execute
+</pre>
+
+Append `type = PO` to _.tx\config_.
+
+Push the resources to Transifex:
+
+<pre>
+tx push --source --translation
+</pre>
+
+
+## Updating online translations with the template
+
+Regenerate the source file (_hexchat.pot_) on a Unix machine:
+
+<pre>
+rm po/hexchat.pot && ./autogen.sh && ./configure --enable-nls && make
+</pre>
+
+Push the updated source file to Transifex (this automatically updates all translation files):
+
+<pre>
+tx push --source
+</pre>
+
+
+## Updating the repo with online translations
+
+Update local copy with Transifex updates:
+
+<pre>
+tx pull
+</pre>
+
+Update GitHub repo:
+
+<pre>git add po/
+git commit
+git push
+</pre>
+
+
+## Updating just one translation with local changes
+
+<pre>
+tx push --translation --language xy
+</pre>
+
+Where _xy_ is the language code.
+
+
+## Forcing translation updates
+
+<pre>
+tx pull --force
+</pre>
+
+This might be required when the repo is freshly cloned and thus timestamps are newer than on Transifex.
diff --git a/.tx/howto.txt b/.tx/howto.txt
deleted file mode 100644
index 20b17851..00000000
--- a/.tx/howto.txt
+++ /dev/null
@@ -1,49 +0,0 @@
-More info: http://help.transifex.com/features/client/index.html
-
-1) To initialize a new project on Transifex:
-
-# tx init
-# tx set --auto-local -r hexchat.main "po\<lang>.po" --source-lang en --source-file po\hexchat.pot --execute
-
-Append 'type = PO' to .tx\config without apostrophes
-
-Push the resources to Transifex
-# tx push --source --translation
-
-
-
-2) To update online translations:
-
-Regenerate the source file (hexchat.pot) on a Unix machine
-# rm po/hexchat.pot && ./autogen.sh && ./configure --enable-nls && make
-
-Push the updated source file to Transifex (this automatically updates all translation files)
-# tx push --source
-
-
-
-3) To update repo with online translations:
-
-Update local copy with Transifex updates
-# tx pull
-
-Update GitHub repo
-# git add po/
-# git commit
-# git push
-
-
-
-4) To update just one translation with local changes:
-
-# tx push --translation --language xy
-
-Where xy is the language code
-
-
-
-5) To force updating translations:
-
-# tx pull --force
-
-This might be required when the repo is freshly cloned and thus timestamps are newer than on Transifex.