diff --git a/src/HPath/IO/Errors.hs b/src/HPath/IO/Errors.hs
index 865c47d..282d6da 100644
--- a/src/HPath/IO/Errors.hs
+++ b/src/HPath/IO/Errors.hs
@@ -218,7 +218,7 @@ sameFile fp1 fp2 =
 -- source directory with all device+file IDs of the parent directories
 -- of the destination.
 throwDestinationInSource :: Path Abs -- ^ source dir
-                         -> Path Abs -- ^ full destination, `dirname dest`
+                         -> Path Abs -- ^ full destination, @dirname dest@
                                      --   must exist
                          -> IO ()
 throwDestinationInSource source dest = do
diff --git a/src/System/Posix/FD.hs b/src/System/Posix/FD.hs
index ce0b45e..1fee686 100644
--- a/src/System/Posix/FD.hs
+++ b/src/System/Posix/FD.hs
@@ -60,13 +60,13 @@ open_ str how optional_flags maybe_mode = do
 -- |Open and optionally create this file. See 'System.Posix.Files'
 -- for information on how to use the 'FileMode' type.
 --
--- Note that passing `Just x` as the 4th argument triggers the
+-- Note that passing @Just x@ as the 4th argument triggers the
 -- `oCreat` status flag, which must be set when you pass in `oExcl`
 -- to the status flags. Also see the manpage for @open(2)@.
 openFd :: RawFilePath
        -> Posix.OpenMode
        -> [Flags]               -- ^ status flags of @open(2)@
-       -> Maybe Posix.FileMode  -- ^ Just x => creates the file with the given modes, Nothing => the file must exist.
+       -> Maybe Posix.FileMode  -- ^ @Just x@ => creates the file with the given modes, Nothing => the file must exist.
        -> IO Posix.Fd
 openFd name how optional_flags maybe_mode =
    withFilePath name $ \str ->