diff --git a/docs/ref/api/msg/nng_msg_header.md b/docs/ref/api/msg/nng_msg_header.md
index 7c25347c3..7743684a6 100644
--- a/docs/ref/api/msg/nng_msg_header.md
+++ b/docs/ref/api/msg/nng_msg_header.md
@@ -40,7 +40,7 @@ should be considered overhead in the protocols where they appear.
 
 > [!TIP]
 > Most applications should not need to access the message header content
-> directly, unless they ar working with [raw mode][raw] sockets.
+> directly, unless they are working with [raw mode][raw] sockets.
 
 The `nng_msg_header` function returns a pointer to the start of the header
 content of the message _msg_.
diff --git a/docs/ref/tran/socket.md b/docs/ref/tran/socket.md
index c55966a87..24b7cf68a 100644
--- a/docs/ref/tran/socket.md
+++ b/docs/ref/tran/socket.md
@@ -2,7 +2,7 @@
 
 ## Description
 
-The {{i:_socket_ transport}} supports communication between
+The {{i:*socket* transport}} supports communication between
 peers across arbitrary BSD sockets, such as those that are
 created with [`nng_socket_pair`][nng_socket_pair].
 
diff --git a/docs/ref/tran/udp.md b/docs/ref/tran/udp.md
index 7c389028f..e79120852 100644
--- a/docs/ref/tran/udp.md
+++ b/docs/ref/tran/udp.md
@@ -2,7 +2,7 @@
 
 ## Description
 
-The {{i:_udp_ transport}} supports communication between peers using {{i:UDP}}.
+The {{i:*udp* transport}} supports communication between peers using {{i:UDP}}.
 
 UDP is a very light-weight connection-less, unreliable, unordered delivery mechanism.