diff --git a/docs/src/juliacall.md b/docs/src/juliacall.md
index bd7e7c09..84bdae00 100644
--- a/docs/src/juliacall.md
+++ b/docs/src/juliacall.md
@@ -182,7 +182,7 @@ then the above code will take 20 seconds because the sleeps run one after anothe
 
 It is very important that any function called with `_jl_call_nogil` does not interact
 with Python at all unless it re-locks the GIL first, such as by using
-[PythonCall.GIL.@lock](@ref).
+[`PythonCall.GIL.@lock`](@ref).
 
 You can also use [multi-threading from Julia](@ref jl-multi-threading).
 
diff --git a/docs/src/pythoncall.md b/docs/src/pythoncall.md
index 7c604b9a..18f3a086 100644
--- a/docs/src/pythoncall.md
+++ b/docs/src/pythoncall.md
@@ -93,7 +93,7 @@ functionality.
 
 ## Executing Python scripts
 
-A common use case is calling multiple blocks of Python code from Julia interactively. This can be accomplished in PythonCall via the [@pyexec](@ref) macro. For example, the sentence parsing application in the [Getting started](@ref py_getting_started) section could be rewritten as:
+A common use case is calling multiple blocks of Python code from Julia interactively. This can be accomplished in PythonCall via the [`@pyexec`](@ref) macro. For example, the sentence parsing application in the [Getting started](@ref py_getting_started) section could be rewritten as:
 
 ```julia-repl
 julia> @pyexec """
@@ -135,7 +135,7 @@ julia> plusone
 11.0
 ```
 
-Here we demonstrate passing a named variable, `num`, via the use of the `=>` syntax again, and returning named output, with the last element, `plusone`, being cast to a Julia object via the `::` syntax. See [@pyexec](@ref), [@pyeval](@ref), and their functional forms [pyexec](@ref) and [pyeval](@ref), for more.
+Here we demonstrate passing a named variable, `num`, via the use of the `=>` syntax again, and returning named output, with the last element, `plusone`, being cast to a Julia object via the `::` syntax. See [`@pyexec`](@ref), [`@pyeval`](@ref), and their functional forms [`pyexec`](@ref) and [`pyeval`](@ref), for more.
 
 ## Conversion between Julia and Python