diff --git a/java8/src/main/java/org/jetbrains/annotations/BlockingExecutor.java b/java8/src/main/java/org/jetbrains/annotations/BlockingExecutor.java
index 17c12e3..0560911 100644
--- a/java8/src/main/java/org/jetbrains/annotations/BlockingExecutor.java
+++ b/java8/src/main/java/org/jetbrains/annotations/BlockingExecutor.java
@@ -26,7 +26,7 @@
  *
  * <p>
  * Example 1 (Kotlin coroutines):
- * <pre>{@code
+ * <pre><code>
  *  class BlockingExampleService {
  *      val dispatcher: @BlockingExecutor CoroutineContext
  *          get() { ... }
@@ -37,26 +37,26 @@
  *          }
  *      }
  *
- *      @Blocking fun blockingBuzz() { ... }
+ *      &#064;Blocking fun blockingBuzz() { ... }
  *  }
- * }</pre>
+ * </code></pre>
  *
  * <p>
  * Example 2 (Java with Reactor framework):
- * <pre>{@code
+ * <pre><code>
  * class BlockingExampleService {
  *     private static final @BlockingExecutor Scheduler blockingScheduler =
  *             Schedulers.newBoundedElastic(4, 10, "executor");
  *
- *     public Flux<String> foo(Flux<String> urls) {
+ *     public Flux&lt;String&gt; foo(Flux&lt;String&gt; urls) {
  *         return urls.publishOn(blockingScheduler)
- *                 .map(url -> blockingBuzz(url));  // no IDE warning
+ *                 .map(url -&gt; blockingBuzz(url));  // no IDE warning
  *     }
  *
- *     @Blocking
+ *     &#064;Blocking
  *     private String blockingBuzz(String url) { ... }
  * }
- * }</pre>
+ * </code></pre>
  *
  * @see Blocking
  * @see NonBlocking
diff --git a/java8/src/main/java/org/jetbrains/annotations/NonBlockingExecutor.java b/java8/src/main/java/org/jetbrains/annotations/NonBlockingExecutor.java
index 8381a3e..92a3717 100644
--- a/java8/src/main/java/org/jetbrains/annotations/NonBlockingExecutor.java
+++ b/java8/src/main/java/org/jetbrains/annotations/NonBlockingExecutor.java
@@ -27,7 +27,7 @@
  *
  * <p>
  * Example 1 (Kotlin coroutines):
- * <pre>{@code
+ * <pre><code>
  *  class NonBlockingExampleService {
  *      val dispatcher: @NonBlockingExecutor CoroutineContext
  *          get() { ... }
@@ -38,26 +38,26 @@
  *          }
  *      }
  *
- *      @Blocking fun blockingBuzz() { ... }
+ *      &#064;Blocking fun blockingBuzz() { ... }
  *  }
- * }</pre>
+ * </code></pre>
  *
  * <p>
  * Example 2 (Java with Reactor framework):
- * <pre>{@code
+ * <pre><code>
  *  class NonBlockingExampleService {
  *      private static final @NonBlockingExecutor Scheduler operationsScheduler =
  *              Schedulers.newParallel("parallel");
  *
- *      public Flux<String> foo(Flux<String> urls) {
+ *      public Flux&lt;String&gt; foo(Flux&lt;String&gt; urls) {
  *          return urls.publishOn(operationsScheduler)
- *                  .filter(url -> blockingBuzz(url) != null);  // IDE warning: `Possibly blocking call in non-blocking context`
+ *                  .filter(url -&gt; blockingBuzz(url) != null);  // IDE warning: `Possibly blocking call in non-blocking context`
  *      }
  *
- *      @Blocking
+ *      &#064;Blocking
  *      private String blockingBuzz(String url) { ... }
  *  }
- * }</pre>
+ * </code></pre>
  *  @see Blocking
  *  @see NonBlocking
  */