diff --git a/subprojects/libcr51sign/README.md b/subprojects/libcr51sign/README.md
index 8a64987..3902002 100644
--- a/subprojects/libcr51sign/README.md
+++ b/subprojects/libcr51sign/README.md
@@ -1,6 +1,6 @@
-## Cr51 Image Signature Library
+# Cr51 Image Signature Library
 
-### Package `libcr51sign`
+## Package `libcr51sign`
 
 - Status: **Ready**
 
@@ -15,20 +15,20 @@
 library’s functions. Interface struct should typically be static data (could put
 in rodata) while the data in context is mutable.
 
-### Debug
+## Debug
 
 Print will be handled via Macros. The user can define USER_PRINT or the library
 would use its default. The library will not assert on any error conditions,but
 will return error codes and expects the client to handle as deemed fit.
 
-```
+```c
 
 #ifndef USER_PRINT
 #define CPRINTS(ctx, format, args...)printf(format, ##args)
 #endif
 ```
 
-### Prod/Dev transitions
+## Prod/Dev transitions
 
 Prod --> Prod: Allowed \
 Prod --> Dev: Only if allowlisted/prod_to_dev_downgrade_allowed \
diff --git a/subprojects/metrics-ipmi-blobs/README.md b/subprojects/metrics-ipmi-blobs/README.md
index 52fd2e1..e302113 100644
--- a/subprojects/metrics-ipmi-blobs/README.md
+++ b/subprojects/metrics-ipmi-blobs/README.md
@@ -1,3 +1,5 @@
+# metrics-ipmi-blobs
+
 IPMI BLOBs handler to export BMC metrics snapshot
 
 This BLOB handler registers one blob with the name "/metric/snapshot".
diff --git a/subprojects/nemora-postd/README.md b/subprojects/nemora-postd/README.md
index 5e95eed..0933e21 100644
--- a/subprojects/nemora-postd/README.md
+++ b/subprojects/nemora-postd/README.md
@@ -1,4 +1,4 @@
-## Nemora-postd
+# Nemora-postd
 
 Nemora-postd is a daemon running on the BMC to stream host POST codes.
 
@@ -18,40 +18,40 @@
 
 1. On BMC, stop the existing Nemora-postd;
 
-```bash
-systemctl stop nemora-postd@eth0
-```
+   ```bash
+   systemctl stop nemora-postd@eth0
+   ```
 
 2. On any machine, start a testing server at IP_SERVER listening to upcoming UDP
    datagrams;
 
-```
-DECODE_CMD="protoc --decode=platforms.nemora.proto.EventSeries event_message.proto"
-exec socat udp-recvfrom:3960,fork exec:"$DECODE_CMD",fdout=stdout
-```
+   ```bash
+   DECODE_CMD="protoc --decode=platforms.nemora.proto.EventSeries event_message.proto"
+   exec socat udp-recvfrom:3960,fork exec:"$DECODE_CMD",fdout=stdout
+   ```
 
 3. On BMC, start a new nemora session which sends POST codes to the testing
    server;
 
-```
-nemora-postd eth0 --udp4 $IP_SERVER
-```
+   ```bash
+   nemora-postd eth0 --udp4 $IP_SERVER
+   ```
 
 4. On BMC, manually change the DBus property via `busctl`;
 
-```
-busctl set-property xyz.openbmc_project.State.Boot.Raw /xyz/openbmc_project/state/boot/raw0 xyz.openbmc_project.State.Boot.Raw Value '('tay')' 10000004 3 1 2 3
-```
+   ```bash
+   busctl set-property xyz.openbmc_project.State.Boot.Raw /xyz/openbmc_project/state/boot/raw0 xyz.openbmc_project.State.Boot.Raw Value '('tay')' 10000004 3 1 2 3
+   ```
 
 5. The testing server should receive the following packet in about 20 seconds.
 
-```bash
-magic: 9876039085048616960
-mac: ...
-sent_time_us: ...
-postcodes: 0x989684
-postcodes_protocol: NATIVE_32_BIT
-```
+   ```bash
+   magic: 9876039085048616960
+   mac: ...
+   sent_time_us: ...
+   postcodes: 0x989684
+   postcodes_protocol: NATIVE_32_BIT
+   ```
 
-Note that, `magic` and `postcodes_protocol` are fixed. `postcodes` should be
-what you set via `busctl`.
+   Note that, `magic` and `postcodes_protocol` are fixed. `postcodes` should be
+   what you set via `busctl`.