containers · mtrmac · Dec 2, 2025 · Nov 27, 2025
diff --git a/storage/docs/containers-storage-add-names.md b/storage/docs/containers-storage-add-names.md
@@ -1,7 +1,7 @@
 # containers-storage-add-names 1 "August 2016"
 
 ## NAME
-containers-storage add-names - Add names to a layer/image/container
+containers-storage-add-names - Add names to a layer/image/container
 
 ## SYNOPSIS
 **containers-storage** **add-names** [*options* [...]] *layerOrImageOrContainerNameOrID*
@@ -19,7 +19,13 @@ is already used by another layer, image, or container, it is removed from that
 other layer, image, or container.
 
 ## EXAMPLE
-**containers-storage add-names -n my-awesome-container -n my-for-realsies-awesome-container f3be6c6134d0d980936b4c894f1613b69a62b79588fdeda744d0be3693bde8ec**
+
+```
+containers-storage add-names \
+ -n my-awesome-container \
+ -n my-for-realsies-awesome-container \
+ f3be6c6134d0d980936b4c894f1613b69a62b79588fdeda744d0be3693bde8ec
+```
 
 ## SEE ALSO
 containers-storage-get-names(1)

diff --git a/storage/docs/containers-storage-applydiff-using-staging-dir.md b/storage/docs/containers-storage-applydiff-using-staging-dir.md
@@ -1,7 +1,7 @@
 # containers-storage-applydiff-using-staging-dir 1 "September 2023"
 
 ## NAME
-containers-storage applydiff-using-staging-dir - Apply a layer diff to a layer using a staging directory
+containers-storage-applydiff-using-staging-dir - Apply a layer diff to a layer using a staging directory
 
 ## SYNOPSIS
 **containers-storage** **applydiff-using-staging-dir** *layerNameOrID* *source*
@@ -18,7 +18,9 @@ Differently than **apply-diff**, the command **applydiff-using-staging-dir**
 first creates a staging directory and then moves the final result to the destination.
 
 ## EXAMPLE
-**containers-storage applydiff-using-staging-dir 5891b5b522 /path/to/diff**
+```
+containers-storage applydiff-using-staging-dir 5891b5b522 /path/to/diff
+```
 
 ## SEE ALSO
 containers-storage-apply-diff(1)

diff --git a/storage/docs/containers-storage-applydiff.md b/storage/docs/containers-storage-applydiff.md
@@ -1,7 +1,7 @@
 # containers-storage-apply-diff 1 "August 2016"
 
 ## NAME
-containers-storage apply-diff - Apply a layer diff to a layer
+containers-storage-apply-diff - Apply a layer diff to a layer
 
 ## SYNOPSIS
 **containers-storage** **apply-diff** [*options* [...]] *layerNameOrID* [*referenceLayerNameOrID*]
@@ -24,7 +24,8 @@ Specifies the name of a file from which the diff should be read.  If this
 option is not used, the diff is read from standard input.
 
 ## EXAMPLE
-**containers-storage apply-diff -f 71841c97e320d6cde.tar.gz layer1**
+
+    containers-storage apply-diff -f 71841c97e320d6cde.tar.gz layer1
 
 ## SEE ALSO
 containers-storage-changes(1)

diff --git a/storage/docs/containers-storage-changes.md b/storage/docs/containers-storage-changes.md
@@ -1,7 +1,7 @@
 # containers-storage-changes 1 "August 2016"
 
 ## NAME
-containers-storage changes - Produce a list of changes in a layer
+containers-storage-changes - Produce a list of changes in a layer
 
 ## SYNOPSIS
 **containers-storage** **changes** *layerNameOrID* [*referenceLayerNameOrID*]
@@ -13,7 +13,8 @@ obtain a summary of which files have been added, deleted, or modified in the
 layer.
 
 ## EXAMPLE
-**containers-storage changes f3be6c6134d0d980936b4c894f1613b69a62b79588fdeda744d0be3693bde8ec**
+
+    containers-storage changes f3be6c6134d0d980936b4c894f1613b69a62b79588fdeda744d0be3693bde8ec
 
 ## SEE ALSO
 containers-storage-applydiff(1)

diff --git a/storage/docs/containers-storage-check.md b/storage/docs/containers-storage-check.md
@@ -1,7 +1,7 @@
 # containers-storage-check 1 "September 2022"
 
 ## NAME
