diff --git a/doc/guides/maintaining-openssl.md b/doc/guides/maintaining-openssl.md
index 31f1a96da1..b1477e3c67 100644
--- a/doc/guides/maintaining-openssl.md
+++ b/doc/guides/maintaining-openssl.md
@@ -37,7 +37,7 @@ them.
 % mv openssl-1.1.0h openssl
 % git add --all openssl
 % git commit openssl
-````
+```
 
 The commit message can be written as (with the openssl version set
 to the relevant value):
@@ -61,8 +61,8 @@ separately after updating the openssl source as described above. The
 current patch implementation can be found in the `deps/openssl/patches`
 directory in the file `0001-deps-add-support-for-BoringSSL-QUIC-APIs.patch`.
 
-```text
-    $ git am deps/openssl/patches 0001-deps-add-support-for-BoringSSL-QUIC-APIs.patch
+```console
+% git am deps/openssl/patches 0001-deps-add-support-for-BoringSSL-QUIC-APIs.patch
 ```
 
 The patch file itself is generated by squashing commits from the
@@ -80,10 +80,10 @@ The patch is currently supported only for openssl-1.1.1e.
 Use `make` to regenerate all platform dependent files in
 `deps/openssl/config/archs/`:
 ```console
-# On non-linux machines
+# On non-Linux machines
 % make gen-openssl
 
-# On Linux machine
+# On Linux machines
 % make -C deps/openssl/config
 ```