diff --git a/doc/special_remotes/external.mdwn b/doc/special_remotes/external.mdwn
index 63a7b929b8..7b89944bc4 100644
--- a/doc/special_remotes/external.mdwn
+++ b/doc/special_remotes/external.mdwn
@@ -21,6 +21,13 @@ It's not hard!
 * If you build a new special remote, please add it to the list
   of [[special_remotes]].
 
+## libraries
+
+For Python, there is a [library](https://github.com/Lykos153/AnnexRemote)
+that takes care of all the protocol details.
+
+## examples
+
 Here's an example of using an external special remote to add torrent
 support to git-annex: [[external/git-annex-remote-torrent]]
 
@@ -28,6 +35,4 @@ Here's a simple shell script example, which can easily be adapted
 to run whatever commands you need. Or better, re-written in some better
 language of your choice.
 
-For Python, there is a [library](https://github.com/Lykos153/AnnexRemote) that takes care of all the protocol details.
-
 [[!inline pages="special_remotes/external/example.sh" feeds=no]]