-containers-storage check - Check for and remove damaged layers/images/containers
+containers-storage-check - Check for and remove damaged layers/images/containers
 
 ## SYNOPSIS
 **containers-storage** **check** [-q] [-r [-f]]
@@ -28,7 +28,8 @@ currently skips verifying that a layer which was initialized using a diff can
 reproduce that diff if asked to.
 
 ## EXAMPLE
-**containers-storage check -r -f
+
+    containers-storage check -r -f
 
 ## SEE ALSO
 containers-storage(1)
diff --git a/storage/docs/containers-storage-composefs.md b/storage/docs/containers-storage-composefs.md
@@ -15,7 +15,8 @@ use_composefs = "true"
 This value must be a "string bool", it cannot be a native TOML boolean.
 
 However at the current time, composefs requires zstd:chunked images, so first
-you must be sure that zstd:chunked is enabled. For more, see [zstd:chunked](containers-storage-zstd-chunked.md).
+you must be sure that zstd:chunked is enabled.
+For more, see [zstd:chunked](containers-storage-zstd-chunked.md).
 
 Additionally, not many images are in zstd:chunked format. In order to bridge this gap,
 `convert_images = "true"` can be specified which does a dynamic conversion; this adds
@@ -37,10 +38,12 @@ is implemented as an "option" for the `overlay` driver. Some file formats
 remain unchanged and are inherited from the overlay driver, even when
 composefs is in use. The primary differences are enumerated below.
 
-The `diff/` directory for each layer is no longer a plain unpacking of the tarball,
-but becomes an "object hash directory", where each filename is the sha256 of its contents. This `diff/`
-directory is the backing store for a `composefs-data/composefs.blob` created for
-each layer which is the composefs "superblock" containing all the non-regular-file content (i.e. metadata) from the tarball.
+The `diff/` directory for each layer is no longer a plain unpacking of the
+tarball, but becomes an "object hash directory", where each filename is the
+sha256 of its contents. This `diff/` directory is the backing store for a
+`composefs-data/composefs.blob` created for each layer which is the composefs
+"superblock" containing all the non-regular-file content (i.e. metadata) from
+the tarball.
 
 As with `zstd:chunked`, existing layers are scanned for matching objects, and reused
 (via hardlink or reflink as configured) if objects with a matching "full sha256" are
@@ -59,7 +62,7 @@ in the "default overlay" (unpacked) format will be reused as is.
 
 ## BUGS
 
-- https://github.com/containers/storage/issues?q=is%3Aissue+is%3Aopen+label%3Aarea%2Fcomposefs
+https://github.com/containers/storage/issues?q=is%3Aissue+is%3Aopen+label%3Aarea%2Fcomposefs
 
 ## FOOTNOTES
 The Containers Storage project is committed to inclusivity, a core value of open source.

diff --git a/storage/docs/containers-storage-config.md b/storage/docs/containers-storage-config.md
@@ -1,7 +1,7 @@
 # containers-storage-config 1 "November 2024"
 
 ## NAME
-containers-storage config - Output the configuration for the storage library
+containers-storage-config - Output the configuration for the storage library
 
 ## SYNOPSIS
 **containers-storage** **config** [configurationFile]
@@ -12,7 +12,9 @@ current configuration with the contents of a specified configuration file
 loaded in, in a JSON format.
 
 ## EXAMPLE
-**containers-storage config**
+
+    containers-storage config
+
 
 ## SEE ALSO
 containers-storage-version(1)
diff --git a/storage/docs/containers-storage-container.md b/storage/docs/containers-storage-container.md
@@ -1,7 +1,7 @@
 # containers-storage-container 1 "August 2016"
 
 ## NAME
-containers-storage container - Examine a single container
+containers-storage-container - Examine a single container
 
 ## SYNOPSIS
 **containers-storage** **container** *containerNameOrID*
@@ -11,8 +11,9 @@ Retrieve information about a container: any names it has, which image was used
 to create it, any names that image has, and the ID of the container's layer.
 
 ## EXAMPLE
-**containers-storage container f3be6c6134d0d980936b4c894f1613b69a62b79588fdeda744d0be3693bde8ec**
-**containers-storage container my-awesome-container**
+
+    containers-storage container f3be6c6134d0d980936b4c894f1613b69a62b79588fdeda744d0be3693bde8ec
+    containers-storage container my-awesome-container
 
 ## SEE ALSO
 containers-storage-containers(1)

