diff --git a/modules/bling/README.md b/modules/bling/README.md
index c76fa71..33d88d6 100644
--- a/modules/bling/README.md
+++ b/modules/bling/README.md
@@ -2,11 +2,11 @@
 
 The `bling` module allows you to easily declare which general parts of `ublue-os/bling` to pull in to your custom image. It requires the `rpms` and `files` directories from the `bling` container to already exist inside `/tmp/bling/` (pulled inside the Containerfile by default).
 
-The blingbling to pull in is declared under `install:`, and the code for installing them is all in simple named scripts under the `installers/` directory. The basic code for the `bling` module is very similar to the code of the `script` module.
+The bling to pull in is declared under `install:`, and the code for installing them is all in simple named scripts under the `installers/` directory. The basic code for the `bling` module is very similar to the code of the `script` module.
 
 ## Example configuration:
 
-```yml
+```yaml
 type: bling # configure what to pull in from ublue-os/bling
 install:
     - fonts # selection of common good free fonts
diff --git a/modules/files/README.md b/modules/files/README.md
index 20cf75d..5229f66 100644
--- a/modules/files/README.md
+++ b/modules/files/README.md
@@ -10,7 +10,7 @@ The `files` module simplifies the process of copying files to the image during t
 ```yaml
 type: files
 files:
-  usr: /usr
+  - usr: /usr
 ```
 
 In the example above, `usr` represents the directory located inside the `config/files` in the repository, while `/usr` designates the corresponding destination within the image.
diff --git a/modules/rpm-ostree/README.md b/modules/rpm-ostree/README.md
index fd51263..5734f38 100644
--- a/modules/rpm-ostree/README.md
+++ b/modules/rpm-ostree/README.md
@@ -10,7 +10,7 @@ Additionally, the `rpm-ostree` module supports a temporary (waiting for `rpm-ost
 
 ## Example Configuration:
 
-```yml
+```yaml
 type: rpm-ostree
 repos:
   - https://copr.fedorainfracloud.org/coprs/atim/starship/repo/fedora-%OS_VERSION%/atim-starship-fedora-%OS_VERSION%.repo
@@ -30,4 +30,4 @@ When removing certain packages, some problem probably in upstream `rpm-ostree` c
 Resolving dependencies...done
 error: Could not depsolve transaction; 1 problem detected:
 Problem: conflicting requests
-```
\ No newline at end of file
+```
diff --git a/modules/script/README.md b/modules/script/README.md
index b2419c5..fe4339b 100644
--- a/modules/script/README.md
+++ b/modules/script/README.md
@@ -5,10 +5,10 @@ The scripts, which are run from the `config/scripts` directory, are declared und
 
 ## Example Configuration
 
-```yml
+```yaml
 type: script
 scripts:
-    - signing.sh 
+    - signing.sh
 ```
 
 ## Creating a Script
diff --git a/modules/yafti/README.md b/modules/yafti/README.md
index af81b57..0f2defd 100644
--- a/modules/yafti/README.md
+++ b/modules/yafti/README.md
@@ -8,7 +8,7 @@ The main `yafti` configuration file, `yafti.yml`, is in `/usr/share/ublue-os/fir
 
 ## Example configuration:
 
-```yml
+```yaml
 type: yafti
 custom-flatpaks:
     - Celluloid: io.github.celluloid_player.Celluloid