diff --git a/docs/persistent-identifiers.rst b/docs/persistent-identifiers.rst
--- a/docs/persistent-identifiers.rst
+++ b/docs/persistent-identifiers.rst
@@ -235,22 +235,23 @@
 Core identifiers
 ----------------
 
-* ``swh:1:cnt:94a9ed024d3859793618152ea559a168bbcbb5e2`` points to the content
-  of a file containing the full text of the GPL3 license
+* .. image:: https://archive.softwareheritage.org/badge/swh:1:cnt:94a9ed024d3859793618152ea559a168bbcbb5e2/
+    :target: https://archive.softwareheritage.org/swh:1:cnt:94a9ed024d3859793618152ea559a168bbcbb5e2;path=// points to the content of a file containing the full text of the GPL3 license
 
-* ``swh:1:dir:d198bc9d7a6bcf6db04f476d29314f157507d505`` points to a directory
-  containing the source code of the Darktable photography application as it was
-  at some point on 4 May 2017
+* .. image:: https://archive.softwareheritage.org/badge/swh:1:dir:d198bc9d7a6bcf6db04f476d29314f157507d505/
+    :target: https://archive.softwareheritage.org/swh:1:dir:d198bc9d7a6bcf6db04f476d29314f157507d505/ points to a directory
+  containing the source code of the Darktable photography application as it was at some point on 4 May 2017
 
-* ``swh:1:rev:309cf2674ee7a0749978cf8265ab91a60aea0f7d`` points to a commit in
-  the development history of Darktable, dated 16 January 2017, that added
-  undo/redo supports for masks
+* .. image:: https://archive.softwareheritage.org/badge/swh:1:rev:309cf2674ee7a0749978cf8265ab91a60aea0f7d/
+    :target: https://archive.softwareheritage.org/swh:1:rev:309cf2674ee7a0749978cf8265ab91a60aea0f7d/ points to a commit in
+  the development history of Darktable, dated 16 January 2017, that added undo/redo supports for masks
 
-* ``swh:1:rel:22ece559cc7cc2364edc5e5593d63ae8bd229f9f`` points to Darktable
+* .. image:: https://archive.softwareheritage.org/badge/swh:1:rel:22ece559cc7cc2364edc5e5593d63ae8bd229f9f/
+    :target: https://archive.softwareheritage.org/swh:1:rel:22ece559cc7cc2364edc5e5593d63ae8bd229f9f/ points to Darktable
   release 2.3.0, dated 24 December 2016
 
-* ``swh:1:snp:c7c108084bc0bf3d81436bf980b46e98bd338453`` points to a snapshot
-  of the entire Darktable Git repository taken on 4 May 2017 from GitHub
+* .. image:: https://archive.softwareheritage.org/badge/swh:1:snp:c7c108084bc0bf3d81436bf980b46e98bd338453/
+    :target: https://archive.softwareheritage.org/swh:1:snp:c7c108084bc0bf3d81436bf980b46e98bd338453/ points to a snapshot of the entire Darktable Git repository taken on 4 May 2017 from GitHub
 
 
 Identifiers with qualifiers