diff --git a/storage/docs/containers-storage-containers.md b/storage/docs/containers-storage-containers.md
@@ -1,7 +1,7 @@
 # containers-storage-containers 1 "August 2016"
 
 ## NAME
-containers-storage containers - List known containers
+containers-storage-containers - List known containers
 
 ## SYNOPSIS
 **containers-storage** **containers**
@@ -10,7 +10,8 @@ containers-storage containers - List known containers
 Retrieves information about all known containers and lists their IDs and names.
 
 ## EXAMPLE
-**containers-storage containers**
+
+    containers-storage containers
 
 ## SEE ALSO
 containers-storage-container(1)
diff --git a/storage/docs/containers-storage-copy.md b/storage/docs/containers-storage-copy.md
@@ -1,7 +1,7 @@
 # containers-storage-copy 1 "April 2018"
 
 ## NAME
-containers-storage copy - Copy content into a layer
+containers-storage-copy - Copy content into a layer
 
 ## SYNOPSIS
 **containers-storage** **copy** [--chown UID[:GID]] [*sourceLayerNameOrID*:]/path [...] *targetLayerNameOrID*:/path
@@ -17,7 +17,8 @@ specified, the UID is used.  The owner IDs are mapped as appropriate for the
 target layer.
 
 ## EXAMPLE
-**containers-storage copy layer-with-mapping:/root/config.txt layer-with-different-mapping:/root/config.txt**
+
+    containers-storage copy layer-with-mapping:/root/config.txt layer-with-different-mapping:/root/config.txt
 
 ## SEE ALSO
 containers-storage(1)
diff --git a/storage/docs/containers-storage-create-container.md b/storage/docs/containers-storage-create-container.md
@@ -1,7 +1,7 @@
 # containers-storage-create-container 1 "August 2016"
 
 ## NAME
-containers-storage create-container - Create a container
+containers-storage-create-container - Create a container
 
 ## SYNOPSIS
 **containers-storage** **create-container** [*options*...] *imageNameOrID*
@@ -29,7 +29,8 @@ Sets the metadata for the container to the specified value.
 Sets the metadata for the container to the contents of the specified file.
 
 ## EXAMPLE
-**containers-storage create-container -f manifest.json -n new-container goodimage**
+
+    containers-storage create-container -f manifest.json -n new-container goodimage
 
 ## SEE ALSO
 containers-storage-create-image(1)

diff --git a/storage/docs/containers-storage-create-image.md b/storage/docs/containers-storage-create-image.md
@@ -1,7 +1,7 @@
 # containers-storage-create-image 1 "August 2016"
 
 ## NAME
-containers-storage create-image - Create an image
+containers-storage-create-image - Create an image
 
 ## SYNOPSIS
 **containers-storage** **create-image** [*options*...] *topLayerNameOrID*
@@ -29,7 +29,8 @@ Sets the metadata for the image to the specified value.
 Sets the metadata for the image to the contents of the specified file.
 
 ## EXAMPLE
-**containers-storage create-image -f manifest.json -n new-image somelayer**
+
+    containers-storage create-image -f manifest.json -n new-image somelayer
 
 ## SEE ALSO
 containers-storage-create-container(1)

diff --git a/storage/docs/containers-storage-create-layer.md b/storage/docs/containers-storage-create-layer.md
@@ -1,7 +1,7 @@
 # containers-storage-create-layer 1 "August 2016"
 
 ## NAME
-containers-storage create-layer - Create a layer
+containers-storage-create-layer - Create a layer
 
 ## SYNOPSIS
 **containers-storage** **create-layer** [*options* [...]] [*parentLayerNameOrID*]
@@ -26,7 +26,8 @@ Sets the label which should be assigned as an SELinux context when mounting the
 layer.
 
 ## EXAMPLE
-**containers-storage create-layer -f manifest.json -n new-layer somelayer**
+
+    containers-storage create-layer -f manifest.json -n new-layer somelayer
 
 ## SEE ALSO
 containers-storage-create-container(1)

diff --git a/storage/docs/containers-storage-create-storage-layer.md b/storage/docs/containers-storage-create-storage-layer.md
@@ -1,7 +1,7 @@
 # containers-storage-create-storage-layer 1 "September 2022"
 
 ## NAME
