diff --git a/swh/loader/package/archive/loader.py b/swh/loader/package/archive/loader.py
--- a/swh/loader/package/archive/loader.py
+++ b/swh/loader/package/archive/loader.py
@@ -39,11 +39,14 @@
             url: Origin url
             artifacts: List of artifact information with keys:
 
-               **time**: last modification time as either isoformat date string
-                   or timestamp
-               **url**: the artifact url to retrieve filename
-               **artifact's filename version**: artifact's version length
-               **length**: artifact's length
+               - **time**: last modification time as either isoformat date
+                 string or timestamp
+
+               - **url**: the artifact url to retrieve filename
+
+               - **artifact's filename version**: artifact's version length
+
+               - **length**: artifact's length
 
             identity_artifact_keys: Optional List of keys forming the
                 "identity" of an artifact
diff --git a/swh/loader/package/npm/loader.py b/swh/loader/package/npm/loader.py
--- a/swh/loader/package/npm/loader.py
+++ b/swh/loader/package/npm/loader.py
@@ -119,7 +119,7 @@
 
     The following code allows to deal with 2 metadata formats:
 
-    - old format sample:
+    - old format sample::
 
         {
             'package_source': {
@@ -127,12 +127,12 @@
             }
         }
 
-    - new format sample:
+    - new format sample::
 
         {
             'original_artifact': [{
                 'checksums': {
-                    'sha256': "6975816f2c5ad4046acc676ba112f2fff945b01522d63948531f11f11e0892ec",  # noqa
+                    'sha256': '6975816f2c5ad4046acc676ba112f2fff945b01522d63948531f11f11e0892ec', # noqa
                     ...
                 },
             }],
diff --git a/swh/loader/package/pypi/loader.py b/swh/loader/package/pypi/loader.py
--- a/swh/loader/package/pypi/loader.py
+++ b/swh/loader/package/pypi/loader.py
@@ -114,22 +114,22 @@
     The following code allows to deal with 2 metadata formats (column metadata
     in 'revision')
 
-    - old format sample:
+    - old format sample::
 
         {
             'original_artifact': {
-                'sha256': "6975816f2c5ad4046acc676ba112f2fff945b01522d63948531f11f11e0892ec",  # noqa
+                'sha256': '6975816f2c5ad4046acc676ba112f2fff945b01522d63948531f11f11e0892ec',  # noqa
                 ...
             },
             ...
         }
 
-    - new format sample:
+    - new format sample::
 
         {
             'original_artifact': [{
                 'checksums': {
-                    'sha256': "6975816f2c5ad4046acc676ba112f2fff945b01522d63948531f11f11e0892ec",  # noqa
+                    'sha256': '6975816f2c5ad4046acc676ba112f2fff945b01522d63948531f11f11e0892ec',  # noqa
                     ...
                 },
             }],