diff --git a/docs/api/puppeteer.page.screencast.md b/docs/api/puppeteer.page.screencast.md
index c87b30ba7a8..356512a456a 100644
--- a/docs/api/puppeteer.page.screencast.md
+++ b/docs/api/puppeteer.page.screencast.md
@@ -26,9 +26,9 @@ Promise<[ScreenRecorder](./puppeteer.screenrecorder.md)>
 
 ## Remarks
 
-All recordings will be \[WebM\](https://www.webmproject.org/) format using the \[VP9\](https://www.webmproject.org/vp9/) video codec. The FPS is 30.
+All recordings will be [WebM](https://www.webmproject.org/) format using the [VP9](https://www.webmproject.org/vp9/) video codec. The FPS is 30.
 
-You must have \[ffmpeg\](https://ffmpeg.org/) installed on your system.
+You must have [ffmpeg](https://ffmpeg.org/) installed on your system.
 
 ## Example
 
diff --git a/packages/puppeteer-core/src/api/Page.ts b/packages/puppeteer-core/src/api/Page.ts
index ea94e169ce3..be796c59754 100644
--- a/packages/puppeteer-core/src/api/Page.ts
+++ b/packages/puppeteer-core/src/api/Page.ts
@@ -2317,12 +2317,15 @@ export abstract class Page extends EventEmitter<PageEvents> {
   /**
    * Captures a screencast of this {@link Page | page}.
    *
-   * @remarks All recordings will be [WebM](https://www.webmproject.org/) format using
-   * the [VP9](https://www.webmproject.org/vp9/) video codec. The FPS is 30.
+   * @remarks
    *
-   * You must have [ffmpeg](https://ffmpeg.org/) installed on your system.
+   * All recordings will be {@link https://www.webmproject.org/ | WebM} format using
+   * the {@link https://www.webmproject.org/vp9/ | VP9} video codec. The FPS is 30.
    *
-   * @example Recording a {@link Page | page}:
+   * You must have {@link https://ffmpeg.org/ | ffmpeg} installed on your system.
+   *
+   * @example
+   * Recording a {@link Page | page}:
    *
    * ```
    * import puppeteer from 'puppeteer';