diff --git a/java/ql/lib/semmle/code/java/Expr.qll b/java/ql/lib/semmle/code/java/Expr.qll
index d4b43a9dfab..c609c35cd71 100644
--- a/java/ql/lib/semmle/code/java/Expr.qll
+++ b/java/ql/lib/semmle/code/java/Expr.qll
@@ -1040,7 +1040,7 @@ class ReferenceEqualityTest extends EqualityTest {
 /** A common super-class that represents unary operator expressions. */
 class UnaryExpr extends Expr, @unaryexpr {
   /**
-   * DEPRECATED: Use getOperand() instead.
+   * DEPRECATED: Use `getOperand()` instead.
    *
    * Gets the operand expression.
    */
@@ -1464,7 +1464,7 @@ class ConditionalExpr extends Expr, @conditionalexpr {
   Expr getCondition() { result.isNthChildOf(this, 0) }
 
   /**
-   * DEPRECATED: Use getThen() instead.
+   * DEPRECATED: Use `getThen()` instead.
    *
    * Gets the expression that is evaluated if the condition of this
    * conditional expression evaluates to `true`.
@@ -1472,7 +1472,7 @@ class ConditionalExpr extends Expr, @conditionalexpr {
   deprecated Expr getTrueExpr() { result.isNthChildOf(this, 1) }
 
   /**
-   * DEPRECATED: Use getElse() instead.
+   * DEPRECATED: Use `getElse()` instead.
    *
    * Gets the expression that is evaluated if the condition of this
    * conditional expression evaluates to `false`.
diff --git a/java/ql/lib/semmle/code/java/Statement.qll b/java/ql/lib/semmle/code/java/Statement.qll
index b74489e24f4..942f5283039 100644
--- a/java/ql/lib/semmle/code/java/Statement.qll
+++ b/java/ql/lib/semmle/code/java/Statement.qll
@@ -168,7 +168,7 @@ class ForStmt extends ConditionalStmt, LoopStmtImpl, @forstmt {
   }
 
   /**
-   * DEPRECATED: Use getBody() instead.
+   * DEPRECATED: Use `getBody()` instead.
    *
    * Gets the body of this `for` loop.
    */
@@ -216,7 +216,7 @@ class EnhancedForStmt extends LoopStmtImpl, @enhancedforstmt {
   Expr getExpr() { result.isNthChildOf(this, 1) }
 
   /**
-   * DEPRECATED: Use getBody() instead.
+   * DEPRECATED: Use `getBody()` instead.
    *
    * Gets the body of this enhanced `for` loop.
    */
@@ -240,7 +240,7 @@ class WhileStmt extends ConditionalStmt, LoopStmtImpl, @whilestmt {
   override Expr getCondition() { result.getParent() = this }
 
   /**
-   * DEPRECATED: Use getBody() instead.
+   * DEPRECATED: Use `getBody()` instead.
    *
    * Gets the body of this `while` loop.
    */
@@ -264,7 +264,7 @@ class DoStmt extends ConditionalStmt, LoopStmtImpl, @dostmt {
   override Expr getCondition() { result.getParent() = this }
 
   /**
-   * DEPRECATED: Use getBody() instead.
+   * DEPRECATED: Use `getBody()` instead.
    *
    * Gets the body of this `do` loop.
    */
@@ -642,7 +642,7 @@ class SynchronizedStmt extends Stmt, @synchronizedstmt {
 /** A `return` statement. */
 class ReturnStmt extends Stmt, @returnstmt {
   /**
-   * DEPRECATED: Use getExpr() instead.
+   * DEPRECATED: Use `getExpr()` instead.
    *
    * Gets the expression returned by this `return` statement, if any.
    */