-containers-storage create-storage-layer - Create a layer in a lower-level storage driver
+containers-storage-create-storage-layer - Create a layer in a lower-level storage driver
 
 ## SYNOPSIS
 **containers-storage** **create-storage-layer** [*options* [...]] [*parentLayerNameOrID*]
@@ -21,7 +21,8 @@ Sets the label which should be assigned as an SELinux context when mounting the
 layer.
 
 ## EXAMPLE
-**containers-storage create-storage-layer somelayer**
+
+    containers-storage create-storage-layer somelayer
 
 ## SEE ALSO
 containers-storage-create-container(1)

diff --git a/storage/docs/containers-storage-dedup.md b/storage/docs/containers-storage-dedup.md
@@ -1,7 +1,7 @@
 # containers-storage-dedup 1 "November 2024"
 
 ## NAME
-containers-storage dedup - Deduplicate similar files in the images
+containers-storage-dedup - Deduplicate similar files in the images
 
 ## SYNOPSIS
 **containers-storage** **dedup**
@@ -15,4 +15,5 @@ Find similar files in the images and deduplicate them.  It requires reflink supp
 Specify the function to use to calculate the hash for a file.  It can be one of: *size*, *crc*, *sha256sum*.
 
 ## EXAMPLE
-**containers-storage dedup**
+
+    containers-storage dedup
diff --git a/storage/docs/containers-storage-delete-container.md b/storage/docs/containers-storage-delete-container.md
@@ -1,7 +1,7 @@
 # containers-storage-delete-container 1 "August 2016"
 
 ## NAME
-containers-storage delete-container - Delete a container
+containers-storage-delete-container - Delete a container
 
 ## SYNOPSIS
 **containers-storage** **delete-container** *containerNameOrID*
@@ -10,7 +10,8 @@ containers-storage delete-container - Delete a container
 Deletes a container and its layer.
 
 ## EXAMPLE
-**containers-storage delete-container my-awesome-container**
+
+    containers-storage delete-container my-awesome-container
 
 ## SEE ALSO
 containers-storage-create-container(1)

diff --git a/storage/docs/containers-storage-delete-image.md b/storage/docs/containers-storage-delete-image.md
@@ -1,7 +1,7 @@
 # containers-storage-delete-image 1 "August 2016"
 
 ## NAME
-containers-storage delete-image - Delete an image
+containers-storage-delete-image - Delete an image
 
 ## SYNOPSIS
 **containers-storage** **delete-image** *imageNameOrID*
@@ -13,7 +13,8 @@ If that image's parent is then not being used by other images, it, too, will be
 removed, and this will be repeated for each parent's parent.
 
 ## EXAMPLE
-**containers-storage delete-image my-base-image**
+
+    containers-storage delete-image my-base-image
 
 ## SEE ALSO
 containers-storage-create-image(1)

diff --git a/storage/docs/containers-storage-delete-layer.md b/storage/docs/containers-storage-delete-layer.md
@@ -1,7 +1,7 @@
 # containers-storage-delete-layer 1 "August 2016"
 
 ## NAME
-containers-storage delete-layer - Delete a layer
+containers-storage-delete-layer - Delete a layer
 
 ## SYNOPSIS
 **containers-storage** **delete-layer** *layerNameOrID*
@@ -11,7 +11,8 @@ Deletes a layer if it is not currently being used by any images or containers,
 and is not the parent of any other layers.
 
 ## EXAMPLE
-**containers-storage delete-layer my-base-layer**
+
+    containers-storage delete-layer my-base-layer
 
 ## SEE ALSO
 containers-storage-create-layer(1)

diff --git a/storage/docs/containers-storage-delete.md b/storage/docs/containers-storage-delete.md
@@ -1,7 +1,7 @@
 # containers-storage-delete 1 "August 2016"
 
 ## NAME
-containers-storage delete - Force deletion of a layer, image, or container
+containers-storage-delete - Force deletion of a layer, image, or container
 
 ## SYNOPSIS
 **containers-storage** **delete** *layerOrImageOrContainerNameOrID*
@@ -11,7 +11,8 @@ Deletes a specified layer, image, or container, with no safety checking.  This
 can corrupt data, and may be removed.
 
 ## EXAMPLE
-**containers-storage delete my-base-layer**
+
+    containers-storage delete my-base-layer
 
 ## SEE ALSO
 containers-storage-delete-container(1)