diff --git a/.github/workflows/publish_canary_docker.yml b/.github/workflows/publish_canary_docker.yml
index afeb9fbbbe..89b4fb486c 100644
--- a/.github/workflows/publish_canary_docker.yml
+++ b/.github/workflows/publish_canary_docker.yml
@@ -6,7 +6,7 @@ on:
       - master
       - release-*
     paths:
-      - docs/docker/**
+      - utils/docker/**
       - browsers.json
       - .github/workflows/publish_canary_docker.yml
 
@@ -29,12 +29,12 @@ jobs:
         node-version: 10.15
     - run: npm ci
     - run: npm run build
-    - run: ./docs/docker/build.sh bionic playwright:localbuild-bionic
-    - run: ./docs/docker/build.sh focal playwright:localbuild-focal
+    - run: ./utils/docker/build.sh bionic playwright:localbuild-bionic
+    - run: ./utils/docker/build.sh focal playwright:localbuild-focal
     - name: tag & publish
       run: |
-        ./docs/docker/tag_and_push.sh playwright:localbuild-bionic playwright.azurecr.io/public/playwright:next
-        ./docs/docker/tag_and_push.sh playwright:localbuild-bionic playwright.azurecr.io/public/playwright:next-bionic
-        ./docs/docker/tag_and_push.sh playwright:localbuild-bionic playwright.azurecr.io/public/playwright:sha-${{ github.sha }}
-        ./docs/docker/tag_and_push.sh playwright:localbuild-focal playwright.azurecr.io/public/playwright:next-focal
+        ./utils/docker/tag_and_push.sh playwright:localbuild-bionic playwright.azurecr.io/public/playwright:next
+        ./utils/docker/tag_and_push.sh playwright:localbuild-bionic playwright.azurecr.io/public/playwright:next-bionic
+        ./utils/docker/tag_and_push.sh playwright:localbuild-bionic playwright.azurecr.io/public/playwright:sha-${{ github.sha }}
+        ./utils/docker/tag_and_push.sh playwright:localbuild-focal playwright.azurecr.io/public/playwright:next-focal
 
diff --git a/.github/workflows/publish_release.yml b/.github/workflows/publish_release.yml
index 6e061565b8..551089703f 100644
--- a/.github/workflows/publish_release.yml
+++ b/.github/workflows/publish_release.yml
@@ -40,17 +40,17 @@ jobs:
         node-version: 10.15
     - run: npm ci
     - run: npm run build
-    - run: ./docs/docker/build.sh bionic playwright:localbuild-bionic
-    - run: ./docs/docker/build.sh focal playwright:localbuild-focal
+    - run: ./utils/docker/build.sh bionic playwright:localbuild-bionic
+    - run: ./utils/docker/build.sh focal playwright:localbuild-focal
     - name: tag & publish
       run: |
         # GITHUB_REF has a form of `refs/tags/v1.3.0`.
         # TAG_NAME would be `v1.3.0`
         TAG_NAME=${GITHUB_REF#refs/tags/}
-        ./docs/docker/tag_and_push.sh playwright:localbuild-bionic playwright.azurecr.io/public/playwright:latest
-        ./docs/docker/tag_and_push.sh playwright:localbuild-bionic playwright.azurecr.io/public/playwright:bionic
-        ./docs/docker/tag_and_push.sh playwright:localbuild-bionic playwright.azurecr.io/public/playwright:${TAG_NAME}
-        ./docs/docker/tag_and_push.sh playwright:localbuild-bionic playwright.azurecr.io/public/playwright:${TAG_NAME}-bionic
+        ./utils/docker/tag_and_push.sh playwright:localbuild-bionic playwright.azurecr.io/public/playwright:latest
+        ./utils/docker/tag_and_push.sh playwright:localbuild-bionic playwright.azurecr.io/public/playwright:bionic
+        ./utils/docker/tag_and_push.sh playwright:localbuild-bionic playwright.azurecr.io/public/playwright:${TAG_NAME}
+        ./utils/docker/tag_and_push.sh playwright:localbuild-bionic playwright.azurecr.io/public/playwright:${TAG_NAME}-bionic
 
-        ./docs/docker/tag_and_push.sh playwright:localbuild-focal playwright.azurecr.io/public/playwright:focal
-        ./docs/docker/tag_and_push.sh playwright:localbuild-focal playwright.azurecr.io/public/playwright:${TAG_NAME}-focal
+        ./utils/docker/tag_and_push.sh playwright:localbuild-focal playwright.azurecr.io/public/playwright:focal
+        ./utils/docker/tag_and_push.sh playwright:localbuild-focal playwright.azurecr.io/public/playwright:${TAG_NAME}-focal
diff --git a/docs/README.md b/docs/out/README.md
similarity index 98%
rename from docs/README.md
rename to docs/out/README.md
index 1599dcdd09..cc711f6d9d 100644
--- a/docs/README.md
+++ b/docs/out/README.md
@@ -38,10 +38,10 @@ Playwright is a library to automate [Chromium](https://www.chromium.org/Home), [
    - [Page object models](./pom.md)
 1. Integrations
    - [Test runners](./test-runners.md)
-   - [Docker](./docker/README.md)
+   - [Docker](././docker.md)
    - [Continuous integration](./ci.md)
 1. Reference
-   - [API Reference](./api.md)
+   - [API Reference](./api/class-playwright.md)
    - [Actionability](./actionability.md)
    - [Advanced installation](./installation.md)
    - [Extensibility](./extensibility.md)
@@ -49,6 +49,7 @@ Playwright is a library to automate [Chromium](https://www.chromium.org/Home), [
    - [Slack community](https://join.slack.com/t/playwright/shared_invite/enQtOTEyMTUxMzgxMjIwLThjMDUxZmIyNTRiMTJjNjIyMzdmZDA3MTQxZWUwZTFjZjQwNGYxZGM5MzRmNzZlMWI5ZWUyOTkzMjE5Njg1NDg)
    - [Stack Overflow](https://stackoverflow.com/tags/playwright)
    - [GitHub](https://github.com/microsoft/playwright/issues)
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/actionability.md b/docs/out/actionability.md
similarity index 89%
rename from docs/actionability.md
rename to docs/out/actionability.md
index a776cf910a..dabba1f0d9 100644
--- a/docs/actionability.md
+++ b/docs/out/actionability.md
@@ -11,13 +11,13 @@ Some actions like `page.click()` support `{force: true}` option that disable non
 
 | Actions | Performed checks |
 | ------ | ------- |
-| `check()`<br>`click()`<br>`dblclick()`<br>`tap()`<br>`uncheck()` | [Visible]<br>[Stable]<br>[Enabled]<br>[Receiving Events]<br>[Attached] |
-| `hover()` | [Visible]<br>[Stable]<br>[Receiving Events]<br>[Attached] |
-| `fill()` | [Visible]<br>[Enabled]<br>[Editable]<br>[Attached] |
-| `dispatchEvent()`<br>`focus()`<br>`press()`<br>`setInputFiles()`<br>`selectOption()`<br>`type()` | [Attached] |
-| `scrollIntoViewIfNeeded()`<br>`screenshot()` | [Visible]<br>[Stable]<br>[Attached] |
-| `selectText()` | [Visible]<br>[Attached] |
-| `getAttribute()`<br>`innerText()`<br>`innerHTML()`<br>`textContent()` | [Attached] |
+| `check()`<br></br>`click()`<br></br>`dblclick()`<br></br>`tap()`<br></br>`uncheck()` | [Visible]<br></br>[Stable]<br></br>[Enabled]<br></br>[Receiving Events]<br></br>[Attached] |
+| `hover()` | [Visible]<br></br>[Stable]<br></br>[Receiving Events]<br></br>[Attached] |
+| `fill()` | [Visible]<br></br>[Enabled]<br></br>[Editable]<br></br>[Attached] |
+| `dispatchEvent()`<br></br>`focus()`<br></br>`press()`<br></br>`setInputFiles()`<br></br>`selectOption()`<br></br>`type()` | [Attached] |
+| `scrollIntoViewIfNeeded()`<br></br>`screenshot()` | [Visible]<br></br>[Stable]<br></br>[Attached] |
+| `selectText()` | [Visible]<br></br>[Attached] |
+| `getAttribute()`<br></br>`innerText()`<br></br>`innerHTML()`<br></br>`textContent()` | [Attached] |
 
 ### Visible
 
@@ -57,6 +57,7 @@ For example, consider a scenario where Playwright will click `Sign Up` button re
 [Editable]: #editable "Editable"
 [Receiving Events]: #receiving-events "Receiving Events"
 [Attached]: #attached "Attached"
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/class-accessibility.md b/docs/out/api/class-accessibility.md
similarity index 99%
rename from docs/class-accessibility.md
rename to docs/out/api/class-accessibility.md
index b18c43f229..f790159c4f 100644
--- a/docs/class-accessibility.md
+++ b/docs/out/api/class-accessibility.md
@@ -1,6 +1,6 @@
 ---
 id: class-accessibility
-title: "class: Accessibility"
+title: "Accessibility"
 ---
 
 
@@ -15,7 +15,7 @@ Most of the accessibility tree gets filtered out when converting from Blink AX T
 
 - [accessibility.snapshot([options])](api/class-accessibility.md#accessibilitysnapshotoptions)
 
-#### accessibility.snapshot([options])
+## accessibility.snapshot([options])
 - `options` <[Object]>
   - `interestingOnly` <[boolean]> Prune uninteresting nodes from the tree. Defaults to `true`.
   - `root` <[ElementHandle]> The root DOM element for the snapshot. Defaults to the whole page.
@@ -76,6 +76,7 @@ function findFocusedNode(node) {
 }
 ```
 
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/class-browser.md b/docs/out/api/class-browser.md
similarity index 98%
rename from docs/class-browser.md
rename to docs/out/api/class-browser.md
index f51623aacf..cafe4d446f 100644
--- a/docs/class-browser.md
+++ b/docs/out/api/class-browser.md
@@ -1,6 +1,6 @@
 ---
 id: class-browser
-title: "class: Browser"
+title: "Browser"
 ---
 
 * extends: [EventEmitter](https://nodejs.org/api/events.html#events_class_eventemitter)
@@ -31,13 +31,13 @@ See [ChromiumBrowser], [FirefoxBrowser] and [WebKitBrowser] for browser-specific
 - [browser.newPage([options])](api/class-browser.md#browsernewpageoptions)
 - [browser.version()](api/class-browser.md#browserversion)
 
-#### browser.on('disconnected')
+## browser.on('disconnected')
 
 Emitted when Browser gets disconnected from the browser application. This might happen because of one of the following:
 * Browser application is closed or crashed.
 * The [browser.close()](api/class-browser.md#browserclose) method was called.
 
-#### browser.close()
+## browser.close()
 - returns: <[Promise]>
 
 In case this browser is obtained using [browserType.launch([options])](api/class-browsertype.md#browsertypelaunchoptions), closes the browser and all of its pages (if any were opened).
@@ -46,7 +46,7 @@ In case this browser is obtained using [browserType.connect(params)](api/class-b
 
 The [Browser] object itself is considered to be disposed and cannot be used anymore.
 
-#### browser.contexts()
+## browser.contexts()
 - returns: <[Array]<[BrowserContext]>>
 
 Returns an array of all open browser contexts. In a newly created browser, this will return zero browser contexts.
@@ -59,12 +59,12 @@ const context = await browser.newContext();
 console.log(browser.contexts().length); // prints `1`
 ```
 
-#### browser.isConnected()
+## browser.isConnected()
 - returns: <[boolean]>
 
 Indicates that the browser is connected.
 
-#### browser.newContext([options])
+## browser.newContext([options])
 - `options` <[Object]>
   - `acceptDownloads` <[boolean]> Whether to automatically download all the attachments. Defaults to `false` where all the downloads are canceled.
   - `bypassCSP` <[boolean]> Toggles bypassing page's Content-Security-Policy.
@@ -139,7 +139,7 @@ Creates a new browser context. It won't share cookies/cache with other browser c
 })();
 ```
 
-#### browser.newPage([options])
+## browser.newPage([options])
 - `options` <[Object]>
   - `acceptDownloads` <[boolean]> Whether to automatically download all the attachments. Defaults to `false` where all the downloads are canceled.
   - `bypassCSP` <[boolean]> Toggles bypassing page's Content-Security-Policy.
@@ -205,10 +205,11 @@ Creates a new page in a new browser context. Closing this page will close the co
 
 This is a convenience API that should only be used for the single-page scenarios and short snippets. Production code and testing frameworks should explicitly create [browser.newContext([options])](api/class-browser.md#browsernewcontextoptions) followed by the [browserContext.newPage()](api/class-browsercontext.md#browsercontextnewpage) to control their exact life times.
 
-#### browser.version()
+## browser.version()
 - returns: <[string]>
 
 Returns the browser version.
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/class-browsercontext.md b/docs/out/api/class-browsercontext.md
similarity index 95%
rename from docs/class-browsercontext.md
rename to docs/out/api/class-browsercontext.md
index a7aa14b6e4..7df6690300 100644
--- a/docs/class-browsercontext.md
+++ b/docs/out/api/class-browsercontext.md
@@ -1,6 +1,6 @@
 ---
 id: class-browsercontext
-title: "class: BrowserContext"
+title: "BrowserContext"
 ---
 
 * extends: [EventEmitter](https://nodejs.org/api/events.html#events_class_eventemitter)
@@ -47,14 +47,14 @@ await context.close();
 - [browserContext.unroute(url[, handler])](api/class-browsercontext.md#browsercontextunrouteurl-handler)
 - [browserContext.waitForEvent(event[, optionsOrPredicate])](api/class-browsercontext.md#browsercontextwaitforeventevent-optionsorpredicate)
 
-#### browserContext.on('close')
+## browserContext.on('close')
 
 Emitted when Browser context gets closed. This might happen because of one of the following:
 * Browser context is closed.
 * Browser application is closed or crashed.
 * The [browser.close()](api/class-browser.md#browserclose) method was called.
 
-#### browserContext.on('page')
+## browserContext.on('page')
 - type: <[Page]>
 
 The event is emitted when a new Page is created in the BrowserContext. The page may still be loading. The event will also fire for popup pages. See also [page.on('popup')](api/class-page.md#pageonpopup) to receive events about popups relevant to a specific page.
@@ -71,7 +71,7 @@ console.log(await page.evaluate('location.href'));
 
 > **NOTE** Use [page.waitForLoadState([state, options])](api/class-page.md#pagewaitforloadstatestate-options) to wait until the page gets to a particular state (you should not need it in most cases).
 
-#### browserContext.addCookies(cookies)
+## browserContext.addCookies(cookies)
 - `cookies` <[Array]<[Object]>>
   - `name` <[string]> **required**
   - `value` <[string]> **required**
@@ -90,7 +90,7 @@ Adds cookies into this browser context. All pages within this context will have
 await browserContext.addCookies([cookieObject1, cookieObject2]);
 ```
 
-#### browserContext.addInitScript(script[, arg])
+## browserContext.addInitScript(script[, arg])
 - `script` <[function]|[string]|[Object]> Script to be evaluated in all pages in the browser context.
   - `path` <[string]> Path to the JavaScript file. If `path` is a relative path, then it is resolved relative to the current working directory. Optional.
   - `content` <[string]> Raw script content. Optional.
@@ -119,17 +119,17 @@ await browserContext.addInitScript({
 
 > **NOTE** The order of evaluation of multiple scripts installed via [browserContext.addInitScript(script[, arg])](api/class-browsercontext.md#browsercontextaddinitscriptscript-arg) and [page.addInitScript(script[, arg])](api/class-page.md#pageaddinitscriptscript-arg) is not defined.
 
-#### browserContext.browser()
+## browserContext.browser()
 - returns: <[null]|[Browser]>
 
 Returns the browser instance of the context. If it was launched as a persistent context null gets returned.
 
-#### browserContext.clearCookies()
+## browserContext.clearCookies()
 - returns: <[Promise]>
 
 Clears context cookies.
 
-#### browserContext.clearPermissions()
+## browserContext.clearPermissions()
 - returns: <[Promise]>
 
 Clears all permission overrides for the browser context.
@@ -141,14 +141,14 @@ await context.grantPermissions(['clipboard-read']);
 context.clearPermissions();
 ```
 
-#### browserContext.close()
+## browserContext.close()
 - returns: <[Promise]>
 
 Closes the browser context. All the pages that belong to the browser context will be closed.
 
 > **NOTE** the default browser context cannot be closed.
 
-#### browserContext.cookies([urls])
+## browserContext.cookies([urls])
 - `urls` <[string]|[Array]<[string]>> Optional list of URLs.
 - returns: <[Promise]<[Array]<[Object]>>>
   - `name` <[string]>
@@ -162,7 +162,7 @@ Closes the browser context. All the pages that belong to the browser context wil
 
 If no URLs are specified, this method returns all cookies. If URLs are specified, only cookies that affect those URLs are returned.
 
-#### browserContext.exposeBinding(name, playwrightBinding[, options])
+## browserContext.exposeBinding(name, playwrightBinding[, options])
 - `name` <[string]> Name of the function on the window object.
 - `playwrightBinding` <[function]> Callback function that will be called in the Playwright's context.
 - `options` <[Object]>
@@ -213,7 +213,7 @@ await page.setContent(`
 `);
 ```
 
-#### browserContext.exposeFunction(name, playwrightFunction)
+## browserContext.exposeFunction(name, playwrightFunction)
 - `name` <[string]> Name of the function on the window object.
 - `playwrightFunction` <[function]> Callback function that will be called in the Playwright's context.
 - returns: <[Promise]>
@@ -248,7 +248,7 @@ const crypto = require('crypto');
 })();
 ```
 
-#### browserContext.grantPermissions(permissions[, options])
+## browserContext.grantPermissions(permissions[, options])
 - `permissions` <[Array]<[string]>> A permission or an array of permissions to grant. Permissions can be one of the following values:
   * `'geolocation'`
   * `'midi'`
@@ -272,17 +272,17 @@ const crypto = require('crypto');
 
 Grants specified permissions to the browser context. Only grants corresponding permissions to the given origin if specified.
 
-#### browserContext.newPage()
+## browserContext.newPage()
 - returns: <[Promise]<[Page]>>
 
 Creates a new page in the browser context.
 
-#### browserContext.pages()
+## browserContext.pages()
 - returns: <[Array]<[Page]>>
 
 Returns all open pages in the context. Non visible pages, such as `"background_page"`, will not be listed here. You can find them using [chromiumBrowserContext.backgroundPages()](api/class-chromiumbrowsercontext.md#chromiumbrowsercontextbackgroundpages).
 
-#### browserContext.route(url, handler)
+## browserContext.route(url, handler)
 - `url` <[string]|[RegExp]|[function]\([URL]\):[boolean]> A glob pattern, regex pattern or predicate receiving [URL] to match while routing.
 - `handler` <[function]\([Route], [Request]\)> handler function to route the request.
 - returns: <[Promise]>
@@ -313,7 +313,7 @@ Page routes (set up with [page.route(url, handler)](api/class-page.md#pagerouteu
 
 > **NOTE** Enabling routing disables http cache.
 
-#### browserContext.setDefaultNavigationTimeout(timeout)
+## browserContext.setDefaultNavigationTimeout(timeout)
 - `timeout` <[number]> Maximum navigation time in milliseconds
 
 This setting will change the default maximum navigation time for the following methods and related shortcuts:
@@ -326,14 +326,14 @@ This setting will change the default maximum navigation time for the following m
 
 > **NOTE** [page.setDefaultNavigationTimeout(timeout)](api/class-page.md#pagesetdefaultnavigationtimeouttimeout) and [page.setDefaultTimeout(timeout)](api/class-page.md#pagesetdefaulttimeouttimeout) take priority over [browserContext.setDefaultNavigationTimeout(timeout)](api/class-browsercontext.md#browsercontextsetdefaultnavigationtimeouttimeout).
 
-#### browserContext.setDefaultTimeout(timeout)
+## browserContext.setDefaultTimeout(timeout)
 - `timeout` <[number]> Maximum time in milliseconds
 
 This setting will change the default maximum time for all the methods accepting `timeout` option.
 
 > **NOTE** [page.setDefaultNavigationTimeout(timeout)](api/class-page.md#pagesetdefaultnavigationtimeouttimeout), [page.setDefaultTimeout(timeout)](api/class-page.md#pagesetdefaulttimeouttimeout) and [browserContext.setDefaultNavigationTimeout(timeout)](api/class-browsercontext.md#browsercontextsetdefaultnavigationtimeouttimeout) take priority over [browserContext.setDefaultTimeout(timeout)](api/class-browsercontext.md#browsercontextsetdefaulttimeouttimeout).
 
-#### browserContext.setExtraHTTPHeaders(headers)
+## browserContext.setExtraHTTPHeaders(headers)
 - `headers` <[Object]<[string], [string]>> An object containing additional HTTP headers to be sent with every request. All header values must be strings.
 - returns: <[Promise]>
 
@@ -341,7 +341,7 @@ The extra HTTP headers will be sent with every request initiated by any page in
 
 > **NOTE** `browserContext.setExtraHTTPHeaders` does not guarantee the order of headers in the outgoing requests.
 
-#### browserContext.setGeolocation(geolocation)
+## browserContext.setGeolocation(geolocation)
 - `geolocation` <[null]|[Object]>
   - `latitude` <[number]> Latitude between -90 and 90. **required**
   - `longitude` <[number]> Longitude between -180 and 180. **required**
@@ -356,7 +356,7 @@ await browserContext.setGeolocation({latitude: 59.95, longitude: 30.31667});
 
 > **NOTE** Consider using [browserContext.grantPermissions(permissions[, options])](api/class-browsercontext.md#browsercontextgrantpermissionspermissions-options) to grant permissions for the browser context pages to read its geolocation.
 
-#### browserContext.setHTTPCredentials(httpCredentials)
+## browserContext.setHTTPCredentials(httpCredentials)
 - `httpCredentials` <[null]|[Object]>
   - `username` <[string]> **required**
   - `password` <[string]> **required**
@@ -366,11 +366,11 @@ Provide credentials for [HTTP authentication](https://developer.mozilla.org/en-U
 
 > **NOTE** Browsers may cache credentials after successful authentication. Passing different credentials or passing `null` to disable authentication will be unreliable. To remove or replace credentials, create a new browser context instead.
 
-#### browserContext.setOffline(offline)
+## browserContext.setOffline(offline)
 - `offline` <[boolean]> Whether to emulate network being offline for the browser context.
 - returns: <[Promise]>
 
-#### browserContext.storageState([options])
+## browserContext.storageState([options])
 - `options` <[Object]>
   - `path` <[string]> The file path to save the storage state to. If `path` is a relative path, then it is resolved relative to [current working directory](https://nodejs.org/api/process.html#process_process_cwd). If no path is provided, storage state is still returned, but won't be saved to the disk.
 - returns: <[Promise]<[Object]>>
@@ -391,14 +391,14 @@ Provide credentials for [HTTP authentication](https://developer.mozilla.org/en-U
 
 Returns storage state for this browser context, contains current cookies and local storage snapshot.
 
-#### browserContext.unroute(url[, handler])
+## browserContext.unroute(url[, handler])
 - `url` <[string]|[RegExp]|[function]\([URL]\):[boolean]> A glob pattern, regex pattern or predicate receiving [URL] used to register a routing with [browserContext.route(url, handler)](api/class-browsercontext.md#browsercontextrouteurl-handler).
 - `handler` <[function]\([Route], [Request]\)> Optional handler function used to register a routing with [browserContext.route(url, handler)](api/class-browsercontext.md#browsercontextrouteurl-handler).
 - returns: <[Promise]>
 
 Removes a route created with [browserContext.route(url, handler)](api/class-browsercontext.md#browsercontextrouteurl-handler). When `handler` is not specified, removes all routes for the `url`.
 
-#### browserContext.waitForEvent(event[, optionsOrPredicate])
+## browserContext.waitForEvent(event[, optionsOrPredicate])
 - `event` <[string]> Event name, same one would pass into `browserContext.on(event)`.
 - `optionsOrPredicate` <[Function]|[Object]> Either a predicate that receives an event or an options object. Optional.
   - `predicate` <[Function]> receives the event data and resolves to truthy value when the waiting should resolve.
@@ -412,6 +412,7 @@ const context = await browser.newContext();
 await context.grantPermissions(['geolocation']);
 ```
 
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/class-browserserver.md b/docs/out/api/class-browserserver.md
similarity index 96%
rename from docs/class-browserserver.md
rename to docs/out/api/class-browserserver.md
index ef78253ee6..0c30606d87 100644
--- a/docs/class-browserserver.md
+++ b/docs/out/api/class-browserserver.md
@@ -1,6 +1,6 @@
 ---
 id: class-browserserver
-title: "class: BrowserServer"
+title: "BrowserServer"
 ---
 
 
@@ -11,31 +11,32 @@ title: "class: BrowserServer"
 - [browserServer.process()](api/class-browserserver.md#browserserverprocess)
 - [browserServer.wsEndpoint()](api/class-browserserver.md#browserserverwsendpoint)
 
-#### browserServer.on('close')
+## browserServer.on('close')
 
 Emitted when the browser server closes.
 
-#### browserServer.close()
+## browserServer.close()
 - returns: <[Promise]>
 
 Closes the browser gracefully and makes sure the process is terminated.
 
-#### browserServer.kill()
+## browserServer.kill()
 - returns: <[Promise]>
 
 Kills the browser process and waits for the process to exit.
 
-#### browserServer.process()
+## browserServer.process()
 - returns: <[ChildProcess]>
 
 Spawned browser application process.
 
-#### browserServer.wsEndpoint()
+## browserServer.wsEndpoint()
 - returns: <[string]>
 
 Browser websocket url.
 
 Browser websocket endpoint which can be used as an argument to [browserType.connect(params)](api/class-browsertype.md#browsertypeconnectparams) to establish connection to the browser.
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/class-browsertype.md b/docs/out/api/class-browsertype.md
similarity index 98%
rename from docs/class-browsertype.md
rename to docs/out/api/class-browsertype.md
index 0a3de21fd4..c15bf587a7 100644
--- a/docs/class-browsertype.md
+++ b/docs/out/api/class-browsertype.md
@@ -1,6 +1,6 @@
 ---
 id: class-browsertype
-title: "class: BrowserType"
+title: "BrowserType"
 ---
 
 
@@ -26,7 +26,7 @@ const { chromium } = require('playwright');  // Or 'firefox' or 'webkit'.
 - [browserType.launchServer([options])](api/class-browsertype.md#browsertypelaunchserveroptions)
 - [browserType.name()](api/class-browsertype.md#browsertypename)
 
-#### browserType.connect(params)
+## browserType.connect(params)
 - `params` <[Object]>
   - `wsEndpoint` <[string]> A browser websocket endpoint to connect to. **required**
   - `slowMo` <[number]> Slows down Playwright operations by the specified amount of milliseconds. Useful so that you can see what is going on. Defaults to 0.
@@ -36,12 +36,12 @@ const { chromium } = require('playwright');  // Or 'firefox' or 'webkit'.
 
 This methods attaches Playwright to an existing browser instance.
 
-#### browserType.executablePath()
+## browserType.executablePath()
 - returns: <[string]>
 
 A path where Playwright expects to find a bundled browser executable.
 
-#### browserType.launch([options])
+## browserType.launch([options])
 - `options` <[Object]>
   - `args` <[Array]<[string]>> Additional arguments to pass to the browser instance. The list of Chromium flags can be found [here](http://peter.sh/experiments/chromium-command-line-switches/).
   - `chromiumSandbox` <[boolean]> Enable Chromium sandboxing. Defaults to `false`.
@@ -83,7 +83,7 @@ const browser = await chromium.launch({  // Or 'firefox' or 'webkit'.
 >
 > See [`this article`](https://www.howtogeek.com/202825/what%E2%80%99s-the-difference-between-chromium-and-chrome/) for a description of the differences between Chromium and Chrome. [`This article`](https://chromium.googlesource.com/chromium/src/+/lkgr/docs/chromium_browser_vs_google_chrome.md) describes some differences for Linux users.
 
-#### browserType.launchPersistentContext(userDataDir[, options])
+## browserType.launchPersistentContext(userDataDir[, options])
 - `userDataDir` <[string]> Path to a User Data Directory, which stores browser session data like cookies and local storage. More details for [Chromium](https://chromium.googlesource.com/chromium/src/+/master/docs/user_data_dir.md) and [Firefox](https://developer.mozilla.org/en-US/docs/Mozilla/Command_Line_Options#User_Profile).
 - `options` <[Object]>
   - `acceptDownloads` <[boolean]> Whether to automatically download all the attachments. Defaults to `false` where all the downloads are canceled.
@@ -147,7 +147,7 @@ Returns the persistent browser context instance.
 
 Launches browser that uses persistent storage located at `userDataDir` and returns the only context. Closing this context will automatically close the browser.
 
-#### browserType.launchServer([options])
+## browserType.launchServer([options])
 - `options` <[Object]>
   - `args` <[Array]<[string]>> Additional arguments to pass to the browser instance. The list of Chromium flags can be found [here](http://peter.sh/experiments/chromium-command-line-switches/).
   - `chromiumSandbox` <[boolean]> Enable Chromium sandboxing. Defaults to `true`.
@@ -188,10 +188,11 @@ const { chromium } = require('playwright');  // Or 'webkit' or 'firefox'.
 })();
 ```
 
-#### browserType.name()
+## browserType.name()
 - returns: <[string]>
 
 Returns browser name. For example: `'chromium'`, `'webkit'` or `'firefox'`.
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/class-cdpsession.md b/docs/out/api/class-cdpsession.md
similarity index 98%
rename from docs/class-cdpsession.md
rename to docs/out/api/class-cdpsession.md
index 93bfa9c6a4..4e053b95e9 100644
--- a/docs/class-cdpsession.md
+++ b/docs/out/api/class-cdpsession.md
@@ -1,6 +1,6 @@
 ---
 id: class-cdpsession
-title: "class: CDPSession"
+title: "CDPSession"
 ---
 
 * extends: [EventEmitter](https://nodejs.org/api/events.html#events_class_eventemitter)
@@ -28,15 +28,16 @@ await client.send('Animation.setPlaybackRate', {
 - [cdpSession.detach()](api/class-cdpsession.md#cdpsessiondetach)
 - [cdpSession.send(method[, params])](api/class-cdpsession.md#cdpsessionsendmethod-params)
 
-#### cdpSession.detach()
+## cdpSession.detach()
 - returns: <[Promise]>
 
 Detaches the CDPSession from the target. Once detached, the CDPSession object won't emit any events and can't be used to send messages.
 
-#### cdpSession.send(method[, params])
+## cdpSession.send(method[, params])
 - `method` <[string]> protocol method name
 - `params` <[Object]> Optional method parameters
 - returns: <[Promise]<[Object]>>
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/class-chromiumbrowser.md b/docs/out/api/class-chromiumbrowser.md
similarity index 97%
rename from docs/class-chromiumbrowser.md
rename to docs/out/api/class-chromiumbrowser.md
index 3017f77a8c..0cfb4d4313 100644
--- a/docs/class-chromiumbrowser.md
+++ b/docs/out/api/class-chromiumbrowser.md
@@ -1,6 +1,6 @@
 ---
 id: class-chromiumbrowser
-title: "class: ChromiumBrowser"
+title: "ChromiumBrowser"
 ---
 
 * extends: [Browser]
@@ -25,12 +25,12 @@ await browser.stopTracing();
 - [browser.newPage([options])](api/class-browser.md#browsernewpageoptions)
 - [browser.version()](api/class-browser.md#browserversion)
 
-#### chromiumBrowser.newBrowserCDPSession()
+## chromiumBrowser.newBrowserCDPSession()
 - returns: <[Promise]<[CDPSession]>>
 
 Returns the newly created browser session.
 
-#### chromiumBrowser.startTracing([page, options])
+## chromiumBrowser.startTracing([page, options])
 - `page` <[Page]> Optional, if specified, tracing includes screenshots of the given page.
 - `options` <[Object]>
   - `categories` <[Array]<[string]>> specify custom categories to use instead of default.
@@ -40,10 +40,11 @@ Returns the newly created browser session.
 
 Only one trace can be active at a time per browser.
 
-#### chromiumBrowser.stopTracing()
+## chromiumBrowser.stopTracing()
 - returns: <[Promise]<[Buffer]>>
 
 Returns the buffer with trace data.
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/class-chromiumbrowsercontext.md b/docs/out/api/class-chromiumbrowsercontext.md
similarity index 96%
rename from docs/class-chromiumbrowsercontext.md
rename to docs/out/api/class-chromiumbrowsercontext.md
index 7f23bb993e..2084a61268 100644
--- a/docs/class-chromiumbrowsercontext.md
+++ b/docs/out/api/class-chromiumbrowsercontext.md
@@ -1,6 +1,6 @@
 ---
 id: class-chromiumbrowsercontext
-title: "class: ChromiumBrowserContext"
+title: "ChromiumBrowserContext"
 ---
 
 * extends: [BrowserContext]
@@ -42,33 +42,34 @@ const backgroundPage = await context.waitForEvent('backgroundpage');
 - [browserContext.unroute(url[, handler])](api/class-browsercontext.md#browsercontextunrouteurl-handler)
 - [browserContext.waitForEvent(event[, optionsOrPredicate])](api/class-browsercontext.md#browsercontextwaitforeventevent-optionsorpredicate)
 
-#### chromiumBrowserContext.on('backgroundpage')
+## chromiumBrowserContext.on('backgroundpage')
 - type: <[Page]>
 
 Emitted when new background page is created in the context.
 
 > **NOTE** Only works with persistent context.
 
-#### chromiumBrowserContext.on('serviceworker')
+## chromiumBrowserContext.on('serviceworker')
 - type: <[Worker]>
 
 Emitted when new service worker is created in the context.
 
-#### chromiumBrowserContext.backgroundPages()
+## chromiumBrowserContext.backgroundPages()
 - returns: <[Array]<[Page]>>
 
 All existing background pages in the context.
 
-#### chromiumBrowserContext.newCDPSession(page)
+## chromiumBrowserContext.newCDPSession(page)
 - `page` <[Page]> Page to create new session for.
 - returns: <[Promise]<[CDPSession]>>
 
 Returns the newly created session.
 
-#### chromiumBrowserContext.serviceWorkers()
+## chromiumBrowserContext.serviceWorkers()
 - returns: <[Array]<[Worker]>>
 
 All existing service workers in the context.
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/class-chromiumcoverage.md b/docs/out/api/class-chromiumcoverage.md
similarity index 97%
rename from docs/class-chromiumcoverage.md
rename to docs/out/api/class-chromiumcoverage.md
index 1468896427..fb9aaeef25 100644
--- a/docs/class-chromiumcoverage.md
+++ b/docs/out/api/class-chromiumcoverage.md
@@ -1,6 +1,6 @@
 ---
 id: class-chromiumcoverage
-title: "class: ChromiumCoverage"
+title: "ChromiumCoverage"
 ---
 
 
@@ -34,14 +34,14 @@ const v8toIstanbul = require('v8-to-istanbul');
 - [chromiumCoverage.stopCSSCoverage()](api/class-chromiumcoverage.md#chromiumcoveragestopcsscoverage)
 - [chromiumCoverage.stopJSCoverage()](api/class-chromiumcoverage.md#chromiumcoveragestopjscoverage)
 
-#### chromiumCoverage.startCSSCoverage([options])
+## chromiumCoverage.startCSSCoverage([options])
 - `options` <[Object]>
   - `resetOnNavigation` <[boolean]> Whether to reset coverage on every navigation. Defaults to `true`.
 - returns: <[Promise]>
 
 Returns coverage is started
 
-#### chromiumCoverage.startJSCoverage([options])
+## chromiumCoverage.startJSCoverage([options])
 - `options` <[Object]>
   - `reportAnonymousScripts` <[boolean]> Whether anonymous scripts generated by the page should be reported. Defaults to `false`.
   - `resetOnNavigation` <[boolean]> Whether to reset coverage on every navigation. Defaults to `true`.
@@ -51,7 +51,7 @@ Returns coverage is started
 
 > **NOTE** Anonymous scripts are ones that don't have an associated url. These are scripts that are dynamically created on the page using `eval` or `new Function`. If `reportAnonymousScripts` is set to `true`, anonymous scripts will have `__playwright_evaluation_script__` as their URL.
 
-#### chromiumCoverage.stopCSSCoverage()
+## chromiumCoverage.stopCSSCoverage()
 - returns: <[Promise]<[Array]<[Object]>>>
   - `url` <[string]> StyleSheet URL
   - `text` <[string]> StyleSheet content, if available.
@@ -63,7 +63,7 @@ Returns the array of coverage reports for all stylesheets
 
 > **NOTE** CSS Coverage doesn't include dynamically injected style tags without sourceURLs.
 
-#### chromiumCoverage.stopJSCoverage()
+## chromiumCoverage.stopJSCoverage()
 - returns: <[Promise]<[Array]<[Object]>>>
   - `url` <[string]> Script URL
   - `scriptId` <[string]> Script ID
@@ -79,6 +79,7 @@ Returns the array of coverage reports for all stylesheets
 Returns the array of coverage reports for all scripts
 
 > **NOTE** JavaScript Coverage doesn't include anonymous scripts by default. However, scripts with sourceURLs are reported.
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/class-consolemessage.md b/docs/out/api/class-consolemessage.md
similarity index 97%
rename from docs/class-consolemessage.md
rename to docs/out/api/class-consolemessage.md
index 9a876e46af..e84cb98712 100644
--- a/docs/class-consolemessage.md
+++ b/docs/out/api/class-consolemessage.md
@@ -1,6 +1,6 @@
 ---
 id: class-consolemessage
-title: "class: ConsoleMessage"
+title: "ConsoleMessage"
 ---
 
 
@@ -12,22 +12,23 @@ title: "class: ConsoleMessage"
 - [consoleMessage.text()](api/class-consolemessage.md#consolemessagetext)
 - [consoleMessage.type()](api/class-consolemessage.md#consolemessagetype)
 
-#### consoleMessage.args()
+## consoleMessage.args()
 - returns: <[Array]<[JSHandle]>>
 
-#### consoleMessage.location()
+## consoleMessage.location()
 - returns: <[Object]>
   - `url` <[string]> URL of the resource.
   - `lineNumber` <[number]> 0-based line number in the resource.
   - `columnNumber` <[number]> 0-based column number in the resource.
 
-#### consoleMessage.text()
+## consoleMessage.text()
 - returns: <[string]>
 
-#### consoleMessage.type()
+## consoleMessage.type()
 - returns: <[string]>
 
 One of the following values: `'log'`, `'debug'`, `'info'`, `'error'`, `'warning'`, `'dir'`, `'dirxml'`, `'table'`, `'trace'`, `'clear'`, `'startGroup'`, `'startGroupCollapsed'`, `'endGroup'`, `'assert'`, `'profile'`, `'profileEnd'`, `'count'`, `'timeEnd'`.
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/class-dialog.md b/docs/out/api/class-dialog.md
similarity index 97%
rename from docs/class-dialog.md
rename to docs/out/api/class-dialog.md
index 20025d38eb..4e94d7e358 100644
--- a/docs/class-dialog.md
+++ b/docs/out/api/class-dialog.md
@@ -1,6 +1,6 @@
 ---
 id: class-dialog
-title: "class: Dialog"
+title: "Dialog"
 ---
 
 
@@ -30,31 +30,32 @@ const { chromium } = require('playwright');  // Or 'firefox' or 'webkit'.
 - [dialog.message()](api/class-dialog.md#dialogmessage)
 - [dialog.type()](api/class-dialog.md#dialogtype)
 
-#### dialog.accept([promptText])
+## dialog.accept([promptText])
 - `promptText` <[string]> A text to enter in prompt. Does not cause any effects if the dialog's `type` is not prompt. Optional.
 - returns: <[Promise]>
 
 Returns when the dialog has been accepted.
 
-#### dialog.defaultValue()
+## dialog.defaultValue()
 - returns: <[string]>
 
 If dialog is prompt, returns default prompt value. Otherwise, returns empty string.
 
-#### dialog.dismiss()
+## dialog.dismiss()
 - returns: <[Promise]>
 
 Returns when the dialog has been dismissed.
 
-#### dialog.message()
+## dialog.message()
 - returns: <[string]>
 
 A message displayed in the dialog.
 
-#### dialog.type()
+## dialog.type()
 - returns: <[string]>
 
 Returns dialog's type, can be one of `alert`, `beforeunload`, `confirm` or `prompt`.
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/class-download.md b/docs/out/api/class-download.md
similarity index 96%
rename from docs/class-download.md
rename to docs/out/api/class-download.md
index e3d5e5faf0..189c20fce7 100644
--- a/docs/class-download.md
+++ b/docs/out/api/class-download.md
@@ -1,6 +1,6 @@
 ---
 id: class-download
-title: "class: Download"
+title: "Download"
 ---
 
 
@@ -31,41 +31,42 @@ const path = await download.path();
 - [download.suggestedFilename()](api/class-download.md#downloadsuggestedfilename)
 - [download.url()](api/class-download.md#downloadurl)
 
-#### download.createReadStream()
+## download.createReadStream()
 - returns: <[Promise]<[null]|[Readable]>>
 
 Returns readable stream for current download or `null` if download failed.
 
-#### download.delete()
+## download.delete()
 - returns: <[Promise]>
 
 Deletes the downloaded file.
 
-#### download.failure()
+## download.failure()
 - returns: <[Promise]<[null]|[string]>>
 
 Returns download error if any.
 
-#### download.path()
+## download.path()
 - returns: <[Promise]<[null]|[string]>>
 
 Returns path to the downloaded file in case of successful download.
 
-#### download.saveAs(path)
+## download.saveAs(path)
 - `path` <[string]> Path where the download should be saved.
 - returns: <[Promise]>
 
 Saves the download to a user-specified path.
 
-#### download.suggestedFilename()
+## download.suggestedFilename()
 - returns: <[string]>
 
 Returns suggested filename for this download. It is typically computed by the browser from the [`Content-Disposition`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Content-Disposition) response header or the `download` attribute. See the spec on [whatwg](https://html.spec.whatwg.org/#downloading-resources). Different browsers can use different logic for computing it.
 
-#### download.url()
+## download.url()
 - returns: <[string]>
 
 Returns downloaded url.
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/class-elementhandle.md b/docs/out/api/class-elementhandle.md
similarity index 97%
rename from docs/class-elementhandle.md
rename to docs/out/api/class-elementhandle.md
index 2005b2974d..62805f2028 100644
--- a/docs/class-elementhandle.md
+++ b/docs/out/api/class-elementhandle.md
@@ -1,6 +1,6 @@
 ---
 id: class-elementhandle
-title: "class: ElementHandle"
+title: "ElementHandle"
 ---
 
 * extends: [JSHandle]
@@ -62,19 +62,19 @@ ElementHandle instances can be used as an argument in [page.$eval(selector, page
 - [jsHandle.getProperty(propertyName)](api/class-jshandle.md#jshandlegetpropertypropertyname)
 - [jsHandle.jsonValue()](api/class-jshandle.md#jshandlejsonvalue)
 
-#### elementHandle.$(selector)
+## elementHandle.$(selector)
 - `selector` <[string]> A selector to query for. See [working with selectors](./selectors.md#working-with-selectors) for more details.
 - returns: <[Promise]<[null]|[ElementHandle]>>
 
 The method finds an element matching the specified selector in the `ElementHandle`'s subtree. See [Working with selectors](./selectors.md#working-with-selectors) for more details. If no elements match the selector, returns `null`.
 
-#### elementHandle.$$(selector)
+## elementHandle.$$(selector)
 - `selector` <[string]> A selector to query for. See [working with selectors](./selectors.md#working-with-selectors) for more details.
 - returns: <[Promise]<[Array]<[ElementHandle]>>>
 
 The method finds all elements matching the specified selector in the `ElementHandle`s subtree. See [Working with selectors](./selectors.md#working-with-selectors) for more details. If no elements match the selector, returns empty array.
 
-#### elementHandle.$eval(selector, pageFunction[, arg])
+## elementHandle.$eval(selector, pageFunction[, arg])
 - `selector` <[string]> A selector to query for. See [working with selectors](./selectors.md#working-with-selectors) for more details.
 - `pageFunction` <[function]\([Element]\)> Function to be evaluated in browser context
 - `arg` <[EvaluationArgument]> Optional argument to pass to `pageFunction`
@@ -94,7 +94,7 @@ expect(await tweetHandle.$eval('.like', node => node.innerText)).toBe('100');
 expect(await tweetHandle.$eval('.retweets', node => node.innerText)).toBe('10');
 ```
 
-#### elementHandle.$$eval(selector, pageFunction[, arg])
+## elementHandle.$$eval(selector, pageFunction[, arg])
 - `selector` <[string]> A selector to query for. See [working with selectors](./selectors.md#working-with-selectors) for more details.
 - `pageFunction` <[function]\([Array]<[Element]>\)> Function to be evaluated in browser context
 - `arg` <[EvaluationArgument]> Optional argument to pass to `pageFunction`
@@ -120,7 +120,7 @@ const feedHandle = await page.$('.feed');
 expect(await feedHandle.$$eval('.tweet', nodes => nodes.map(n => n.innerText))).toEqual(['Hello!', 'Hi!']);
 ```
 
-#### elementHandle.boundingBox()
+## elementHandle.boundingBox()
 - returns: <[Promise]<[null]|[Object]>>
   - `x` <[number]> the x coordinate of the element in pixels.
   - `y` <[number]> the y coordinate of the element in pixels.
@@ -140,7 +140,7 @@ const box = await elementHandle.boundingBox();
 await page.mouse.click(box.x + box.width / 2, box.y + box.height / 2);
 ```
 
-#### elementHandle.check([options])
+## elementHandle.check([options])
 - `options` <[Object]>
   - `force` <[boolean]> Whether to bypass the [actionability](./actionability.md) checks. Defaults to `false`.
   - `noWaitAfter` <[boolean]> Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to inaccessible pages. Defaults to `false`.
@@ -159,7 +159,7 @@ If the element is detached from the DOM at any moment during the action, this me
 
 When all steps combined have not finished during the specified `timeout`, this method rejects with a [TimeoutError]. Passing zero timeout disables this.
 
-#### elementHandle.click([options])
+## elementHandle.click([options])
 - `options` <[Object]>
   - `button` <"left"|"right"|"middle"> Defaults to `left`.
   - `clickCount` <[number]> defaults to 1. See [UIEvent.detail].
@@ -183,12 +183,12 @@ If the element is detached from the DOM at any moment during the action, this me
 
 When all steps combined have not finished during the specified `timeout`, this method rejects with a [TimeoutError]. Passing zero timeout disables this.
 
-#### elementHandle.contentFrame()
+## elementHandle.contentFrame()
 - returns: <[Promise]<[null]|[Frame]>>
 
 Returns the content frame for element handles referencing iframe nodes, or `null` otherwise
 
-#### elementHandle.dblclick([options])
+## elementHandle.dblclick([options])
 - `options` <[Object]>
   - `button` <"left"|"right"|"middle"> Defaults to `left`.
   - `delay` <[number]> Time to wait between `mousedown` and `mouseup` in milliseconds. Defaults to 0.
@@ -213,7 +213,7 @@ When all steps combined have not finished during the specified `timeout`, this m
 
 > **NOTE** `elementHandle.dblclick()` dispatches two `click` events and a single `dblclick` event.
 
-#### elementHandle.dispatchEvent(type[, eventInit])
+## elementHandle.dispatchEvent(type[, eventInit])
 - `type` <[string]> DOM event type: `"click"`, `"dragstart"`, etc.
 - `eventInit` <[EvaluationArgument]> Optional event-specific initialization properties.
 - returns: <[Promise]>
@@ -243,7 +243,7 @@ const dataTransfer = await page.evaluateHandle(() => new DataTransfer());
 await elementHandle.dispatchEvent('dragstart', { dataTransfer });
 ```
 
-#### elementHandle.fill(value[, options])
+## elementHandle.fill(value[, options])
 - `value` <[string]> Value to set for the `<input>`, `<textarea>` or `[contenteditable]` element.
 - `options` <[Object]>
   - `noWaitAfter` <[boolean]> Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to inaccessible pages. Defaults to `false`.
@@ -252,18 +252,18 @@ await elementHandle.dispatchEvent('dragstart', { dataTransfer });
 
 This method waits for [actionability](./actionability.md) checks, focuses the element, fills it and triggers an `input` event after filling. If the element is not an `<input>`, `<textarea>` or `[contenteditable]` element, this method throws an error. Note that you can pass an empty string to clear the input field.
 
-#### elementHandle.focus()
+## elementHandle.focus()
 - returns: <[Promise]>
 
 Calls [focus](https://developer.mozilla.org/en-US/docs/Web/API/HTMLElement/focus) on the element.
 
-#### elementHandle.getAttribute(name)
+## elementHandle.getAttribute(name)
 - `name` <[string]> Attribute name to get the value for.
 - returns: <[Promise]<[null]|[string]>>
 
 Returns element attribute value.
 
-#### elementHandle.hover([options])
+## elementHandle.hover([options])
 - `options` <[Object]>
   - `force` <[boolean]> Whether to bypass the [actionability](./actionability.md) checks. Defaults to `false`.
   - `modifiers` <[Array]<"Alt"|"Control"|"Meta"|"Shift">> Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current modifiers back. If not specified, currently pressed modifiers are used.
@@ -283,22 +283,22 @@ If the element is detached from the DOM at any moment during the action, this me
 
 When all steps combined have not finished during the specified `timeout`, this method rejects with a [TimeoutError]. Passing zero timeout disables this.
 
-#### elementHandle.innerHTML()
+## elementHandle.innerHTML()
 - returns: <[Promise]<[string]>>
 
 Returns the `element.innerHTML`.
 
-#### elementHandle.innerText()
+## elementHandle.innerText()
 - returns: <[Promise]<[string]>>
 
 Returns the `element.innerText`.
 
-#### elementHandle.ownerFrame()
+## elementHandle.ownerFrame()
 - returns: <[Promise]<[null]|[Frame]>>
 
 Returns the frame containing the given element.
 
-#### elementHandle.press(key[, options])
+## elementHandle.press(key[, options])
 - `key` <[string]> Name of the key to press or a character to generate, such as `ArrowLeft` or `a`.
 - `options` <[Object]>
   - `delay` <[number]> Time to wait between `keydown` and `keyup` in milliseconds. Defaults to 0.
@@ -320,7 +320,7 @@ If `key` is a single character, it is case-sensitive, so the values `a` and `A`
 
 Shortcuts such as `key: "Control+o"` or `key: "Control+Shift+T"` are supported as well. When speficied with the modifier, modifier is pressed and being held while the subsequent key is being pressed.
 
-#### elementHandle.screenshot([options])
+## elementHandle.screenshot([options])
 - `options` <[Object]>
   - `omitBackground` <[boolean]> Hides default white background and allows capturing screenshots with transparency. Not applicable to `jpeg` images. Defaults to `false`.
   - `path` <[string]> The file path to save the image to. The screenshot type will be inferred from file extension. If `path` is a relative path, then it is resolved relative to the current working directory. If no path is provided, the image won't be saved to the disk.
@@ -333,7 +333,7 @@ Returns the buffer with the captured screenshot.
 
 This method waits for the [actionability](./actionability.md) checks, then scrolls element into view before taking a screenshot. If the element is detached from DOM, the method throws an error.
 
-#### elementHandle.scrollIntoViewIfNeeded([options])
+## elementHandle.scrollIntoViewIfNeeded([options])
 - `options` <[Object]>
   - `timeout` <[number]> Maximum time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be changed by using the [browserContext.setDefaultTimeout(timeout)](api/class-browsercontext.md#browsercontextsetdefaulttimeouttimeout) or [page.setDefaultTimeout(timeout)](api/class-page.md#pagesetdefaulttimeouttimeout) methods.
 - returns: <[Promise]>
@@ -342,7 +342,7 @@ This method waits for [actionability](./actionability.md) checks, then tries to
 
 Throws when `elementHandle` does not point to an element [connected](https://developer.mozilla.org/en-US/docs/Web/API/Node/isConnected) to a Document or a ShadowRoot.
 
-#### elementHandle.selectOption(values[, options])
+## elementHandle.selectOption(values[, options])
 - `values` <[null]|[string]|[ElementHandle]|[Array]<[string]>|[Object]|[Array]<[ElementHandle]>|[Array]<[Object]>> Options to select. If the `<select>` has the `multiple` attribute, all matching options are selected, otherwise only the first option matching one of the passed options is selected. String values are equivalent to `{value:'string'}`. Option is considered matching if all specified properties match.
   - `value` <[string]> Matches by `option.value`. Optional.
   - `label` <[string]> Matches by `option.label`. Optional.
@@ -370,14 +370,14 @@ handle.selectOption('red', 'green', 'blue');
 handle.selectOption({ value: 'blue' }, { index: 2 }, 'red');
 ```
 
-#### elementHandle.selectText([options])
+## elementHandle.selectText([options])
 - `options` <[Object]>
   - `timeout` <[number]> Maximum time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be changed by using the [browserContext.setDefaultTimeout(timeout)](api/class-browsercontext.md#browsercontextsetdefaulttimeouttimeout) or [page.setDefaultTimeout(timeout)](api/class-page.md#pagesetdefaulttimeouttimeout) methods.
 - returns: <[Promise]>
 
 This method waits for [actionability](./actionability.md) checks, then focuses the element and selects all its text content.
 
-#### elementHandle.setInputFiles(files[, options])
+## elementHandle.setInputFiles(files[, options])
 - `files` <[string]|[Array]<[string]>|[Object]|[Array]<[Object]>>
   - `name` <[string]> [File] name **required**
   - `mimeType` <[string]> [File] type **required**
@@ -391,7 +391,7 @@ This method expects `elementHandle` to point to an [input element](https://devel
 
 Sets the value of the file input to these file paths or files. If some of the `filePaths` are relative paths, then they are resolved relative to the the current working directory. For empty array, clears the selected files.
 
-#### elementHandle.tap([options])
+## elementHandle.tap([options])
 - `options` <[Object]>
   - `force` <[boolean]> Whether to bypass the [actionability](./actionability.md) checks. Defaults to `false`.
   - `modifiers` <[Array]<"Alt"|"Control"|"Meta"|"Shift">> Modifier keys to press. Ensures that only these modifiers are pressed during the operation, and then restores current modifiers back. If not specified, currently pressed modifiers are used.
@@ -414,12 +414,12 @@ When all steps combined have not finished during the specified `timeout`, this m
 
 > **NOTE** `elementHandle.tap()` requires that the `hasTouch` option of the browser context be set to true.
 
-#### elementHandle.textContent()
+## elementHandle.textContent()
 - returns: <[Promise]<[null]|[string]>>
 
 Returns the `node.textContent`.
 
-#### elementHandle.type(text[, options])
+## elementHandle.type(text[, options])
 - `text` <[string]> A text to type into a focused element.
 - `options` <[Object]>
   - `delay` <[number]> Time to wait between key presses in milliseconds. Defaults to 0.
@@ -444,7 +444,7 @@ await elementHandle.type('some text');
 await elementHandle.press('Enter');
 ```
 
-#### elementHandle.uncheck([options])
+## elementHandle.uncheck([options])
 - `options` <[Object]>
   - `force` <[boolean]> Whether to bypass the [actionability](./actionability.md) checks. Defaults to `false`.
   - `noWaitAfter` <[boolean]> Actions that initiate navigations are waiting for these navigations to happen and for pages to start loading. You can opt out of waiting via setting this flag. You would only need this option in the exceptional cases such as navigating to inaccessible pages. Defaults to `false`.
@@ -463,7 +463,7 @@ If the element is detached from the DOM at any moment during the action, this me
 
 When all steps combined have not finished during the specified `timeout`, this method rejects with a [TimeoutError]. Passing zero timeout disables this.
 
-#### elementHandle.waitForElementState(state[, options])
+## elementHandle.waitForElementState(state[, options])
 - `state` <"visible"|"hidden"|"stable"|"enabled"|"disabled"> A state to wait for, see below for more details.
 - `options` <[Object]>
   - `timeout` <[number]> Maximum time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be changed by using the [browserContext.setDefaultTimeout(timeout)](api/class-browsercontext.md#browsercontextsetdefaulttimeouttimeout) or [page.setDefaultTimeout(timeout)](api/class-page.md#pagesetdefaulttimeouttimeout) methods.
@@ -480,7 +480,7 @@ Depending on the `state` parameter, this method waits for one of the [actionabil
 
 If the element does not satisfy the condition for the `timeout` milliseconds, this method will throw.
 
-#### elementHandle.waitForSelector(selector[, options])
+## elementHandle.waitForSelector(selector[, options])
 - `selector` <[string]> A selector to query for. See [working with selectors](./selectors.md#working-with-selectors) for more details.
 - `options` <[Object]>
   - `state` <"attached"|"detached"|"visible"|"hidden"> Defaults to `'visible'`. Can be either:
@@ -503,6 +503,7 @@ const span = await div.waitForSelector('span', { state: 'attached' });
 ```
 
 > **NOTE** This method does not work across navigations, use [page.waitForSelector(selector[, options])](api/class-page.md#pagewaitforselectorselector-options) instead.
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/class-filechooser.md b/docs/out/api/class-filechooser.md
similarity index 97%
rename from docs/class-filechooser.md
rename to docs/out/api/class-filechooser.md
index 7c9a8039a3..573b48b9d5 100644
--- a/docs/class-filechooser.md
+++ b/docs/out/api/class-filechooser.md
@@ -1,6 +1,6 @@
 ---
 id: class-filechooser
-title: "class: FileChooser"
+title: "FileChooser"
 ---
 
 
@@ -18,22 +18,22 @@ page.on('filechooser', async (fileChooser) => {
 - [fileChooser.page()](api/class-filechooser.md#filechooserpage)
 - [fileChooser.setFiles(files[, options])](api/class-filechooser.md#filechoosersetfilesfiles-options)
 
-#### fileChooser.element()
+## fileChooser.element()
 - returns: <[ElementHandle]>
 
 Returns input element associated with this file chooser.
 
-#### fileChooser.isMultiple()
+## fileChooser.isMultiple()
 - returns: <[boolean]>
 
 Returns whether this file chooser accepts multiple files.
 
-#### fileChooser.page()
+## fileChooser.page()
 - returns: <[Page]>
 
 Returns page this file chooser belongs to.
 
-#### fileChooser.setFiles(files[, options])
+## fileChooser.setFiles(files[, options])
 - `files` <[string]|[Array]<[string]>|[Object]|[Array]<[Object]>>
   - `name` <[string]> [File] name **required**
   - `mimeType` <[string]> [File] type **required**
@@ -44,6 +44,7 @@ Returns page this file chooser belongs to.
 - returns: <[Promise]>
 
 Sets the value of the file input this chooser is associated with. If some of the `filePaths` are relative paths, then they are resolved relative to the the current working directory. For empty array, clears the selected files.
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/class-firefoxbrowser.md b/docs/out/api/class-firefoxbrowser.md
similarity index 99%
rename from docs/class-firefoxbrowser.md
rename to docs/out/api/class-firefoxbrowser.md
index a67707777c..d97334d874 100644
--- a/docs/class-firefoxbrowser.md
+++ b/docs/out/api/class-firefoxbrowser.md
@@ -1,6 +1,6 @@
 ---
 id: class-firefoxbrowser
-title: "class: FirefoxBrowser"
+title: "FirefoxBrowser"
 ---
 
 * extends: [Browser]
@@ -15,6 +15,7 @@ Firefox browser instance does not expose Firefox-specific features.
 - [browser.newContext([options])](api/class-browser.md#browsernewcontextoptions)
 - [browser.newPage([options])](api/class-browser.md#browsernewpageoptions)
 - [browser.version()](api/class-browser.md#browserversion)
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/class-frame.md b/docs/out/api/class-frame.md
similarity index 97%
rename from docs/class-frame.md
rename to docs/out/api/class-frame.md
index 5ba9bf0d2b..56c3de1e79 100644
--- a/docs/class-frame.md
+++ b/docs/out/api/class-frame.md
@@ -1,6 +1,6 @@
 ---
 id: class-frame
-title: "class: Frame"
+title: "Frame"
 ---
 
 
@@ -83,7 +83,7 @@ console.log(text);
 - [frame.waitForSelector(selector[, options])](api/class-frame.md#framewaitforselectorselector-options)
 - [frame.waitForTimeout(timeout)](api/class-frame.md#framewaitfortimeouttimeout)
 
-#### frame.$(selector)
+## frame.$(selector)
 - `selector` <[string]> A selector to query for. See [working with selectors](./selectors.md#working-with-selectors) for more details.
 - returns: <[Promise]<[null]|[ElementHandle]>>
 
@@ -91,7 +91,7 @@ Returns the ElementHandle pointing to the frame element.
 
 The method finds an element matching the specified selector within the frame. See [Working with selectors](./selectors.md#working-with-selectors) for more details. If no elements match the selector, returns `null`.
 
-#### frame.$$(selector)
+## frame.$$(selector)
 - `selector` <[string]> A selector to query for. See [working with selectors](./selectors.md#working-with-selectors) for more details.
 - returns: <[Promise]<[Array]<[ElementHandle]>>>
 
@@ -99,7 +99,7 @@ Returns the ElementHandles pointing to the frame elements.
 
 The method finds all elements matching the specified selector within the frame. See [Working with selectors](./selectors.md#working-with-selectors) for more details. If no elements match the selector, returns empty array.
 
-#### frame.$eval(selector, pageFunction[, arg])
+## frame.$eval(selector, pageFunction[, arg])
 - `selector` <[string]> A selector to query for. See [working with selectors](./selectors.md#working-with-selectors) for more details.
 - `pageFunction` <[function]\([Element]\)> Function to be evaluated in browser context
 - `arg` <[EvaluationArgument]> Optional argument to pass to `pageFunction`
@@ -119,7 +119,7 @@ const preloadHref = await frame.$eval('link[rel=preload]', el => el.href);
 const html = await frame.$eval('.main-container', (e, suffix) => e.outerHTML + suffix, 'hello');
 ```
 
-#### frame.$$eval(selector, pageFunction[, arg])
+## frame.$$eval(selector, pageFunction[, arg])
 - `selector` <[string]> A selector to query for. See [working with selectors](./selectors.md#working-with-selectors) for more details.
 - `pageFunction` <[function]\([Array]<[Element]>\)> Function to be evaluated in browser context
 - `arg` <[EvaluationArgument]> Optional argument to pass to `pageFunction`
@@ -137,7 +137,7 @@ Examples:
 const divsCounts = await frame.$$eval('div', (divs, min) => divs.length >= min, 10);
 ```
 
-#### frame.addScriptTag(params)
+## frame.addScriptTag(params)
 - `params` <[Object]>
   - `url` <[string]> URL of a script to be added. Optional.
   - `path` <[string]> Path to the JavaScript file to be injected into frame. If `path` is a relative path, then it is resolved relative to the current working directory. Optional.
@@ -149,7 +149,7 @@ Returns the added tag when the script's onload fires or when the script content
 
 Adds a `<script>` tag into the page with the desired url or content.
 
-#### frame.addStyleTag(params)
+## frame.addStyleTag(params)
 - `params` <[Object]>
   - `url` <[string]> URL of the `<link>` tag. Optional.
   - `path` <[string]> Path to the CSS file to be injected into frame. If `path` is a relative path, then it is resolved relative to the current working directory. Optional.
@@ -160,7 +160,7 @@ Returns the added tag when the stylesheet's onload fires or when the CSS content
 
 Adds a `<link rel="stylesheet">` tag into the page with the desired url or a `<style type="text/css">` tag with the content.
 
-#### frame.check(selector[, options])
+## frame.check(selector[, options])
 - `selector` <[string]> A selector to search for element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](./selectors.md#working-with-selectors) for more details.
 - `options` <[Object]>
   - `force` <[boolean]> Whether to bypass the [actionability](./actionability.md) checks. Defaults to `false`.
@@ -179,10 +179,10 @@ This method checks an element matching `selector` by performing the following st
 
 When all steps combined have not finished during the specified `timeout`, this method rejects with a [TimeoutError]. Passing zero timeout disables this.
 
-#### frame.childFrames()
+## frame.childFrames()
 - returns: <[Array]<[Frame]>>
 
-#### frame.click(selector[, options])
+## frame.click(selector[, options])
 - `selector` <[string]> A selector to search for element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](./selectors.md#working-with-selectors) for more details.
 - `options` <[Object]>
   - `button` <"left"|"right"|"middle"> Defaults to `left`.
@@ -206,12 +206,12 @@ This method clicks an element matching `selector` by performing the following st
 
 When all steps combined have not finished during the specified `timeout`, this method rejects with a [TimeoutError]. Passing zero timeout disables this.
 
-#### frame.content()
+## frame.content()
 - returns: <[Promise]<[string]>>
 
 Gets the full HTML contents of the frame, including the doctype.
 
-#### frame.dblclick(selector[, options])
+## frame.dblclick(selector[, options])
 - `selector` <[string]> A selector to search for element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](./selectors.md#working-with-selectors) for more details.
 - `options` <[Object]>
   - `button` <"left"|"right"|"middle"> Defaults to `left`.
@@ -236,7 +236,7 @@ When all steps combined have not finished during the specified `timeout`, this m
 
 > **NOTE** `frame.dblclick()` dispatches two `click` events and a single `dblclick` event.
 
-#### frame.dispatchEvent(selector, type[, eventInit, options])
+## frame.dispatchEvent(selector, type[, eventInit, options])
 - `selector` <[string]> A selector to search for element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](./selectors.md#working-with-selectors) for more details.
 - `type` <[string]> DOM event type: `"click"`, `"dragstart"`, etc.
 - `eventInit` <[EvaluationArgument]> Optional event-specific initialization properties.
@@ -269,7 +269,7 @@ const dataTransfer = await frame.evaluateHandle(() => new DataTransfer());
 await frame.dispatchEvent('#source', 'dragstart', { dataTransfer });
 ```
 
-#### frame.evaluate(pageFunction[, arg])
+## frame.evaluate(pageFunction[, arg])
 - `pageFunction` <[function]|[string]> Function to be evaluated in browser context
 - `arg` <[EvaluationArgument]> Optional argument to pass to `pageFunction`
 - returns: <[Promise]<[Serializable]>>
@@ -301,7 +301,7 @@ const html = await frame.evaluate(([body, suffix]) => body.innerHTML + suffix, [
 await bodyHandle.dispose();
 ```
 
-#### frame.evaluateHandle(pageFunction[, arg])
+## frame.evaluateHandle(pageFunction[, arg])
 - `pageFunction` <[function]|[string]> Function to be evaluated in the page context
 - `arg` <[EvaluationArgument]> Optional argument to pass to `pageFunction`
 - returns: <[Promise]<[JSHandle]>>
@@ -332,7 +332,7 @@ console.log(await resultHandle.jsonValue());
 await resultHandle.dispose();
 ```
 
-#### frame.fill(selector, value[, options])
+## frame.fill(selector, value[, options])
 - `selector` <[string]> A selector to search for element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](./selectors.md#working-with-selectors) for more details.
 - `value` <[string]> Value to fill for the `<input>`, `<textarea>` or `[contenteditable]` element.
 - `options` <[Object]>
@@ -344,7 +344,7 @@ This method waits for an element matching `selector`, waits for [actionability](
 
 To send fine-grained keyboard events, use [frame.type(selector, text[, options])](api/class-frame.md#frametypeselector-text-options).
 
-#### frame.focus(selector[, options])
+## frame.focus(selector[, options])
 - `selector` <[string]> A selector to search for element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](./selectors.md#working-with-selectors) for more details.
 - `options` <[Object]>
   - `timeout` <[number]> Maximum time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be changed by using the [browserContext.setDefaultTimeout(timeout)](api/class-browsercontext.md#browsercontextsetdefaulttimeouttimeout) or [page.setDefaultTimeout(timeout)](api/class-page.md#pagesetdefaulttimeouttimeout) methods.
@@ -352,7 +352,7 @@ To send fine-grained keyboard events, use [frame.type(selector, text[, options])
 
 This method fetches an element with `selector` and focuses it. If there's no element matching `selector`, the method waits until a matching element appears in the DOM.
 
-#### frame.frameElement()
+## frame.frameElement()
 - returns: <[Promise]<[ElementHandle]>>
 
 Returns the `frame` or `iframe` element handle which corresponds to this frame.
@@ -367,7 +367,7 @@ const contentFrame = await frameElement.contentFrame();
 console.log(frame === contentFrame);  // -> true
 ```
 
-#### frame.getAttribute(selector, name[, options])
+## frame.getAttribute(selector, name[, options])
 - `selector` <[string]> A selector to search for element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](./selectors.md#working-with-selectors) for more details.
 - `name` <[string]> Attribute name to get the value for.
 - `options` <[Object]>
@@ -376,7 +376,7 @@ console.log(frame === contentFrame);  // -> true
 
 Returns element attribute value.
 
-#### frame.goto(url[, options])
+## frame.goto(url[, options])
 - `url` <[string]> URL to navigate frame to. The url should include scheme, e.g. `https://`.
 - `options` <[Object]>
   - `referer` <[string]> Referer header value. If provided it will take preference over the referer header value set by [page.setExtraHTTPHeaders(headers)](api/class-page.md#pagesetextrahttpheadersheaders).
@@ -401,7 +401,7 @@ Returns the main resource response. In case of multiple redirects, the navigatio
 > **NOTE** `frame.goto` either throws an error or returns a main resource response. The only exceptions are navigation to `about:blank` or navigation to the same URL with a different hash, which would succeed and return `null`.
 > **NOTE** Headless mode doesn't support navigation to a PDF document. See the [upstream issue](https://bugs.chromium.org/p/chromium/issues/detail?id=761295).
 
-#### frame.hover(selector[, options])
+## frame.hover(selector[, options])
 - `selector` <[string]> A selector to search for element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](./selectors.md#working-with-selectors) for more details.
 - `options` <[Object]>
   - `force` <[boolean]> Whether to bypass the [actionability](./actionability.md) checks. Defaults to `false`.
@@ -421,7 +421,7 @@ This method hovers over an element matching `selector` by performing the followi
 
 When all steps combined have not finished during the specified `timeout`, this method rejects with a [TimeoutError]. Passing zero timeout disables this.
 
-#### frame.innerHTML(selector[, options])
+## frame.innerHTML(selector[, options])
 - `selector` <[string]> A selector to search for element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](./selectors.md#working-with-selectors) for more details.
 - `options` <[Object]>
   - `timeout` <[number]> Maximum time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be changed by using the [browserContext.setDefaultTimeout(timeout)](api/class-browsercontext.md#browsercontextsetdefaulttimeouttimeout) or [page.setDefaultTimeout(timeout)](api/class-page.md#pagesetdefaulttimeouttimeout) methods.
@@ -429,7 +429,7 @@ When all steps combined have not finished during the specified `timeout`, this m
 
 Returns `element.innerHTML`.
 
-#### frame.innerText(selector[, options])
+## frame.innerText(selector[, options])
 - `selector` <[string]> A selector to search for element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](./selectors.md#working-with-selectors) for more details.
 - `options` <[Object]>
   - `timeout` <[number]> Maximum time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be changed by using the [browserContext.setDefaultTimeout(timeout)](api/class-browsercontext.md#browsercontextsetdefaulttimeouttimeout) or [page.setDefaultTimeout(timeout)](api/class-page.md#pagesetdefaulttimeouttimeout) methods.
@@ -437,12 +437,12 @@ Returns `element.innerHTML`.
 
 Returns `element.innerText`.
 
-#### frame.isDetached()
+## frame.isDetached()
 - returns: <[boolean]>
 
 Returns `true` if the frame has been detached, or `false` otherwise.
 
-#### frame.name()
+## frame.name()
 - returns: <[string]>
 
 Returns frame's name attribute as specified in the tag.
@@ -451,17 +451,17 @@ If the name is empty, returns the id attribute instead.
 
 > **NOTE** This value is calculated once when the frame is created, and will not update if the attribute is changed later.
 
-#### frame.page()
+## frame.page()
 - returns: <[Page]>
 
 Returns the page containing this frame.
 
-#### frame.parentFrame()
+## frame.parentFrame()
 - returns: <[null]|[Frame]>
 
 Parent frame, if any. Detached frames and main frames return `null`.
 
-#### frame.press(selector, key[, options])
+## frame.press(selector, key[, options])
 - `selector` <[string]> A selector to search for element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](./selectors.md#working-with-selectors) for more details.
 - `key` <[string]> Name of the key to press or a character to generate, such as `ArrowLeft` or `a`.
 - `options` <[Object]>
@@ -482,7 +482,7 @@ If `key` is a single character, it is case-sensitive, so the values `a` and `A`
 
 Shortcuts such as `key: "Control+o"` or `key: "Control+Shift+T"` are supported as well. When speficied with the modifier, modifier is pressed and being held while the subsequent key is being pressed.
 
-#### frame.selectOption(selector, values[, options])
+## frame.selectOption(selector, values[, options])
 - `selector` <[string]> A selector to query for. See [working with selectors](./selectors.md#working-with-selectors) for more details.
 - `values` <[null]|[string]|[ElementHandle]|[Array]<[string]>|[Object]|[Array]<[ElementHandle]>|[Array]<[Object]>> Options to select. If the `<select>` has the `multiple` attribute, all matching options are selected, otherwise only the first option matching one of the passed options is selected. String values are equivalent to `{value:'string'}`. Option is considered matching if all specified properties match.
   - `value` <[string]> Matches by `option.value`. Optional.
@@ -508,7 +508,7 @@ frame.selectOption('select#colors', { label: 'Blue' });
 frame.selectOption('select#colors', 'red', 'green', 'blue');
 ```
 
-#### frame.setContent(html[, options])
+## frame.setContent(html[, options])
 - `html` <[string]> HTML markup to assign to the page.
 - `options` <[Object]>
   - `timeout` <[number]> Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be changed by using the [browserContext.setDefaultNavigationTimeout(timeout)](api/class-browsercontext.md#browsercontextsetdefaultnavigationtimeouttimeout), [browserContext.setDefaultTimeout(timeout)](api/class-browsercontext.md#browsercontextsetdefaulttimeouttimeout), [page.setDefaultNavigationTimeout(timeout)](api/class-page.md#pagesetdefaultnavigationtimeouttimeout) or [page.setDefaultTimeout(timeout)](api/class-page.md#pagesetdefaulttimeouttimeout) methods.
@@ -518,7 +518,7 @@ frame.selectOption('select#colors', 'red', 'green', 'blue');
     * `'networkidle'` - consider operation to be finished when there are no network connections for at least `500` ms.
 - returns: <[Promise]>
 
-#### frame.setInputFiles(selector, files[, options])
+## frame.setInputFiles(selector, files[, options])
 - `selector` <[string]> A selector to search for element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](./selectors.md#working-with-selectors) for more details.
 - `files` <[string]|[Array]<[string]>|[Object]|[Array]<[Object]>>
   - `name` <[string]> [File] name **required**
@@ -533,7 +533,7 @@ This method expects `selector` to point to an [input element](https://developer.
 
 Sets the value of the file input to these file paths or files. If some of the `filePaths` are relative paths, then they are resolved relative to the the current working directory. For empty array, clears the selected files.
 
-#### frame.tap(selector[, options])
+## frame.tap(selector[, options])
 - `selector` <[string]> A selector to search for element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](./selectors.md#working-with-selectors) for more details.
 - `options` <[Object]>
   - `force` <[boolean]> Whether to bypass the [actionability](./actionability.md) checks. Defaults to `false`.
@@ -556,7 +556,7 @@ When all steps combined have not finished during the specified `timeout`, this m
 
 > **NOTE** `frame.tap()` requires that the `hasTouch` option of the browser context be set to true.
 
-#### frame.textContent(selector[, options])
+## frame.textContent(selector[, options])
 - `selector` <[string]> A selector to search for element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](./selectors.md#working-with-selectors) for more details.
 - `options` <[Object]>
   - `timeout` <[number]> Maximum time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be changed by using the [browserContext.setDefaultTimeout(timeout)](api/class-browsercontext.md#browsercontextsetdefaulttimeouttimeout) or [page.setDefaultTimeout(timeout)](api/class-page.md#pagesetdefaulttimeouttimeout) methods.
@@ -564,12 +564,12 @@ When all steps combined have not finished during the specified `timeout`, this m
 
 Returns `element.textContent`.
 
-#### frame.title()
+## frame.title()
 - returns: <[Promise]<[string]>>
 
 Returns the page title.
 
-#### frame.type(selector, text[, options])
+## frame.type(selector, text[, options])
 - `selector` <[string]> A selector to search for element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](./selectors.md#working-with-selectors) for more details.
 - `text` <[string]> A text to type into a focused element.
 - `options` <[Object]>
@@ -587,7 +587,7 @@ await frame.type('#mytextarea', 'Hello'); // Types instantly
 await frame.type('#mytextarea', 'World', {delay: 100}); // Types slower, like a user
 ```
 
-#### frame.uncheck(selector[, options])
+## frame.uncheck(selector[, options])
 - `selector` <[string]> A selector to search for element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](./selectors.md#working-with-selectors) for more details.
 - `options` <[Object]>
   - `force` <[boolean]> Whether to bypass the [actionability](./actionability.md) checks. Defaults to `false`.
@@ -606,12 +606,12 @@ This method checks an element matching `selector` by performing the following st
 
 When all steps combined have not finished during the specified `timeout`, this method rejects with a [TimeoutError]. Passing zero timeout disables this.
 
-#### frame.url()
+## frame.url()
 - returns: <[string]>
 
 Returns frame's url.
 
-#### frame.waitForFunction(pageFunction[, arg, options])
+## frame.waitForFunction(pageFunction[, arg, options])
 - `pageFunction` <[function]|[string]> Function to be evaluated in browser context
 - `arg` <[EvaluationArgument]> Optional argument to pass to `pageFunction`
 - `options` <[Object]>
@@ -643,7 +643,7 @@ const selector = '.foo';
 await frame.waitForFunction(selector => !!document.querySelector(selector), selector);
 ```
 
-#### frame.waitForLoadState([state, options])
+## frame.waitForLoadState([state, options])
 - `state` <"load"|"domcontentloaded"|"networkidle"> Optional load state to wait for, defaults to `load`. If the state has been already reached while loading current document, the method returns immediately. Can be one of:
   * `'load'` - wait for the `load` event to be fired.
   * `'domcontentloaded'` - wait for the `DOMContentLoaded` event to be fired.
@@ -661,7 +661,7 @@ await frame.click('button'); // Click triggers navigation.
 await frame.waitForLoadState(); // Waits for 'load' state by default.
 ```
 
-#### frame.waitForNavigation([options])
+## frame.waitForNavigation([options])
 - `options` <[Object]>
   - `timeout` <[number]> Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be changed by using the [browserContext.setDefaultNavigationTimeout(timeout)](api/class-browsercontext.md#browsercontextsetdefaultnavigationtimeouttimeout), [browserContext.setDefaultTimeout(timeout)](api/class-browsercontext.md#browsercontextsetdefaulttimeouttimeout), [page.setDefaultNavigationTimeout(timeout)](api/class-page.md#pagesetdefaultnavigationtimeouttimeout) or [page.setDefaultTimeout(timeout)](api/class-page.md#pagesetdefaulttimeouttimeout) methods.
   - `url` <[string]|[RegExp]|[Function]> URL string, URL regex pattern or predicate receiving [URL] to match while waiting for the navigation.
@@ -684,7 +684,7 @@ const [response] = await Promise.all([
 
 **NOTE** Usage of the [History API](https://developer.mozilla.org/en-US/docs/Web/API/History_API) to change the URL is considered a navigation.
 
-#### frame.waitForSelector(selector[, options])
+## frame.waitForSelector(selector[, options])
 - `selector` <[string]> A selector to query for. See [working with selectors](./selectors.md#working-with-selectors) for more details.
 - `options` <[Object]>
   - `state` <"attached"|"detached"|"visible"|"hidden"> Defaults to `'visible'`. Can be either:
@@ -718,13 +718,14 @@ const { webkit } = require('playwright');  // Or 'chromium' or 'firefox'.
 })();
 ```
 
-#### frame.waitForTimeout(timeout)
+## frame.waitForTimeout(timeout)
 - `timeout` <[number]> A timeout to wait for
 - returns: <[Promise]>
 
 Waits for the given `timeout` in milliseconds.
 
 Note that `frame.waitForTimeout()` should only be used for debugging. Tests using the timer in production are going to be flaky. Use signals such as network events, selectors becoming visible and others instead.
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/class-jshandle.md b/docs/out/api/class-jshandle.md
similarity index 96%
rename from docs/class-jshandle.md
rename to docs/out/api/class-jshandle.md
index f7d6d58ce4..e773c4d934 100644
--- a/docs/class-jshandle.md
+++ b/docs/out/api/class-jshandle.md
@@ -1,6 +1,6 @@
 ---
 id: class-jshandle
-title: "class: JSHandle"
+title: "JSHandle"
 ---
 
 
@@ -24,17 +24,17 @@ JSHandle instances can be used as an argument in [page.$eval(selector, pageFunct
 - [jsHandle.getProperty(propertyName)](api/class-jshandle.md#jshandlegetpropertypropertyname)
 - [jsHandle.jsonValue()](api/class-jshandle.md#jshandlejsonvalue)
 
-#### jsHandle.asElement()
+## jsHandle.asElement()
 - returns: <[null]|[ElementHandle]>
 
 Returns either `null` or the object handle itself, if the object handle is an instance of [ElementHandle].
 
-#### jsHandle.dispose()
+## jsHandle.dispose()
 - returns: <[Promise]>
 
 The `jsHandle.dispose` method stops referencing the element handle.
 
-#### jsHandle.evaluate(pageFunction[, arg])
+## jsHandle.evaluate(pageFunction[, arg])
 - `pageFunction` <[function]> Function to be evaluated in browser context
 - `arg` <[EvaluationArgument]> Optional argument to pass to `pageFunction`
 - returns: <[Promise]<[Serializable]>>
@@ -52,7 +52,7 @@ const tweetHandle = await page.$('.tweet .retweets');
 expect(await tweetHandle.evaluate((node, suffix) => node.innerText, ' retweets')).toBe('10 retweets');
 ```
 
-#### jsHandle.evaluateHandle(pageFunction[, arg])
+## jsHandle.evaluateHandle(pageFunction[, arg])
 - `pageFunction` <[function]|[string]> Function to be evaluated
 - `arg` <[EvaluationArgument]> Optional argument to pass to `pageFunction`
 - returns: <[Promise]<[JSHandle]>>
@@ -67,7 +67,7 @@ If the function passed to the `jsHandle.evaluateHandle` returns a [Promise], the
 
 See [page.evaluateHandle(pageFunction[, arg])](api/class-page.md#pageevaluatehandlepagefunction-arg) for more details.
 
-#### jsHandle.getProperties()
+## jsHandle.getProperties()
 - returns: <[Promise]<[Map]<[string], [JSHandle]>>>
 
 The method returns a map with **own property names** as keys and JSHandle instances for the property values.
@@ -80,18 +80,19 @@ const documentHandle = properties.get('document');
 await handle.dispose();
 ```
 
-#### jsHandle.getProperty(propertyName)
+## jsHandle.getProperty(propertyName)
 - `propertyName` <[string]> property to get
 - returns: <[Promise]<[JSHandle]>>
 
 Fetches a single property from the referenced object.
 
-#### jsHandle.jsonValue()
+## jsHandle.jsonValue()
 - returns: <[Promise]<[Serializable]>>
 
 Returns a JSON representation of the object. If the object has a `toJSON` function, it **will not be called**.
 
 > **NOTE** The method will return an empty JSON object if the referenced object is not stringifiable. It will throw an error if the object has circular references.
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/class-keyboard.md b/docs/out/api/class-keyboard.md
similarity index 98%
rename from docs/class-keyboard.md
rename to docs/out/api/class-keyboard.md
index 89f0424236..57a8c6125d 100644
--- a/docs/class-keyboard.md
+++ b/docs/out/api/class-keyboard.md
@@ -1,6 +1,6 @@
 ---
 id: class-keyboard
-title: "class: Keyboard"
+title: "Keyboard"
 ---
 
 
@@ -47,7 +47,7 @@ await page.keyboard.press('Meta+A');
 - [keyboard.type(text[, options])](api/class-keyboard.md#keyboardtypetext-options)
 - [keyboard.up(key)](api/class-keyboard.md#keyboardupkey)
 
-#### keyboard.down(key)
+## keyboard.down(key)
 - `key` <[string]> Name of the key to press or a character to generate, such as `ArrowLeft` or `a`.
 - returns: <[Promise]>
 
@@ -69,7 +69,7 @@ After the key is pressed once, subsequent calls to [keyboard.down(key)](api/clas
 
 > **NOTE** Modifier keys DO influence `keyboard.down`. Holding down `Shift` will type the text in upper case.
 
-#### keyboard.insertText(text)
+## keyboard.insertText(text)
 - `text` <[string]> Sets input to the specified text value.
 - returns: <[Promise]>
 
@@ -81,7 +81,7 @@ page.keyboard.insertText('嗨');
 
 > **NOTE** Modifier keys DO NOT effect `keyboard.insertText`. Holding down `Shift` will not type the text in upper case.
 
-#### keyboard.press(key[, options])
+## keyboard.press(key[, options])
 - `key` <[string]> Name of the key to press or a character to generate, such as `ArrowLeft` or `a`.
 - `options` <[Object]>
   - `delay` <[number]> Time to wait between `keydown` and `keyup` in milliseconds. Defaults to 0.
@@ -113,7 +113,7 @@ await browser.close();
 
 Shortcut for [keyboard.down(key)](api/class-keyboard.md#keyboarddownkey) and [keyboard.up(key)](api/class-keyboard.md#keyboardupkey).
 
-#### keyboard.type(text[, options])
+## keyboard.type(text[, options])
 - `text` <[string]> A text to type into a focused element.
 - `options` <[Object]>
   - `delay` <[number]> Time to wait between key presses in milliseconds. Defaults to 0.
@@ -130,11 +130,12 @@ await page.keyboard.type('World', {delay: 100}); // Types slower, like a user
 
 > **NOTE** Modifier keys DO NOT effect `keyboard.type`. Holding down `Shift` will not type the text in upper case.
 
-#### keyboard.up(key)
+## keyboard.up(key)
 - `key` <[string]> Name of the key to press or a character to generate, such as `ArrowLeft` or `a`.
 - returns: <[Promise]>
 
 Dispatches a `keyup` event.
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/class-logger.md b/docs/out/api/class-logger.md
similarity index 97%
rename from docs/class-logger.md
rename to docs/out/api/class-logger.md
index 46ef289e6f..3fa6fcfcb7 100644
--- a/docs/class-logger.md
+++ b/docs/out/api/class-logger.md
@@ -1,6 +1,6 @@
 ---
 id: class-logger
-title: "class: Logger"
+title: "Logger"
 ---
 
 
@@ -24,20 +24,21 @@ const { chromium } = require('playwright');  // Or 'firefox' or 'webkit'.
 - [logger.isEnabled(name, severity)](api/class-logger.md#loggerisenabledname-severity)
 - [logger.log(name, severity, message, args, hints)](api/class-logger.md#loggerlogname-severity-message-args-hints)
 
-#### logger.isEnabled(name, severity)
+## logger.isEnabled(name, severity)
 - `name` <[string]> logger name
 - `severity` <"verbose"|"info"|"warning"|"error">
 - returns: <[boolean]>
 
 Determines whether sink is interested in the logger with the given name and severity.
 
-#### logger.log(name, severity, message, args, hints)
+## logger.log(name, severity, message, args, hints)
 - `name` <[string]> logger name
 - `severity` <"verbose"|"info"|"warning"|"error">
 - `message` <[string]|[Error]> log message format
 - `args` <[Array]<[Object]>> message arguments
 - `hints` <[Object]> optional formatting hints
   - `color` <[string]> Optional preferred logger color.
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/class-mouse.md b/docs/out/api/class-mouse.md
similarity index 97%
rename from docs/class-mouse.md
rename to docs/out/api/class-mouse.md
index b90e11d9f7..c8ceae5ec8 100644
--- a/docs/class-mouse.md
+++ b/docs/out/api/class-mouse.md
@@ -1,6 +1,6 @@
 ---
 id: class-mouse
-title: "class: Mouse"
+title: "Mouse"
 ---
 
 
@@ -26,7 +26,7 @@ await page.mouse.up();
 - [mouse.move(x, y[, options])](api/class-mouse.md#mousemovex-y-options)
 - [mouse.up([options])](api/class-mouse.md#mouseupoptions)
 
-#### mouse.click(x, y[, options])
+## mouse.click(x, y[, options])
 - `x` <[number]>
 - `y` <[number]>
 - `options` <[Object]>
@@ -37,7 +37,7 @@ await page.mouse.up();
 
 Shortcut for [mouse.move(x, y[, options])](api/class-mouse.md#mousemovex-y-options), [mouse.down([options])](api/class-mouse.md#mousedownoptions), [mouse.up([options])](api/class-mouse.md#mouseupoptions).
 
-#### mouse.dblclick(x, y[, options])
+## mouse.dblclick(x, y[, options])
 - `x` <[number]>
 - `y` <[number]>
 - `options` <[Object]>
@@ -47,7 +47,7 @@ Shortcut for [mouse.move(x, y[, options])](api/class-mouse.md#mousemovex-y-optio
 
 Shortcut for [mouse.move(x, y[, options])](api/class-mouse.md#mousemovex-y-options), [mouse.down([options])](api/class-mouse.md#mousedownoptions), [mouse.up([options])](api/class-mouse.md#mouseupoptions), [mouse.down([options])](api/class-mouse.md#mousedownoptions) and [mouse.up([options])](api/class-mouse.md#mouseupoptions).
 
-#### mouse.down([options])
+## mouse.down([options])
 - `options` <[Object]>
   - `button` <"left"|"right"|"middle"> Defaults to `left`.
   - `clickCount` <[number]> defaults to 1. See [UIEvent.detail].
@@ -55,7 +55,7 @@ Shortcut for [mouse.move(x, y[, options])](api/class-mouse.md#mousemovex-y-optio
 
 Dispatches a `mousedown` event.
 
-#### mouse.move(x, y[, options])
+## mouse.move(x, y[, options])
 - `x` <[number]>
 - `y` <[number]>
 - `options` <[Object]>
@@ -64,13 +64,14 @@ Dispatches a `mousedown` event.
 
 Dispatches a `mousemove` event.
 
-#### mouse.up([options])
+## mouse.up([options])
 - `options` <[Object]>
   - `button` <"left"|"right"|"middle"> Defaults to `left`.
   - `clickCount` <[number]> defaults to 1. See [UIEvent.detail].
 - returns: <[Promise]>
 
 Dispatches a `mouseup` event.
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/class-page.md b/docs/out/api/class-page.md
similarity index 96%
rename from docs/class-page.md
rename to docs/out/api/class-page.md
index 30b3465b90..b5f88f5b3b 100644
--- a/docs/class-page.md
+++ b/docs/out/api/class-page.md
@@ -1,6 +1,6 @@
 ---
 id: class-page
-title: "class: Page"
+title: "Page"
 ---
 
 * extends: [EventEmitter](https://nodejs.org/api/events.html#events_class_eventemitter)
@@ -131,11 +131,11 @@ page.removeListener('request', logRequest);
 - [page.waitForTimeout(timeout)](api/class-page.md#pagewaitfortimeouttimeout)
 - [page.workers()](api/class-page.md#pageworkers)
 
-#### page.on('close')
+## page.on('close')
 
 Emitted when the page closes.
 
-#### page.on('console')
+## page.on('console')
 - type: <[ConsoleMessage]>
 
 Emitted when JavaScript within the page calls one of console API methods, e.g. `console.log` or `console.dir`. Also emitted if the page throws an error or a warning.
@@ -152,7 +152,7 @@ page.on('console', msg => {
 page.evaluate(() => console.log('hello', 5, {foo: 'bar'}));
 ```
 
-#### page.on('crash')
+## page.on('crash')
 
 Emitted when the page crashes. Browser pages might crash if they try to allocate too much memory. When the page crashes, ongoing and subsequent operations will throw.
 
@@ -181,23 +181,23 @@ await new Promise((resolve, reject) => {
 });
 ```
 
-#### page.on('dialog')
+## page.on('dialog')
 - type: <[Dialog]>
 
 Emitted when a JavaScript dialog appears, such as `alert`, `prompt`, `confirm` or `beforeunload`. Playwright can respond to the dialog via [dialog.accept([promptText])](api/class-dialog.md#dialogacceptprompttext) or [dialog.dismiss()](api/class-dialog.md#dialogdismiss) methods.
 
-#### page.on('domcontentloaded')
+## page.on('domcontentloaded')
 
 Emitted when the JavaScript [`DOMContentLoaded`](https://developer.mozilla.org/en-US/docs/Web/Events/DOMContentLoaded) event is dispatched.
 
-#### page.on('download')
+## page.on('download')
 - type: <[Download]>
 
 Emitted when attachment download started. User can access basic file operations on downloaded content via the passed [Download] instance.
 
 > **NOTE** Browser context **must** be created with the `acceptDownloads` set to `true` when user needs access to the downloaded content. If `acceptDownloads` is not set or set to `false`, download events are emitted, but the actual download is not performed and user has no access to the downloaded files.
 
-#### page.on('filechooser')
+## page.on('filechooser')
 - type: <[FileChooser]>
 
 Emitted when a file chooser is supposed to appear, such as after clicking the  `<input type=file>`. Playwright can respond to it via setting the input files using [fileChooser.setFiles(files[, options])](api/class-filechooser.md#filechoosersetfilesfiles-options) that can be uploaded after that.
@@ -208,31 +208,31 @@ page.on('filechooser', async (fileChooser) => {
 });
 ```
 
-#### page.on('frameattached')
+## page.on('frameattached')
 - type: <[Frame]>
 
 Emitted when a frame is attached.
 
-#### page.on('framedetached')
+## page.on('framedetached')
 - type: <[Frame]>
 
 Emitted when a frame is detached.
 
-#### page.on('framenavigated')
+## page.on('framenavigated')
 - type: <[Frame]>
 
 Emitted when a frame is navigated to a new url.
 
-#### page.on('load')
+## page.on('load')
 
 Emitted when the JavaScript [`load`](https://developer.mozilla.org/en-US/docs/Web/Events/load) event is dispatched.
 
-#### page.on('pageerror')
+## page.on('pageerror')
 - type: <[Error]>
 
 Emitted when an uncaught exception happens within the page.
 
-#### page.on('popup')
+## page.on('popup')
 - type: <[Page]>
 
 Emitted when the page opens a new tab or window. This event is emitted in addition to the [browserContext.on('page')](api/class-browsercontext.md#browsercontextonpage), but only for popups relevant to this page.
@@ -249,39 +249,39 @@ console.log(await popup.evaluate('location.href'));
 
 > **NOTE** Use [page.waitForLoadState([state, options])](api/class-page.md#pagewaitforloadstatestate-options) to wait until the page gets to a particular state (you should not need it in most cases).
 
-#### page.on('request')
+## page.on('request')
 - type: <[Request]>
 
 Emitted when a page issues a request. The [request] object is read-only. In order to intercept and mutate requests, see [page.route(url, handler)](api/class-page.md#pagerouteurl-handler) or [browserContext.route(url, handler)](api/class-browsercontext.md#browsercontextrouteurl-handler).
 
-#### page.on('requestfailed')
+## page.on('requestfailed')
 - type: <[Request]>
 
 Emitted when a request fails, for example by timing out.
 
 > **NOTE** HTTP Error responses, such as 404 or 503, are still successful responses from HTTP standpoint, so request will complete with [page.on('requestfinished')](api/class-page.md#pageonrequestfinished) event and not with [page.on('requestfailed')](api/class-page.md#pageonrequestfailed).
 
-#### page.on('requestfinished')
+## page.on('requestfinished')
 - type: <[Request]>
 
 Emitted when a request finishes successfully after downloading the response body. For a successful response, the sequence of events is `request`, `response` and `requestfinished`.
 
-#### page.on('response')
+## page.on('response')
 - type: <[Response]>
 
 Emitted when [response] status and headers are received for a request. For a successful response, the sequence of events is `request`, `response` and `requestfinished`.
 
-#### page.on('websocket')
+## page.on('websocket')
 - type: <[WebSocket]>
 
 Emitted when <[WebSocket]> request is sent.
 
-#### page.on('worker')
+## page.on('worker')
 - type: <[Worker]>
 
 Emitted when a dedicated [WebWorker](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API) is spawned by the page.
 
-#### page.$(selector)
+## page.$(selector)
 - `selector` <[string]> A selector to query for. See [working with selectors](./selectors.md#working-with-selectors) for more details.
 - returns: <[Promise]<[null]|[ElementHandle]>>
 
@@ -289,7 +289,7 @@ The method finds an element matching the specified selector within the page. If
 
 Shortcut for main frame's [frame.$(selector)](api/class-frame.md#frameselector).
 
-#### page.$$(selector)
+## page.$$(selector)
 - `selector` <[string]> A selector to query for. See [working with selectors](./selectors.md#working-with-selectors) for more details.
 - returns: <[Promise]<[Array]<[ElementHandle]>>>
 
@@ -297,7 +297,7 @@ The method finds all elements matching the specified selector within the page. I
 
 Shortcut for main frame's [frame.$$(selector)](api/class-frame.md#frameselector-1).
 
-#### page.$eval(selector, pageFunction[, arg])
+## page.$eval(selector, pageFunction[, arg])
 - `selector` <[string]> A selector to query for. See [working with selectors](./selectors.md#working-with-selectors) for more details.
 - `pageFunction` <[function]\([Element]\)> Function to be evaluated in browser context
 - `arg` <[EvaluationArgument]> Optional argument to pass to `pageFunction`
@@ -317,7 +317,7 @@ const html = await page.$eval('.main-container', (e, suffix) => e.outerHTML + su
 
 Shortcut for main frame's [frame.$eval(selector, pageFunction[, arg])](api/class-frame.md#frameevalselector-pagefunction-arg).
 
-#### page.$$eval(selector, pageFunction[, arg])
+## page.$$eval(selector, pageFunction[, arg])
 - `selector` <[string]> A selector to query for. See [working with selectors](./selectors.md#working-with-selectors) for more details.
 - `pageFunction` <[function]\([Array]<[Element]>\)> Function to be evaluated in browser context
 - `arg` <[EvaluationArgument]> Optional argument to pass to `pageFunction`
@@ -333,10 +333,10 @@ Examples:
 const divsCounts = await page.$$eval('div', (divs, min) => divs.length >= min, 10);
 ```
 
-#### page.accessibility
+## page.accessibility
 - type: <[Accessibility]>
 
-#### page.addInitScript(script[, arg])
+## page.addInitScript(script[, arg])
 - `script` <[function]|[string]|[Object]> Script to be evaluated in the page.
   - `path` <[string]> Path to the JavaScript file. If `path` is a relative path, then it is resolved relative to the current working directory. Optional.
   - `content` <[string]> Raw script content. Optional.
@@ -362,7 +362,7 @@ await page.addInitScript(preloadFile);
 
 > **NOTE** The order of evaluation of multiple scripts installed via [browserContext.addInitScript(script[, arg])](api/class-browsercontext.md#browsercontextaddinitscriptscript-arg) and [page.addInitScript(script[, arg])](api/class-page.md#pageaddinitscriptscript-arg) is not defined.
 
-#### page.addScriptTag(params)
+## page.addScriptTag(params)
 - `params` <[Object]>
   - `url` <[string]> URL of a script to be added. Optional.
   - `path` <[string]> Path to the JavaScript file to be injected into frame. If `path` is a relative path, then it is resolved relative to the current working directory. Optional.
@@ -374,7 +374,7 @@ Adds a `<script>` tag into the page with the desired url or content. Returns the
 
 Shortcut for main frame's [frame.addScriptTag(params)](api/class-frame.md#frameaddscripttagparams).
 
-#### page.addStyleTag(params)
+## page.addStyleTag(params)
 - `params` <[Object]>
   - `url` <[string]> URL of the `<link>` tag. Optional.
   - `path` <[string]> Path to the CSS file to be injected into frame. If `path` is a relative path, then it is resolved relative to the current working directory. Optional.
@@ -385,12 +385,12 @@ Adds a `<link rel="stylesheet">` tag into the page with the desired url or a `<s
 
 Shortcut for main frame's [frame.addStyleTag(params)](api/class-frame.md#frameaddstyletagparams).
 
-#### page.bringToFront()
+## page.bringToFront()
 - returns: <[Promise]>
 
 Brings page to front (activates tab).
 
-#### page.check(selector[, options])
+## page.check(selector[, options])
 - `selector` <[string]> A selector to search for element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](./selectors.md#working-with-selectors) for more details.
 - `options` <[Object]>
   - `force` <[boolean]> Whether to bypass the [actionability](./actionability.md) checks. Defaults to `false`.
@@ -411,7 +411,7 @@ When all steps combined have not finished during the specified `timeout`, this m
 
 Shortcut for main frame's [frame.check(selector[, options])](api/class-frame.md#framecheckselector-options).
 
-#### page.click(selector[, options])
+## page.click(selector[, options])
 - `selector` <[string]> A selector to search for element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](./selectors.md#working-with-selectors) for more details.
 - `options` <[Object]>
   - `button` <"left"|"right"|"middle"> Defaults to `left`.
@@ -437,7 +437,7 @@ When all steps combined have not finished during the specified `timeout`, this m
 
 Shortcut for main frame's [frame.click(selector[, options])](api/class-frame.md#frameclickselector-options).
 
-#### page.close([options])
+## page.close([options])
 - `options` <[Object]>
   - `runBeforeUnload` <[boolean]> Defaults to `false`. Whether to run the [before unload](https://developer.mozilla.org/en-US/docs/Web/Events/beforeunload) page handlers.
 - returns: <[Promise]>
@@ -449,22 +449,22 @@ By default, `page.close()` **does not** run `beforeunload` handlers.
 > **NOTE** if `runBeforeUnload` is passed as true, a `beforeunload` dialog might be summoned
 > and should be handled manually via [page.on('dialog')](api/class-page.md#pageondialog) event.
 
-#### page.content()
+## page.content()
 - returns: <[Promise]<[string]>>
 
 Gets the full HTML contents of the page, including the doctype.
 
-#### page.context()
+## page.context()
 - returns: <[BrowserContext]>
 
 Get the browser context that the page belongs to.
 
-#### page.coverage
+## page.coverage
 - type: <[null]|[ChromiumCoverage]>
 
 Browser-specific Coverage implementation, only available for Chromium atm. See [ChromiumCoverage](#class-chromiumcoverage) for more details.
 
-#### page.dblclick(selector[, options])
+## page.dblclick(selector[, options])
 - `selector` <[string]> A selector to search for element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](./selectors.md#working-with-selectors) for more details.
 - `options` <[Object]>
   - `button` <"left"|"right"|"middle"> Defaults to `left`.
@@ -491,7 +491,7 @@ When all steps combined have not finished during the specified `timeout`, this m
 
 Shortcut for main frame's [frame.dblclick(selector[, options])](api/class-frame.md#framedblclickselector-options).
 
-#### page.dispatchEvent(selector, type[, eventInit, options])
+## page.dispatchEvent(selector, type[, eventInit, options])
 - `selector` <[string]> A selector to search for element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](./selectors.md#working-with-selectors) for more details.
 - `type` <[string]> DOM event type: `"click"`, `"dragstart"`, etc.
 - `eventInit` <[EvaluationArgument]> Optional event-specific initialization properties.
@@ -524,7 +524,7 @@ const dataTransfer = await page.evaluateHandle(() => new DataTransfer());
 await page.dispatchEvent('#source', 'dragstart', { dataTransfer });
 ```
 
-#### page.emulateMedia(params)
+## page.emulateMedia(params)
 - `params` <[Object]>
   - `media` <[null]|"screen"|"print"> Changes the CSS media type of the page. The only allowed values are `'screen'`, `'print'` and `null`. Passing `null` disables CSS media emulation. Omitting `media` or passing `undefined` does not change the emulated value. Optional.
   - `colorScheme` <[null]|"light"|"dark"|"no-preference"> Emulates `'prefers-colors-scheme'` media feature, supported values are `'light'`, `'dark'`, `'no-preference'`. Passing `null` disables color scheme emulation. Omitting `colorScheme` or passing `undefined` does not change the emulated value. Optional.
@@ -559,7 +559,7 @@ await page.evaluate(() => matchMedia('(prefers-color-scheme: no-preference)').ma
 // → false
 ```
 
-#### page.evaluate(pageFunction[, arg])
+## page.evaluate(pageFunction[, arg])
 - `pageFunction` <[function]|[string]> Function to be evaluated in the page context
 - `arg` <[EvaluationArgument]> Optional argument to pass to `pageFunction`
 - returns: <[Promise]<[Serializable]>>
@@ -597,7 +597,7 @@ await bodyHandle.dispose();
 
 Shortcut for main frame's [frame.evaluate(pageFunction[, arg])](api/class-frame.md#frameevaluatepagefunction-arg).
 
-#### page.evaluateHandle(pageFunction[, arg])
+## page.evaluateHandle(pageFunction[, arg])
 - `pageFunction` <[function]|[string]> Function to be evaluated in the page context
 - `arg` <[EvaluationArgument]> Optional argument to pass to `pageFunction`
 - returns: <[Promise]<[JSHandle]>>
@@ -623,7 +623,7 @@ console.log(await resultHandle.jsonValue());
 await resultHandle.dispose();
 ```
 
-#### page.exposeBinding(name, playwrightBinding[, options])
+## page.exposeBinding(name, playwrightBinding[, options])
 - `name` <[string]> Name of the function on the window object.
 - `playwrightBinding` <[function]> Callback function that will be called in the Playwright's context.
 - `options` <[Object]>
@@ -676,7 +676,7 @@ await page.setContent(`
 `);
 ```
 
-#### page.exposeFunction(name, playwrightFunction)
+## page.exposeFunction(name, playwrightFunction)
 - `name` <[string]> Name of the function on the window object
 - `playwrightFunction` <[function]> Callback function which will be called in Playwright's context.
 - returns: <[Promise]>
@@ -741,7 +741,7 @@ const fs = require('fs');
 })();
 ```
 
-#### page.fill(selector, value[, options])
+## page.fill(selector, value[, options])
 - `selector` <[string]> A selector to search for element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](./selectors.md#working-with-selectors) for more details.
 - `value` <[string]> Value to fill for the `<input>`, `<textarea>` or `[contenteditable]` element.
 - `options` <[Object]>
@@ -755,7 +755,7 @@ To send fine-grained keyboard events, use [page.type(selector, text[, options])]
 
 Shortcut for main frame's [frame.fill(selector, value[, options])](api/class-frame.md#framefillselector-value-options)
 
-#### page.focus(selector[, options])
+## page.focus(selector[, options])
 - `selector` <[string]> A selector to search for element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](./selectors.md#working-with-selectors) for more details.
 - `options` <[Object]>
   - `timeout` <[number]> Maximum time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be changed by using the [browserContext.setDefaultTimeout(timeout)](api/class-browsercontext.md#browsercontextsetdefaulttimeouttimeout) or [page.setDefaultTimeout(timeout)](api/class-page.md#pagesetdefaulttimeouttimeout) methods.
@@ -765,7 +765,7 @@ This method fetches an element with `selector` and focuses it. If there's no ele
 
 Shortcut for main frame's [frame.focus(selector[, options])](api/class-frame.md#framefocusselector-options).
 
-#### page.frame(frameSelector)
+## page.frame(frameSelector)
 - `frameSelector` <[string]|[Object]> Frame name or other frame lookup options.
   - `name` <[string]> Frame name specified in the `iframe`'s `name` attribute. Optional.
   - `url` <[string]|[RegExp]|[Function]> A glob pattern, regex pattern or predicate receiving frame's `url` as a [URL] object. Optional.
@@ -781,12 +781,12 @@ const frame = page.frame('frame-name');
 const frame = page.frame({ url: /.*domain.*/ });
 ```
 
-#### page.frames()
+## page.frames()
 - returns: <[Array]<[Frame]>>
 
 An array of all frames attached to the page.
 
-#### page.getAttribute(selector, name[, options])
+## page.getAttribute(selector, name[, options])
 - `selector` <[string]> A selector to search for element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](./selectors.md#working-with-selectors) for more details.
 - `name` <[string]> Attribute name to get the value for.
 - `options` <[Object]>
@@ -795,7 +795,7 @@ An array of all frames attached to the page.
 
 Returns element attribute value.
 
-#### page.goBack([options])
+## page.goBack([options])
 - `options` <[Object]>
   - `timeout` <[number]> Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be changed by using the [browserContext.setDefaultNavigationTimeout(timeout)](api/class-browsercontext.md#browsercontextsetdefaultnavigationtimeouttimeout), [browserContext.setDefaultTimeout(timeout)](api/class-browsercontext.md#browsercontextsetdefaulttimeouttimeout), [page.setDefaultNavigationTimeout(timeout)](api/class-page.md#pagesetdefaultnavigationtimeouttimeout) or [page.setDefaultTimeout(timeout)](api/class-page.md#pagesetdefaulttimeouttimeout) methods.
   - `waitUntil` <"load"|"domcontentloaded"|"networkidle"> When to consider operation succeeded, defaults to `load`. Events can be either:
@@ -808,7 +808,7 @@ Returns the main resource response. In case of multiple redirects, the navigatio
 
 Navigate to the previous page in history.
 
-#### page.goForward([options])
+## page.goForward([options])
 - `options` <[Object]>
   - `timeout` <[number]> Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be changed by using the [browserContext.setDefaultNavigationTimeout(timeout)](api/class-browsercontext.md#browsercontextsetdefaultnavigationtimeouttimeout), [browserContext.setDefaultTimeout(timeout)](api/class-browsercontext.md#browsercontextsetdefaulttimeouttimeout), [page.setDefaultNavigationTimeout(timeout)](api/class-page.md#pagesetdefaultnavigationtimeouttimeout) or [page.setDefaultTimeout(timeout)](api/class-page.md#pagesetdefaulttimeouttimeout) methods.
   - `waitUntil` <"load"|"domcontentloaded"|"networkidle"> When to consider operation succeeded, defaults to `load`. Events can be either:
@@ -821,7 +821,7 @@ Returns the main resource response. In case of multiple redirects, the navigatio
 
 Navigate to the next page in history.
 
-#### page.goto(url[, options])
+## page.goto(url[, options])
 - `url` <[string]> URL to navigate page to. The url should include scheme, e.g. `https://`.
 - `options` <[Object]>
   - `referer` <[string]> Referer header value. If provided it will take preference over the referer header value set by [page.setExtraHTTPHeaders(headers)](api/class-page.md#pagesetextrahttpheadersheaders).
@@ -848,7 +848,7 @@ Returns the main resource response. In case of multiple redirects, the navigatio
 
 Shortcut for main frame's [frame.goto(url[, options])](api/class-frame.md#framegotourl-options)
 
-#### page.hover(selector[, options])
+## page.hover(selector[, options])
 - `selector` <[string]> A selector to search for element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](./selectors.md#working-with-selectors) for more details.
 - `options` <[Object]>
   - `force` <[boolean]> Whether to bypass the [actionability](./actionability.md) checks. Defaults to `false`.
@@ -870,7 +870,7 @@ When all steps combined have not finished during the specified `timeout`, this m
 
 Shortcut for main frame's [frame.hover(selector[, options])](api/class-frame.md#framehoverselector-options).
 
-#### page.innerHTML(selector[, options])
+## page.innerHTML(selector[, options])
 - `selector` <[string]> A selector to search for element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](./selectors.md#working-with-selectors) for more details.
 - `options` <[Object]>
   - `timeout` <[number]> Maximum time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be changed by using the [browserContext.setDefaultTimeout(timeout)](api/class-browsercontext.md#browsercontextsetdefaulttimeouttimeout) or [page.setDefaultTimeout(timeout)](api/class-page.md#pagesetdefaulttimeouttimeout) methods.
@@ -878,7 +878,7 @@ Shortcut for main frame's [frame.hover(selector[, options])](api/class-frame.md#
 
 Returns `element.innerHTML`.
 
-#### page.innerText(selector[, options])
+## page.innerText(selector[, options])
 - `selector` <[string]> A selector to search for element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](./selectors.md#working-with-selectors) for more details.
 - `options` <[Object]>
   - `timeout` <[number]> Maximum time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be changed by using the [browserContext.setDefaultTimeout(timeout)](api/class-browsercontext.md#browsercontextsetdefaulttimeouttimeout) or [page.setDefaultTimeout(timeout)](api/class-page.md#pagesetdefaulttimeouttimeout) methods.
@@ -886,28 +886,28 @@ Returns `element.innerHTML`.
 
 Returns `element.innerText`.
 
-#### page.isClosed()
+## page.isClosed()
 - returns: <[boolean]>
 
 Indicates that the page has been closed.
 
-#### page.keyboard
+## page.keyboard
 - type: <[Keyboard]>
 
-#### page.mainFrame()
+## page.mainFrame()
 - returns: <[Frame]>
 
 The page's main frame. Page is guaranteed to have a main frame which persists during navigations.
 
-#### page.mouse
+## page.mouse
 - type: <[Mouse]>
 
-#### page.opener()
+## page.opener()
 - returns: <[Promise]<[null]|[Page]>>
 
 Returns the opener for popup pages and `null` for others. If the opener has been closed already the returns `null`.
 
-#### page.pdf([options])
+## page.pdf([options])
 - `options` <[Object]>
   - `displayHeaderFooter` <[boolean]> Display header and footer. Defaults to `false`.
   - `footerTemplate` <[string]> HTML template for the print footer. Should use the same format as the `headerTemplate`.
@@ -977,7 +977,7 @@ The `format` options are:
 > 1. Script tags inside templates are not evaluated.
 > 2. Page styles are not visible inside templates.
 
-#### page.press(selector, key[, options])
+## page.press(selector, key[, options])
 - `selector` <[string]> A selector to search for element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](./selectors.md#working-with-selectors) for more details.
 - `key` <[string]> Name of the key to press or a character to generate, such as `ArrowLeft` or `a`.
 - `options` <[Object]>
@@ -1012,7 +1012,7 @@ await page.screenshot({ path: 'O.png' });
 await browser.close();
 ```
 
-#### page.reload([options])
+## page.reload([options])
 - `options` <[Object]>
   - `timeout` <[number]> Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be changed by using the [browserContext.setDefaultNavigationTimeout(timeout)](api/class-browsercontext.md#browsercontextsetdefaultnavigationtimeouttimeout), [browserContext.setDefaultTimeout(timeout)](api/class-browsercontext.md#browsercontextsetdefaulttimeouttimeout), [page.setDefaultNavigationTimeout(timeout)](api/class-page.md#pagesetdefaultnavigationtimeouttimeout) or [page.setDefaultTimeout(timeout)](api/class-page.md#pagesetdefaulttimeouttimeout) methods.
   - `waitUntil` <"load"|"domcontentloaded"|"networkidle"> When to consider operation succeeded, defaults to `load`. Events can be either:
@@ -1023,7 +1023,7 @@ await browser.close();
 
 Returns the main resource response. In case of multiple redirects, the navigation will resolve with the response of the last redirect.
 
-#### page.route(url, handler)
+## page.route(url, handler)
 - `url` <[string]|[RegExp]|[function]\([URL]\):[boolean]> A glob pattern, regex pattern or predicate receiving [URL] to match while routing.
 - `handler` <[function]\([Route], [Request]\)> handler function to route the request.
 - returns: <[Promise]>
@@ -1056,7 +1056,7 @@ Page routes take precedence over browser context routes (set up with [browserCon
 
 > **NOTE** Enabling routing disables http cache.
 
-#### page.screenshot([options])
+## page.screenshot([options])
 - `options` <[Object]>
   - `clip` <[Object]> An object which specifies clipping of the resulting image. Should have the following fields:
     - `x` <[number]> x-coordinate of top-left corner of clip area
@@ -1075,7 +1075,7 @@ Returns the buffer with the captured screenshot.
 
 > **NOTE** Screenshots take at least 1/6 second on Chromium OS X and Chromium Windows. See https://crbug.com/741689 for discussion.
 
-#### page.selectOption(selector, values[, options])
+## page.selectOption(selector, values[, options])
 - `selector` <[string]> A selector to search for element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](./selectors.md#working-with-selectors) for more details.
 - `values` <[null]|[string]|[ElementHandle]|[Array]<[string]>|[Object]|[Array]<[ElementHandle]>|[Array]<[Object]>> Options to select. If the `<select>` has the `multiple` attribute, all matching options are selected, otherwise only the first option matching one of the passed options is selected. String values are equivalent to `{value:'string'}`. Option is considered matching if all specified properties match.
   - `value` <[string]> Matches by `option.value`. Optional.
@@ -1104,7 +1104,7 @@ page.selectOption('select#colors', ['red', 'green', 'blue']);
 
 Shortcut for main frame's [frame.selectOption(selector, values[, options])](api/class-frame.md#frameselectoptionselector-values-options)
 
-#### page.setContent(html[, options])
+## page.setContent(html[, options])
 - `html` <[string]> HTML markup to assign to the page.
 - `options` <[Object]>
   - `timeout` <[number]> Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be changed by using the [browserContext.setDefaultNavigationTimeout(timeout)](api/class-browsercontext.md#browsercontextsetdefaultnavigationtimeouttimeout), [browserContext.setDefaultTimeout(timeout)](api/class-browsercontext.md#browsercontextsetdefaulttimeouttimeout), [page.setDefaultNavigationTimeout(timeout)](api/class-page.md#pagesetdefaultnavigationtimeouttimeout) or [page.setDefaultTimeout(timeout)](api/class-page.md#pagesetdefaulttimeouttimeout) methods.
@@ -1114,7 +1114,7 @@ Shortcut for main frame's [frame.selectOption(selector, values[, options])](api/
     * `'networkidle'` - consider operation to be finished when there are no network connections for at least `500` ms.
 - returns: <[Promise]>
 
-#### page.setDefaultNavigationTimeout(timeout)
+## page.setDefaultNavigationTimeout(timeout)
 - `timeout` <[number]> Maximum navigation time in milliseconds
 
 This setting will change the default maximum navigation time for the following methods and related shortcuts:
@@ -1127,14 +1127,14 @@ This setting will change the default maximum navigation time for the following m
 
 > **NOTE** [page.setDefaultNavigationTimeout(timeout)](api/class-page.md#pagesetdefaultnavigationtimeouttimeout) takes priority over [page.setDefaultTimeout(timeout)](api/class-page.md#pagesetdefaulttimeouttimeout), [browserContext.setDefaultTimeout(timeout)](api/class-browsercontext.md#browsercontextsetdefaulttimeouttimeout) and [browserContext.setDefaultNavigationTimeout(timeout)](api/class-browsercontext.md#browsercontextsetdefaultnavigationtimeouttimeout).
 
-#### page.setDefaultTimeout(timeout)
+## page.setDefaultTimeout(timeout)
 - `timeout` <[number]> Maximum time in milliseconds
 
 This setting will change the default maximum time for all the methods accepting `timeout` option.
 
 > **NOTE** [page.setDefaultNavigationTimeout(timeout)](api/class-page.md#pagesetdefaultnavigationtimeouttimeout) takes priority over [page.setDefaultTimeout(timeout)](api/class-page.md#pagesetdefaulttimeouttimeout).
 
-#### page.setExtraHTTPHeaders(headers)
+## page.setExtraHTTPHeaders(headers)
 - `headers` <[Object]<[string], [string]>> An object containing additional HTTP headers to be sent with every request. All header values must be strings.
 - returns: <[Promise]>
 
@@ -1142,7 +1142,7 @@ The extra HTTP headers will be sent with every request the page initiates.
 
 > **NOTE** page.setExtraHTTPHeaders does not guarantee the order of headers in the outgoing requests.
 
-#### page.setInputFiles(selector, files[, options])
+## page.setInputFiles(selector, files[, options])
 - `selector` <[string]> A selector to search for element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](./selectors.md#working-with-selectors) for more details.
 - `files` <[string]|[Array]<[string]>|[Object]|[Array]<[Object]>>
   - `name` <[string]> [File] name **required**
@@ -1157,7 +1157,7 @@ This method expects `selector` to point to an [input element](https://developer.
 
 Sets the value of the file input to these file paths or files. If some of the `filePaths` are relative paths, then they are resolved relative to the the current working directory. For empty array, clears the selected files.
 
-#### page.setViewportSize(viewportSize)
+## page.setViewportSize(viewportSize)
 - `viewportSize` <[Object]>
   - `width` <[number]> page width in pixels. **required**
   - `height` <[number]> page height in pixels. **required**
@@ -1176,7 +1176,7 @@ await page.setViewportSize({
 await page.goto('https://example.com');
 ```
 
-#### page.tap(selector[, options])
+## page.tap(selector[, options])
 - `selector` <[string]> A selector to search for element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](./selectors.md#working-with-selectors) for more details.
 - `options` <[Object]>
   - `force` <[boolean]> Whether to bypass the [actionability](./actionability.md) checks. Defaults to `false`.
@@ -1201,7 +1201,7 @@ When all steps combined have not finished during the specified `timeout`, this m
 
 Shortcut for main frame's [frame.tap(selector[, options])](api/class-frame.md#frametapselector-options).
 
-#### page.textContent(selector[, options])
+## page.textContent(selector[, options])
 - `selector` <[string]> A selector to search for element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](./selectors.md#working-with-selectors) for more details.
 - `options` <[Object]>
   - `timeout` <[number]> Maximum time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be changed by using the [browserContext.setDefaultTimeout(timeout)](api/class-browsercontext.md#browsercontextsetdefaulttimeouttimeout) or [page.setDefaultTimeout(timeout)](api/class-page.md#pagesetdefaulttimeouttimeout) methods.
@@ -1209,15 +1209,15 @@ Shortcut for main frame's [frame.tap(selector[, options])](api/class-frame.md#fr
 
 Returns `element.textContent`.
 
-#### page.title()
+## page.title()
 - returns: <[Promise]<[string]>>
 
 Returns the page's title. Shortcut for main frame's [frame.title()](api/class-frame.md#frametitle).
 
-#### page.touchscreen
+## page.touchscreen
 - type: <[Touchscreen]>
 
-#### page.type(selector, text[, options])
+## page.type(selector, text[, options])
 - `selector` <[string]> A selector to search for element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](./selectors.md#working-with-selectors) for more details.
 - `text` <[string]> A text to type into a focused element.
 - `options` <[Object]>
@@ -1237,7 +1237,7 @@ await page.type('#mytextarea', 'World', {delay: 100}); // Types slower, like a u
 
 Shortcut for main frame's [frame.type(selector, text[, options])](api/class-frame.md#frametypeselector-text-options).
 
-#### page.uncheck(selector[, options])
+## page.uncheck(selector[, options])
 - `selector` <[string]> A selector to search for element. If there are multiple elements satisfying the selector, the first will be used. See [working with selectors](./selectors.md#working-with-selectors) for more details.
 - `options` <[Object]>
   - `force` <[boolean]> Whether to bypass the [actionability](./actionability.md) checks. Defaults to `false`.
@@ -1258,29 +1258,29 @@ When all steps combined have not finished during the specified `timeout`, this m
 
 Shortcut for main frame's [frame.uncheck(selector[, options])](api/class-frame.md#frameuncheckselector-options).
 
-#### page.unroute(url[, handler])
+## page.unroute(url[, handler])
 - `url` <[string]|[RegExp]|[function]\([URL]\):[boolean]> A glob pattern, regex pattern or predicate receiving [URL] to match while routing.
 - `handler` <[function]\([Route], [Request]\)> Optional handler function to route the request.
 - returns: <[Promise]>
 
 Removes a route created with [page.route(url, handler)](api/class-page.md#pagerouteurl-handler). When `handler` is not specified, removes all routes for the `url`.
 
-#### page.url()
+## page.url()
 - returns: <[string]>
 
 Shortcut for main frame's [frame.url()](api/class-frame.md#frameurl).
 
-#### page.video()
+## page.video()
 - returns: <[null]|[Video]>
 
 Video object associated with this page.
 
-#### page.viewportSize()
+## page.viewportSize()
 - returns: <[null]|[Object]>
   - `width` <[number]> page width in pixels.
   - `height` <[number]> page height in pixels.
 
-#### page.waitForEvent(event[, optionsOrPredicate])
+## page.waitForEvent(event[, optionsOrPredicate])
 - `event` <[string]> Event name, same one would pass into `page.on(event)`.
 - `optionsOrPredicate` <[Function]|[Object]> Either a predicate that receives an event or an options object. Optional.
   - `predicate` <[Function]> receives the event data and resolves to truthy value when the waiting should resolve.
@@ -1291,7 +1291,7 @@ Returns the event data value.
 
 Waits for event to fire and passes its value into the predicate function. Returns when the predicate returns truthy value. Will throw an error if the page is closed before the event is fired.
 
-#### page.waitForFunction(pageFunction[, arg, options])
+## page.waitForFunction(pageFunction[, arg, options])
 - `pageFunction` <[function]|[string]> Function to be evaluated in browser context
 - `arg` <[EvaluationArgument]> Optional argument to pass to `pageFunction`
 - `options` <[Object]>
@@ -1325,7 +1325,7 @@ await page.waitForFunction(selector => !!document.querySelector(selector), selec
 
 Shortcut for main frame's [frame.waitForFunction(pageFunction[, arg, options])](api/class-frame.md#framewaitforfunctionpagefunction-arg-options).
 
-#### page.waitForLoadState([state, options])
+## page.waitForLoadState([state, options])
 - `state` <"load"|"domcontentloaded"|"networkidle"> Optional load state to wait for, defaults to `load`. If the state has been already reached while loading current document, the method resolves immediately. Can be one of:
   * `'load'` - wait for the `load` event to be fired.
   * `'domcontentloaded'` - wait for the `DOMContentLoaded` event to be fired.
@@ -1354,7 +1354,7 @@ console.log(await popup.title()); // Popup is ready to use.
 
 Shortcut for main frame's [frame.waitForLoadState([state, options])](api/class-frame.md#framewaitforloadstatestate-options).
 
-#### page.waitForNavigation([options])
+## page.waitForNavigation([options])
 - `options` <[Object]>
   - `timeout` <[number]> Maximum operation time in milliseconds, defaults to 30 seconds, pass `0` to disable timeout. The default value can be changed by using the [browserContext.setDefaultNavigationTimeout(timeout)](api/class-browsercontext.md#browsercontextsetdefaultnavigationtimeouttimeout), [browserContext.setDefaultTimeout(timeout)](api/class-browsercontext.md#browsercontextsetdefaulttimeouttimeout), [page.setDefaultNavigationTimeout(timeout)](api/class-page.md#pagesetdefaultnavigationtimeouttimeout) or [page.setDefaultTimeout(timeout)](api/class-page.md#pagesetdefaulttimeouttimeout) methods.
   - `url` <[string]|[RegExp]|[Function]> A glob pattern, regex pattern or predicate receiving [URL] to match while waiting for the navigation.
@@ -1379,7 +1379,7 @@ const [response] = await Promise.all([
 
 Shortcut for main frame's [frame.waitForNavigation([options])](api/class-frame.md#framewaitfornavigationoptions).
 
-#### page.waitForRequest(urlOrPredicate[, options])
+## page.waitForRequest(urlOrPredicate[, options])
 - `urlOrPredicate` <[string]|[RegExp]|[Function]> Request URL string, regex or predicate receiving [Request] object.
 - `options` <[Object]>
   - `timeout` <[number]> Maximum wait time in milliseconds, defaults to 30 seconds, pass `0` to disable the timeout. The default value can be changed by using the [page.setDefaultTimeout(timeout)](api/class-page.md#pagesetdefaulttimeouttimeout) method.
@@ -1397,7 +1397,7 @@ return firstRequest.url();
 await page.waitForRequest(request => request.url().searchParams.get('foo') === 'bar' && request.url().searchParams.get('foo2') === 'bar2');
 ```
 
-#### page.waitForResponse(urlOrPredicate[, options])
+## page.waitForResponse(urlOrPredicate[, options])
 - `urlOrPredicate` <[string]|[RegExp]|[function]\([Response]\):[boolean]> Request URL string, regex or predicate receiving [Response] object.
 - `options` <[Object]>
   - `timeout` <[number]> Maximum wait time in milliseconds, defaults to 30 seconds, pass `0` to disable the timeout. The default value can be changed by using the [browserContext.setDefaultTimeout(timeout)](api/class-browsercontext.md#browsercontextsetdefaulttimeouttimeout) or [page.setDefaultTimeout(timeout)](api/class-page.md#pagesetdefaulttimeouttimeout) methods.
@@ -1411,7 +1411,7 @@ const finalResponse = await page.waitForResponse(response => response.url() ===
 return finalResponse.ok();
 ```
 
-#### page.waitForSelector(selector[, options])
+## page.waitForSelector(selector[, options])
 - `selector` <[string]> A selector to query for. See [working with selectors](./selectors.md#working-with-selectors) for more details.
 - `options` <[Object]>
   - `state` <"attached"|"detached"|"visible"|"hidden"> Defaults to `'visible'`. Can be either:
@@ -1445,7 +1445,7 @@ const { chromium } = require('playwright');  // Or 'firefox' or 'webkit'.
 })();
 ```
 
-#### page.waitForTimeout(timeout)
+## page.waitForTimeout(timeout)
 - `timeout` <[number]> A timeout to wait for
 - returns: <[Promise]>
 
@@ -1460,12 +1460,13 @@ await page.waitForTimeout(1000);
 
 Shortcut for main frame's [frame.waitForTimeout(timeout)](api/class-frame.md#framewaitfortimeouttimeout).
 
-#### page.workers()
+## page.workers()
 - returns: <[Array]<[Worker]>>
 
 This method returns all of the dedicated [WebWorkers](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API) associated with the page.
 
 > **NOTE** This does not contain ServiceWorkers
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/class-playwright.md b/docs/out/api/class-playwright.md
similarity index 97%
rename from docs/class-playwright.md
rename to docs/out/api/class-playwright.md
index cdc469bf7e..01b6bd49ee 100644
--- a/docs/class-playwright.md
+++ b/docs/out/api/class-playwright.md
@@ -1,6 +1,6 @@
 ---
 id: class-playwright
-title: "class: Playwright"
+title: "Playwright"
 ---
 
 
@@ -28,12 +28,12 @@ By default, the `playwright` NPM package automatically downloads browser executa
 - [playwright.selectors](api/class-playwright.md#playwrightselectors)
 - [playwright.webkit](api/class-playwright.md#playwrightwebkit)
 
-#### playwright.chromium
+## playwright.chromium
 - type: <[BrowserType]>
 
 This object can be used to launch or connect to Chromium, returning instances of [ChromiumBrowser].
 
-#### playwright.devices
+## playwright.devices
 - type: <[Object]>
 
 Returns a list of devices to be used with [browser.newContext([options])](api/class-browser.md#browsernewcontextoptions) or [browser.newPage([options])](api/class-browser.md#browsernewpageoptions). Actual list of devices can be found in [src/server/deviceDescriptors.ts](https://github.com/Microsoft/playwright/blob/master/src/server/deviceDescriptors.ts).
@@ -54,7 +54,7 @@ const iPhone = devices['iPhone 6'];
 })();
 ```
 
-#### playwright.errors
+## playwright.errors
 - type: <[Object]>
   - `TimeoutError` <[function]> A class of [TimeoutError].
 
@@ -74,20 +74,21 @@ try {
 }
 ```
 
-#### playwright.firefox
+## playwright.firefox
 - type: <[BrowserType]>
 
 This object can be used to launch or connect to Firefox, returning instances of [FirefoxBrowser].
 
-#### playwright.selectors
+## playwright.selectors
 - type: <[Selectors]>
 
 Selectors can be used to install custom selector engines. See [Working with selectors](./selectors.md#working-with-selectors) for more information.
 
-#### playwright.webkit
+## playwright.webkit
 - type: <[BrowserType]>
 
 This object can be used to launch or connect to WebKit, returning instances of [WebKitBrowser].
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/class-request.md b/docs/out/api/class-request.md
similarity index 96%
rename from docs/class-request.md
rename to docs/out/api/class-request.md
index 8d4423e2fd..3b076409ef 100644
--- a/docs/class-request.md
+++ b/docs/out/api/class-request.md
@@ -1,6 +1,6 @@
 ---
 id: class-request
-title: "class: Request"
+title: "Request"
 ---
 
 
@@ -31,7 +31,7 @@ If request gets a 'redirect' response, the request is successfully finished with
 - [request.timing()](api/class-request.md#requesttiming)
 - [request.url()](api/class-request.md#requesturl)
 
-#### request.failure()
+## request.failure()
 - returns: <[null]|[Object]>
   - `errorText` <[string]> Human-readable error message, e.g. `'net::ERR_FAILED'`.
 
@@ -45,44 +45,44 @@ page.on('requestfailed', request => {
 });
 ```
 
-#### request.frame()
+## request.frame()
 - returns: <[Frame]>
 
 Returns the [Frame] that initiated this request.
 
-#### request.headers()
+## request.headers()
 - returns: <[Object]<[string], [string]>>
 
 An object with HTTP headers associated with the request. All header names are lower-case.
 
-#### request.isNavigationRequest()
+## request.isNavigationRequest()
 - returns: <[boolean]>
 
 Whether this request is driving frame's navigation.
 
-#### request.method()
+## request.method()
 - returns: <[string]>
 
 Request's method (GET, POST, etc.)
 
-#### request.postData()
+## request.postData()
 - returns: <[null]|[string]>
 
 Request's post body, if any.
 
-#### request.postDataBuffer()
+## request.postDataBuffer()
 - returns: <[null]|[Buffer]>
 
 Request's post body in a binary form, if any.
 
-#### request.postDataJSON()
+## request.postDataJSON()
 - returns: <[null]|[Object]>
 
 Returns parsed request's body for `form-urlencoded` and JSON as a fallback if any.
 
 When the response is `application/x-www-form-urlencoded` then a key/value object of the values will be returned. Otherwise it will be parsed as JSON.
 
-#### request.redirectedFrom()
+## request.redirectedFrom()
 - returns: <[null]|[Request]>
 
 Request that was redirected by the server to this one, if any.
@@ -103,7 +103,7 @@ const response = await page.goto('https://google.com');
 console.log(response.request().redirectedFrom()); // null
 ```
 
-#### request.redirectedTo()
+## request.redirectedTo()
 - returns: <[null]|[Request]>
 
 New request issued by the browser if the server responded with redirect.
@@ -114,17 +114,17 @@ This method is the opposite of [request.redirectedFrom()](api/class-request.md#r
 console.log(request.redirectedFrom().redirectedTo() === request); // true
 ```
 
-#### request.resourceType()
+## request.resourceType()
 - returns: <[string]>
 
 Contains the request's resource type as it was perceived by the rendering engine. ResourceType will be one of the following: `document`, `stylesheet`, `image`, `media`, `font`, `script`, `texttrack`, `xhr`, `fetch`, `eventsource`, `websocket`, `manifest`, `other`.
 
-#### request.response()
+## request.response()
 - returns: <[Promise]<[null]|[Response]>>
 
 Returns the matching [Response] object, or `null` if the response was not received due to error.
 
-#### request.timing()
+## request.timing()
 - returns: <[Object]>
   - `startTime` <[number]> Request start time in milliseconds elapsed since January 1, 1970 00:00:00 UTC
   - `domainLookupStart` <[number]> Time immediately before the browser starts the domain name lookup for the resource. The value is given in milliseconds relative to `startTime`, -1 if not available.
@@ -146,10 +146,11 @@ const [request] = await Promise.all([
 console.log(request.timing());
 ```
 
-#### request.url()
+## request.url()
 - returns: <[string]>
 
 URL of the request.
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/class-response.md b/docs/out/api/class-response.md
similarity index 95%
rename from docs/class-response.md
rename to docs/out/api/class-response.md
index ed2dc68986..b8743a45ec 100644
--- a/docs/class-response.md
+++ b/docs/out/api/class-response.md
@@ -1,6 +1,6 @@
 ---
 id: class-response
-title: "class: Response"
+title: "Response"
 ---
 
 
@@ -19,62 +19,63 @@ title: "class: Response"
 - [response.text()](api/class-response.md#responsetext)
 - [response.url()](api/class-response.md#responseurl)
 
-#### response.body()
+## response.body()
 - returns: <[Promise]<[Buffer]>>
 
 Returns the buffer with response body.
 
-#### response.finished()
+## response.finished()
 - returns: <[Promise]<[null]|[Error]>>
 
 Waits for this response to finish, returns failure error if request failed.
 
-#### response.frame()
+## response.frame()
 - returns: <[Frame]>
 
 Returns the [Frame] that initiated this response.
 
-#### response.headers()
+## response.headers()
 - returns: <[Object]<[string], [string]>>
 
 Returns the object with HTTP headers associated with the response. All header names are lower-case.
 
-#### response.json()
+## response.json()
 - returns: <[Promise]<[Serializable]>>
 
 Returns the JSON representation of response body.
 
 This method will throw if the response body is not parsable via `JSON.parse`.
 
-#### response.ok()
+## response.ok()
 - returns: <[boolean]>
 
 Contains a boolean stating whether the response was successful (status in the range 200-299) or not.
 
-#### response.request()
+## response.request()
 - returns: <[Request]>
 
 Returns the matching [Request] object.
 
-#### response.status()
+## response.status()
 - returns: <[number]>
 
 Contains the status code of the response (e.g., 200 for a success).
 
-#### response.statusText()
+## response.statusText()
 - returns: <[string]>
 
 Contains the status text of the response (e.g. usually an "OK" for a success).
 
-#### response.text()
+## response.text()
 - returns: <[Promise]<[string]>>
 
 Returns the text representation of response body.
 
-#### response.url()
+## response.url()
 - returns: <[string]>
 
 Contains the URL of the response.
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/class-route.md b/docs/out/api/class-route.md
similarity index 98%
rename from docs/class-route.md
rename to docs/out/api/class-route.md
index 0d8e47ae5c..c265e6bd49 100644
--- a/docs/class-route.md
+++ b/docs/out/api/class-route.md
@@ -1,6 +1,6 @@
 ---
 id: class-route
-title: "class: Route"
+title: "Route"
 ---
 
 
@@ -12,7 +12,7 @@ Whenever a network route is set up with [page.route(url, handler)](api/class-pag
 - [route.fulfill(response)](api/class-route.md#routefulfillresponse)
 - [route.request()](api/class-route.md#routerequest)
 
-#### route.abort([errorCode])
+## route.abort([errorCode])
 - `errorCode` <[string]> Optional error code. Defaults to `failed`, could be one of the following:
   * `'aborted'` - An operation was aborted (due to user action)
   * `'accessdenied'` - Permission to access a resource, other than the network, was denied
@@ -32,7 +32,7 @@ Whenever a network route is set up with [page.route(url, handler)](api/class-pag
 
 Aborts the route's request.
 
-#### route.continue([overrides])
+## route.continue([overrides])
 - `overrides` <[Object]> Optional request overrides, can override following properties:
   - `url` <[string]> If set changes the request URL. New URL must have same protocol as original one.
   - `method` <[string]> If set changes the request method (e.g. GET or POST)
@@ -54,7 +54,7 @@ await page.route('**/*', (route, request) => {
 });
 ```
 
-#### route.fulfill(response)
+## route.fulfill(response)
 - `response` <[Object]> Response that will fulfill this route's request.
   - `status` <[number]> Response status code, defaults to `200`.
   - `headers` <[Object]<[string], [string]>> Optional response headers. Header values will be converted to a string.
@@ -83,10 +83,11 @@ An example of serving static file:
 await page.route('**/xhr_endpoint', route => route.fulfill({ path: 'mock_data.json' }));
 ```
 
-#### route.request()
+## route.request()
 - returns: <[Request]>
 
 A request to be routed.
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/class-selectors.md b/docs/out/api/class-selectors.md
similarity index 98%
rename from docs/class-selectors.md
rename to docs/out/api/class-selectors.md
index e56be19b30..545415135e 100644
--- a/docs/class-selectors.md
+++ b/docs/out/api/class-selectors.md
@@ -1,6 +1,6 @@
 ---
 id: class-selectors
-title: "class: Selectors"
+title: "Selectors"
 ---
 
 
@@ -9,7 +9,7 @@ Selectors can be used to install custom selector engines. See [Working with sele
 
 - [selectors.register(name, script[, options])](api/class-selectors.md#selectorsregistername-script-options)
 
-#### selectors.register(name, script[, options])
+## selectors.register(name, script[, options])
 - `name` <[string]> Name that is used in selectors as a prefix, e.g. `{name: 'foo'}` enables `foo=myselectorbody` selectors. May only contain `[a-zA-Z0-9_]` characters.
 - `script` <[function]|[string]|[Object]> Script that evaluates to a selector engine instance.
   - `path` <[string]> Path to the JavaScript file. If `path` is a relative path, then it is resolved relative to the current working directory. Optional.
@@ -55,6 +55,7 @@ const { selectors, firefox } = require('playwright');  // Or 'chromium' or 'webk
 })();
 ```
 
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/class-timeouterror.md b/docs/out/api/class-timeouterror.md
similarity index 99%
rename from docs/class-timeouterror.md
rename to docs/out/api/class-timeouterror.md
index d3c779db8b..88b4cc6837 100644
--- a/docs/class-timeouterror.md
+++ b/docs/out/api/class-timeouterror.md
@@ -1,6 +1,6 @@
 ---
 id: class-timeouterror
-title: "class: TimeoutError"
+title: "TimeoutError"
 ---
 
 * extends: [Error]
@@ -8,6 +8,7 @@ title: "class: TimeoutError"
 TimeoutError is emitted whenever certain operations are terminated due to timeout, e.g. [page.waitForSelector(selector[, options])](api/class-page.md#pagewaitforselectorselector-options) or [browserType.launch([options])](api/class-browsertype.md#browsertypelaunchoptions).
 
 
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/class-touchscreen.md b/docs/out/api/class-touchscreen.md
similarity index 98%
rename from docs/class-touchscreen.md
rename to docs/out/api/class-touchscreen.md
index 2230b84e54..da3d13a5a9 100644
--- a/docs/class-touchscreen.md
+++ b/docs/out/api/class-touchscreen.md
@@ -1,6 +1,6 @@
 ---
 id: class-touchscreen
-title: "class: Touchscreen"
+title: "Touchscreen"
 ---
 
 
@@ -9,12 +9,13 @@ The Touchscreen class operates in main-frame CSS pixels relative to the top-left
 
 - [touchscreen.tap(x, y)](api/class-touchscreen.md#touchscreentapx-y)
 
-#### touchscreen.tap(x, y)
+## touchscreen.tap(x, y)
 - `x` <[number]>
 - `y` <[number]>
 - returns: <[Promise]>
 
 Dispatches a `touchstart` and `touchend` event with a single touch at the position (`x`,`y`).
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/class-video.md b/docs/out/api/class-video.md
similarity index 99%
rename from docs/class-video.md
rename to docs/out/api/class-video.md
index 52473eba83..0617852a3d 100644
--- a/docs/class-video.md
+++ b/docs/out/api/class-video.md
@@ -1,6 +1,6 @@
 ---
 id: class-video
-title: "class: Video"
+title: "Video"
 ---
 
 
@@ -13,10 +13,11 @@ console.log(await page.video().path());
 
 - [video.path()](api/class-video.md#videopath)
 
-#### video.path()
+## video.path()
 - returns: <[Promise]<[string]>>
 
 Returns the file system path this video will be recorded to. The video is guaranteed to be written to the filesystem upon closing the browser context.
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/class-webkitbrowser.md b/docs/out/api/class-webkitbrowser.md
similarity index 99%
rename from docs/class-webkitbrowser.md
rename to docs/out/api/class-webkitbrowser.md
index 740c620501..84d50a9c5d 100644
--- a/docs/class-webkitbrowser.md
+++ b/docs/out/api/class-webkitbrowser.md
@@ -1,6 +1,6 @@
 ---
 id: class-webkitbrowser
-title: "class: WebKitBrowser"
+title: "WebKitBrowser"
 ---
 
 * extends: [Browser]
@@ -15,6 +15,7 @@ WebKit browser instance does not expose WebKit-specific features.
 - [browser.newContext([options])](api/class-browser.md#browsernewcontextoptions)
 - [browser.newPage([options])](api/class-browser.md#browsernewpageoptions)
 - [browser.version()](api/class-browser.md#browserversion)
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/class-websocket.md b/docs/out/api/class-websocket.md
similarity index 95%
rename from docs/class-websocket.md
rename to docs/out/api/class-websocket.md
index a2397a0d42..5b4882518b 100644
--- a/docs/class-websocket.md
+++ b/docs/out/api/class-websocket.md
@@ -1,6 +1,6 @@
 ---
 id: class-websocket
-title: "class: WebSocket"
+title: "WebSocket"
 ---
 
 
@@ -15,38 +15,38 @@ The [WebSocket] class represents websocket connections in the page.
 - [webSocket.url()](api/class-websocket.md#websocketurl)
 - [webSocket.waitForEvent(event[, optionsOrPredicate])](api/class-websocket.md#websocketwaitforeventevent-optionsorpredicate)
 
-#### webSocket.on('close')
+## webSocket.on('close')
 
 Fired when the websocket closes.
 
-#### webSocket.on('framereceived')
+## webSocket.on('framereceived')
 - type: <[Object]>
   - `payload` <[string]|[Buffer]> frame payload
 
 Fired when the websocket recieves a frame.
 
-#### webSocket.on('framesent')
+## webSocket.on('framesent')
 - type: <[Object]>
   - `payload` <[string]|[Buffer]> frame payload
 
 Fired when the websocket sends a frame.
 
-#### webSocket.on('socketerror')
+## webSocket.on('socketerror')
 - type: <[String]>
 
 Fired when the websocket has an error.
 
-#### webSocket.isClosed()
+## webSocket.isClosed()
 - returns: <[boolean]>
 
 Indicates that the web socket has been closed.
 
-#### webSocket.url()
+## webSocket.url()
 - returns: <[string]>
 
 Contains the URL of the WebSocket.
 
-#### webSocket.waitForEvent(event[, optionsOrPredicate])
+## webSocket.waitForEvent(event[, optionsOrPredicate])
 - `event` <[string]> Event name, same one would pass into `webSocket.on(event)`.
 - `optionsOrPredicate` <[Function]|[Object]> Either a predicate that receives an event or an options object. Optional.
   - `predicate` <[Function]> receives the event data and resolves to truthy value when the waiting should resolve.
@@ -56,6 +56,7 @@ Contains the URL of the WebSocket.
 Returns the event data value.
 
 Waits for event to fire and passes its value into the predicate function. Returns when the predicate returns truthy value. Will throw an error if the webSocket is closed before the event is fired.
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/class-worker.md b/docs/out/api/class-worker.md
similarity index 97%
rename from docs/class-worker.md
rename to docs/out/api/class-worker.md
index cc5ce2f715..0f77e09f06 100644
--- a/docs/class-worker.md
+++ b/docs/out/api/class-worker.md
@@ -1,6 +1,6 @@
 ---
 id: class-worker
-title: "class: Worker"
+title: "Worker"
 ---
 
 
@@ -23,12 +23,12 @@ for (const worker of page.workers())
 - [worker.evaluateHandle(pageFunction[, arg])](api/class-worker.md#workerevaluatehandlepagefunction-arg)
 - [worker.url()](api/class-worker.md#workerurl)
 
-#### worker.on('close')
+## worker.on('close')
 - type: <[Worker]>
 
 Emitted when this dedicated [WebWorker](https://developer.mozilla.org/en-US/docs/Web/API/Web_Workers_API) is terminated.
 
-#### worker.evaluate(pageFunction[, arg])
+## worker.evaluate(pageFunction[, arg])
 - `pageFunction` <[function]|[string]> Function to be evaluated in the worker context
 - `arg` <[EvaluationArgument]> Optional argument to pass to `pageFunction`
 - returns: <[Promise]<[Serializable]>>
@@ -39,7 +39,7 @@ If the function passed to the `worker.evaluate` returns a [Promise], then `worke
 
 If the function passed to the `worker.evaluate` returns a non-[Serializable] value, then `worker.evaluate` returns `undefined`. DevTools Protocol also supports transferring some additional values that are not serializable by `JSON`: `-0`, `NaN`, `Infinity`, `-Infinity`, and bigint literals.
 
-#### worker.evaluateHandle(pageFunction[, arg])
+## worker.evaluateHandle(pageFunction[, arg])
 - `pageFunction` <[function]|[string]> Function to be evaluated in the page context
 - `arg` <[EvaluationArgument]> Optional argument to pass to `pageFunction`
 - returns: <[Promise]<[JSHandle]>>
@@ -50,8 +50,9 @@ The only difference between `worker.evaluate` and `worker.evaluateHandle` is tha
 
 If the function passed to the `worker.evaluateHandle` returns a [Promise], then `worker.evaluateHandle` would wait for the promise to resolve and return its value.
 
-#### worker.url()
+## worker.url()
 - returns: <[string]>
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/assertions.md b/docs/out/assertions.md
similarity index 99%
rename from docs/assertions.md
rename to docs/out/assertions.md
index 59c2251181..1ceeba5068 100644
--- a/docs/assertions.md
+++ b/docs/out/assertions.md
@@ -108,6 +108,7 @@ assert(length === 3);
 - [elementHandle.$eval(selector, pageFunction[, arg])](api/class-elementhandle.md#elementhandleevalselector-pagefunction-arg)
 - [elementHandle.$$eval(selector, pageFunction[, arg])](api/class-elementhandle.md#elementhandleevalselector-pagefunction-arg-1)
 - [EvaluationArgument]
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/auth.md b/docs/out/auth.md
similarity index 99%
rename from docs/auth.md
rename to docs/out/auth.md
index 67caab7ed5..97cfeef119 100644
--- a/docs/auth.md
+++ b/docs/out/auth.md
@@ -142,6 +142,7 @@ const context = await chromium.launchPersistentContext(userDataDir, { headless:
 ### API reference
 - [BrowserContext]
 - [browserType.launchPersistentContext(userDataDir[, options])](api/class-browsertype.md#browsertypelaunchpersistentcontextuserdatadir-options)
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/ci.md b/docs/out/ci.md
similarity index 92%
rename from docs/ci.md
rename to docs/out/ci.md
index d284776652..78bcccf8bf 100644
--- a/docs/ci.md
+++ b/docs/out/ci.md
@@ -14,7 +14,7 @@ Playwright tests can be executed in CI environments. We have created sample conf
 ## Introduction
 
 3 steps to get your tests running on CI:
-1. **Ensure CI agent can run browsers**: Use [our Docker image](docker/README.md) in Linux agents. Windows and macOS agents do not require any additional dependencies.
+1. **Ensure CI agent can run browsers**: Use [our Docker image](./docker.md) in Linux agents. Windows and macOS agents do not require any additional dependencies.
 1. **Install Playwright**: In most projects, this would be done with `npm ci` (or `npm install`). Playwright would install the relevant browsers automatically.
 1. **Run your tests**: Use `npm test` or equivalent to execute your tests.
 
@@ -35,7 +35,7 @@ We run [our tests](/.github/workflows/tests.yml) on GitHub Actions, across a mat
 
 ### Docker
 
-We have a [pre-built Docker image](docker/README.md) which can either be used directly, or as a reference to update your existing Docker definitions.
+We have a [pre-built Docker image](./docker.md) which can either be used directly, or as a reference to update your existing Docker definitions.
 
 Suggested configuration
 1. By default, Docker runs a container with a `/dev/shm` shared memory space 64MB. This is [typically too small](https://github.com/c0b/chrome-in-docker/issues/1) for Chromium and will cause Chromium to crash when rendering large pages. To fix, run the container with `docker run --shm-size=1gb` to increase the size of `/dev/shm`. Since Chromium 65, this is no longer necessary. Instead, launch the browser with the `--disable-dev-shm-usage` flag:
@@ -55,7 +55,7 @@ Suggested configuration
 
 For Windows or macOS agents, no additional configuration required, just install Playwright and run your tests.
 
-For Linux agents, you can use [our Docker container](docker/README.md) with Azure Pipelines support for [running containerized jobs](https://docs.microsoft.com/en-us/azure/devops/pipelines/process/container-phases?view=azure-devops). Alternatively, you can refer to the [Dockerfile](docker/README.md) to see additional dependencies that need to be installed on a Ubuntu agent.
+For Linux agents, you can use [our Docker container](./docker.md) with Azure Pipelines support for [running containerized jobs](https://docs.microsoft.com/en-us/azure/devops/pipelines/process/container-phases?view=azure-devops). Alternatively, you can refer to the [Dockerfile](./docker.md) to see additional dependencies that need to be installed on a Ubuntu agent.
 
 ```yml
 pool:
@@ -122,8 +122,8 @@ before_install:
 
 ### CircleCI
 
-We run our tests on CircleCI, with our [pre-built Docker image](docker/README.md). Running Playwright smoothly on CircleCI requires the following steps:
-1. Use the pre-built [Docker image](docker/README.md) in your config like so:
+We run our tests on CircleCI, with our [pre-built Docker image](./docker.md). Running Playwright smoothly on CircleCI requires the following steps:
+1. Use the pre-built [Docker image](./docker.md) in your config like so:
 
    ```yaml
    docker:
@@ -144,7 +144,7 @@ We run our tests on CircleCI, with our [pre-built Docker image](docker/README.md
 
 ### Jenkins
 
-Jenkins supports Docker agents for pipelines. Use the [Playwright Docker image](docker/README.md) to run tests on Jenkins.
+Jenkins supports Docker agents for pipelines. Use the [Playwright Docker image](./docker.md) to run tests on Jenkins.
 
 ```groovy
 pipeline {
@@ -162,7 +162,7 @@ pipeline {
 
 ### Bitbucket Pipelines
 
-Bitbucket Pipelines can use public [Docker images as build environments](https://confluence.atlassian.com/bitbucket/use-docker-images-as-build-environments-792298897.html). To run Playwright tests on Bitbucket, use our public Docker image ([see Dockerfile](docker/README.md)).
+Bitbucket Pipelines can use public [Docker images as build environments](https://confluence.atlassian.com/bitbucket/use-docker-images-as-build-environments-792298897.html). To run Playwright tests on Bitbucket, use our public Docker image ([see Dockerfile](./docker.md)).
 
 ```yml
 image: mcr.microsoft.com/playwright:bionic
@@ -177,7 +177,7 @@ const browser = await chromium.launch({ chromiumSandbox: false });
 
 ### GitLab CI
 
-To run Playwright tests on GitLab, use our public Docker image ([see Dockerfile](docker/README.md)).
+To run Playwright tests on GitLab, use our public Docker image ([see Dockerfile](./docker.md)).
 
 ```yml
 stages:
@@ -238,12 +238,13 @@ const { chromium } = require('playwright');
 const browser = await chromium.launch({ headless: false });
 ```
 
-On Linux agents, headful execution requires [Xvfb](https://en.wikipedia.org/wiki/Xvfb) to be installed. Our [Docker image](docker/README.md) and GitHub Action have Xvfb pre-installed. To run browsers in headful mode with Xvfb, add `xvfb-run` before the Node.js command.
+On Linux agents, headful execution requires [Xvfb](https://en.wikipedia.org/wiki/Xvfb) to be installed. Our [Docker image](./docker.md) and GitHub Action have Xvfb pre-installed. To run browsers in headful mode with Xvfb, add `xvfb-run` before the Node.js command.
 
 ```
 xvfb-run node index.js
 ```
 
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/cli.md b/docs/out/cli.md
similarity index 98%
rename from docs/cli.md
rename to docs/out/cli.md
index fdf8ff7a52..62f0333a38 100644
--- a/docs/cli.md
+++ b/docs/out/cli.md
@@ -37,7 +37,7 @@ $ npx playwright codegen wikipedia.org
 
 Run `codegen` and perform actions in the browser. Playwright CLI will generate JavaScript code for the user interactions. `codegen` will attempt to generate resilient text-based selectors.
 
-<img src="https://user-images.githubusercontent.com/284612/92536033-7e7ebe00-f1ed-11ea-9e1a-7cbd912e3391.gif">
+<img src="https://user-images.githubusercontent.com/284612/92536033-7e7ebe00-f1ed-11ea-9e1a-7cbd912e3391.gif"></img>
 
 ## Open pages
 
@@ -81,7 +81,7 @@ npx playwright --timezone="Europe/Rome" --geolocation="41.890221,12.492348" --la
 
 During `open` or `codegen`, you can use following API inside the developer tools console of any browser.
 
-<img src="https://user-images.githubusercontent.com/284612/92536317-37dd9380-f1ee-11ea-875d-daf1b206dd56.png">
+<img src="https://user-images.githubusercontent.com/284612/92536317-37dd9380-f1ee-11ea-875d-daf1b206dd56.png"></img>
 
 #### playwright.$(selector)
 
@@ -155,6 +155,7 @@ $ npx playwright pdf https://en.wikipedia.org/wiki/PDF wiki.pdf
 ## Known limitations
 
 Opening WebKit Web Inspector will disconnect Playwright from the browser. In such cases, code generation will stop.
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/core-concepts.md b/docs/out/core-concepts.md
similarity index 99%
rename from docs/core-concepts.md
rename to docs/out/core-concepts.md
index 24fa7b078f..599883cccb 100644
--- a/docs/core-concepts.md
+++ b/docs/out/core-concepts.md
@@ -376,6 +376,7 @@ await myArrayHandle.dispose();
 - [page.$(selector)](api/class-page.md#pageselector)
 - [page.$$(selector)](api/class-page.md#pageselector-1)
 - [jsHandle.evaluate(pageFunction[, arg])](api/class-jshandle.md#jshandleevaluatepagefunction-arg)
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/debug.md b/docs/out/debug.md
similarity index 99%
rename from docs/debug.md
rename to docs/out/debug.md
index 473fab343d..579616f6e7 100644
--- a/docs/debug.md
+++ b/docs/out/debug.md
@@ -44,7 +44,7 @@ You can use browser developer tools in Chromium, Firefox and WebKit while runnin
 * **See console logs** during execution (or learn how to [read logs via API](./verification.md#console-logs))
 * Check **network activity** and other developer tools features
 
-<a href="https://user-images.githubusercontent.com/284612/77234134-5f21a500-6b69-11ea-92ec-1c146e1333ec.png"><img src="https://user-images.githubusercontent.com/284612/77234134-5f21a500-6b69-11ea-92ec-1c146e1333ec.png" width="500" alt="Chromium Developer Tools"></a>
+<a href="https://user-images.githubusercontent.com/284612/77234134-5f21a500-6b69-11ea-92ec-1c146e1333ec.png"><img src="https://user-images.githubusercontent.com/284612/77234134-5f21a500-6b69-11ea-92ec-1c146e1333ec.png" width="500" alt="Chromium Developer Tools"></img></a>
 
 > **For WebKit**: Note that launching WebKit Inspector during the execution will prevent the Playwright script from executing any further.
 
@@ -87,13 +87,13 @@ PWDEBUG configures a `playwright` object in the browser to highlight [Playwright
    * `playwright.inspect(selector)`: Inspect the selector in the Elements panel.
    * `playwright.clear()`: Clear existing highlights.
 
-<a href="https://user-images.githubusercontent.com/284612/86857345-299abc00-c073-11ea-9e31-02923a9f0d4b.png"><img src="https://user-images.githubusercontent.com/284612/86857345-299abc00-c073-11ea-9e31-02923a9f0d4b.png" width="500" alt="Highlight selectors"></a>
+<a href="https://user-images.githubusercontent.com/284612/86857345-299abc00-c073-11ea-9e31-02923a9f0d4b.png"><img src="https://user-images.githubusercontent.com/284612/86857345-299abc00-c073-11ea-9e31-02923a9f0d4b.png" width="500" alt="Highlight selectors"></img></a>
 
 ### Evaluate Source Maps
 
 PWDEBUG also enables source maps for [`page.evaluate` executions](core-concepts.md#evaluation). This improves the debugging experience for JavaScript executions in the page context.
 
-<a href="https://user-images.githubusercontent.com/284612/86857568-a6c63100-c073-11ea-82a4-bfd531a4ec87.png"><img src="https://user-images.githubusercontent.com/284612/86857568-a6c63100-c073-11ea-82a4-bfd531a4ec87.png" width="500" alt="Highlight selectors"></a>
+<a href="https://user-images.githubusercontent.com/284612/86857568-a6c63100-c073-11ea-82a4-bfd531a4ec87.png"><img src="https://user-images.githubusercontent.com/284612/86857568-a6c63100-c073-11ea-82a4-bfd531a4ec87.png" width="500" alt="Highlight selectors"></img></a>
 
 ## Verbose API logs
 
@@ -108,6 +108,7 @@ $ set DEBUG=pw:api
 $ npm run test
 ```
 
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/out/docker.md b/docs/out/docker.md
new file mode 100644
index 0000000000..a34bc0e749
--- /dev/null
+++ b/docs/out/docker.md
@@ -0,0 +1,169 @@
+---
+id: docker
+title: "Docker"
+---
+
+[Dockerfile.bionic](https://github.com/microsoft/playwright/blob/master/utils/docker/Dockerfile.bionic) and [Dockerfile.focal](https://github.com/microsoft/playwright/blob/master/utils/docker/Dockerfile.focal) can be used to run Playwright scripts in Docker environments. These images includes all the dependencies needed to run browsers in a Docker container, including browsers.
+
+- [Usage](#usage)
+- [Image tags](#image-tags)
+- [Development](#development)
+- [Base images](#base-images)
+
+## Usage
+
+[![docker hub](https://img.shields.io/badge/docker-mcr.microsoft.com%2Fplaywright-blue)](https://hub.docker.com/_/microsoft-playwright)
+
+This image is published on [Docker Hub](https://hub.docker.com/_/microsoft-playwright).
+
+### Pull the image
+
+```
+$ docker pull mcr.microsoft.com/playwright:bionic
+```
+
+### Run the image
+
+By default, the Docker image will use the `root` user to run the browsers. This will disable the Chromium sandbox which is not available with root. If you run trusted code (e.g. End-to-end tests) and want to avoid the hassle of managing separate user then the root user may be fine. For web scraping or crawling, we recommend to create a separate user inside the Docker container and use the seccomp profile.
+
+#### End-to-end tests
+
+On trusted websites, you can avoid creating a separate user and use root for it since you trust the code which will run on the browsers.
+
+```
+docker run -it --rm --ipc=host mcr.microsoft.com/playwright:bionic /bin/bash
+```
+
+#### Crawling and scraping
+
+On untrusted websites, it's recommended to use a separate user for launching the browsers in combination with the seccomp profile. Inside the container or if you are using the Docker image as a base image you have to use `adduser` for it.
+
+```
+$ docker run -it --rm --ipc=host --user pwuser --security-opt seccomp=seccomp_profile.json mcr.microsoft.com/playwright:bionic /bin/bash
+```
+
+[`seccomp_profile.json`](https://github.com/microsoft/playwright/blob/master/utils/docker/seccomp_profile.json) is needed to run Chromium with sandbox. This is a [default Docker seccomp profile](https://github.com/docker/engine/blob/d0d99b04cf6e00ed3fc27e81fc3d94e7eda70af3/profiles/seccomp/default.json) with extra user namespace cloning permissions:
+
+```json
+[
+  {
+    "comment": "Allow create user namespaces",
+    "names": [
+      "clone",
+      "setns",
+      "unshare"
+    ],
+    "action": "SCMP_ACT_ALLOW",
+    "args": [],
+    "includes": {},
+    "excludes": {}
+  }
+]
+```
+
+> **NOTE**: Using `--ipc=host` is recommended when using Chrome ([Docker docs](https://docs.docker.com/engine/reference/run/#ipc-settings---ipc)). Chrome can run out of memory without this flag.
+
+### Using on CI
+
+See our [Continuous Integration guides](./ci.md) for sample configs.
+
+## Image tags
+
+See [all available image tags](https://mcr.microsoft.com/v2/playwright/tags/list).
+
+## Development
+
+### Build the image
+
+Use [`//utils/docker/build.sh`](https://github.com/microsoft/playwright/blob/master/utils/docker/build.sh) to build the image.
+
+```
+$ ./utils/docker/build.sh bionic playwright:localbuild-bionic
+```
+
+The image will be tagged as `playwright:localbuild-bionic` and could be run as:
+
+```
+$ docker run --rm -it playwright:localbuild /bin/bash
+```
+
+### Push
+
+Docker images are published automatically by GitHub Actions. We currently publish the following images:
+- `mcr.microsoft.com/playwright:next` - tip-of-tree image version.
+- `mcr.microsoft.com/playwright:bionic` - last Playwright release docker image.
+- `mcr.microsoft.com/playwright:sha-XXXXXXX` - docker image for every commit that changed docker files or browsers, marked with a [short sha](https://git-scm.com/book/en/v2/Git-Tools-Revision-Selection#Short-SHA-1) (first 7 digits of the SHA commit).
+
+Status of push to MCR can be [verified here](https://mcrflow-status-ui.azurewebsites.net/) (internal link).
+
+## Base images
+
+### Ubuntu 20
+
+`mcr.microsoft.com/playwright:focal` is based on Ubuntu 20.04 LTS (Focal Fossa).
+
+### Ubuntu 18
+
+`mcr.microsoft.com/playwright:bionic` is based on Ubuntu 18.04 LTS (Bionic Beaver).
+
+### Alpine
+
+Browser builds for Firefox and WebKit are built for the [glibc](https://en.wikipedia.org/wiki/GNU_C_Library) library. Alpine Linux and other distributions that are based on the [musl](https://en.wikipedia.org/wiki/Musl) standard library are not supported.
+
+[Playwright]: api/class-playwright.md "Playwright"
+[Browser]: api/class-browser.md "Browser"
+[BrowserContext]: api/class-browsercontext.md "BrowserContext"
+[Page]: api/class-page.md "Page"
+[Frame]: api/class-frame.md "Frame"
+[ElementHandle]: api/class-elementhandle.md "ElementHandle"
+[JSHandle]: api/class-jshandle.md "JSHandle"
+[ConsoleMessage]: api/class-consolemessage.md "ConsoleMessage"
+[Dialog]: api/class-dialog.md "Dialog"
+[Download]: api/class-download.md "Download"
+[Video]: api/class-video.md "Video"
+[FileChooser]: api/class-filechooser.md "FileChooser"
+[Keyboard]: api/class-keyboard.md "Keyboard"
+[Mouse]: api/class-mouse.md "Mouse"
+[Touchscreen]: api/class-touchscreen.md "Touchscreen"
+[Request]: api/class-request.md "Request"
+[Response]: api/class-response.md "Response"
+[Selectors]: api/class-selectors.md "Selectors"
+[Route]: api/class-route.md "Route"
+[WebSocket]: api/class-websocket.md "WebSocket"
+[TimeoutError]: api/class-timeouterror.md "TimeoutError"
+[Accessibility]: api/class-accessibility.md "Accessibility"
+[Worker]: api/class-worker.md "Worker"
+[BrowserServer]: api/class-browserserver.md "BrowserServer"
+[BrowserType]: api/class-browsertype.md "BrowserType"
+[Logger]: api/class-logger.md "Logger"
+[ChromiumBrowser]: api/class-chromiumbrowser.md "ChromiumBrowser"
+[ChromiumBrowserContext]: api/class-chromiumbrowsercontext.md "ChromiumBrowserContext"
+[ChromiumCoverage]: api/class-chromiumcoverage.md "ChromiumCoverage"
+[CDPSession]: api/class-cdpsession.md "CDPSession"
+[FirefoxBrowser]: api/class-firefoxbrowser.md "FirefoxBrowser"
+[WebKitBrowser]: api/class-webkitbrowser.md "WebKitBrowser"
+[Array]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Array "Array"
+[Buffer]: https://nodejs.org/api/buffer.html#buffer_class_buffer "Buffer"
+[ChildProcess]: https://nodejs.org/api/child_process.html "ChildProcess"
+[Element]: https://developer.mozilla.org/en-US/docs/Web/API/element "Element"
+[Error]: https://nodejs.org/api/errors.html#errors_class_error "Error"
+[Evaluation Argument]: ./core-concepts.md#evaluationargument "Evaluation Argument"
+[Map]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Map "Map"
+[Object]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Object "Object"
+[Promise]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Promise "Promise"
+[RegExp]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/RegExp "RegExp"
+[Serializable]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/JSON/stringify#Description "Serializable"
+[UIEvent.detail]: https://developer.mozilla.org/en-US/docs/Web/API/UIEvent/detail "UIEvent.detail"
+[URL]: https://nodejs.org/api/url.html "URL"
+[USKeyboardLayout]: ../src/usKeyboardLayout.ts "USKeyboardLayout"
+[UnixTime]: https://en.wikipedia.org/wiki/Unix_time "Unix Time"
+[boolean]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Boolean_type "Boolean"
+[function]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/Function "Function"
+[iterator]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Iteration_protocols "Iterator"
+[null]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Reference/Global_Objects/null "null"
+[number]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#Number_type "Number"
+[origin]: https://developer.mozilla.org/en-US/docs/Glossary/Origin "Origin"
+[selector]: https://developer.mozilla.org/en-US/docs/Web/CSS/CSS_Selectors "selector"
+[Readable]: https://nodejs.org/api/stream.html#stream_class_stream_readable "Readable"
+[string]: https://developer.mozilla.org/en-US/docs/Web/JavaScript/Data_structures#String_type "string"
+[xpath]: https://developer.mozilla.org/en-US/docs/Web/XPath "xpath"
diff --git a/docs/emulation.md b/docs/out/emulation.md
similarity index 99%
rename from docs/emulation.md
rename to docs/out/emulation.md
index b246d0b9f5..53d73e787e 100644
--- a/docs/emulation.md
+++ b/docs/out/emulation.md
@@ -182,6 +182,7 @@ await page.emulateMedia({ media: 'print' });
 #### API reference
 - [browser.newContext([options])](api/class-browser.md#browsernewcontextoptions)
 - [page.emulateMedia(params)](api/class-page.md#pageemulatemediaparams)
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/extensibility.md b/docs/out/extensibility.md
similarity index 99%
rename from docs/extensibility.md
rename to docs/out/extensibility.md
index 3121242856..ec7cdc422f 100644
--- a/docs/extensibility.md
+++ b/docs/out/extensibility.md
@@ -45,6 +45,7 @@ await page.click('tag=div >> span >> "Click me"');
 const buttonCount = await page.$$eval('tag=button', buttons => buttons.length);
 ```
 
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/input.md b/docs/out/input.md
similarity index 98%
rename from docs/input.md
rename to docs/out/input.md
index 2632eff16b..04e895b1bf 100644
--- a/docs/input.md
+++ b/docs/out/input.md
@@ -246,7 +246,7 @@ You can select input files for upload using the `page.setInputFiles` method. It
 
 #### Example
 
-[This script](examples/upload.js) uploads a file to an `input` element that accepts file uploads.
+[This script](https://github.com/microsoft/playwright/blob/master/utils/docs/examples/upload.js) uploads a file to an `input` element that accepts file uploads.
 
 #### API reference
 - [page.setInputFiles(selector, files[, options])](api/class-page.md#pagesetinputfilesselector-files-options)
@@ -269,6 +269,7 @@ await page.focus('input#name');
 - [elementHandle.focus()](api/class-elementhandle.md#elementhandlefocus)
 
 <br/>
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/installation.md b/docs/out/installation.md
similarity index 99%
rename from docs/installation.md
rename to docs/out/installation.md
index c1ee135ef1..0a2e389d40 100644
--- a/docs/installation.md
+++ b/docs/out/installation.md
@@ -63,12 +63,8 @@ $ npm i -D playwright
 
 Playwright keeps track of packages that need those browsers and will garbage collect them as you update Playwright to the newer versions.
 
-<br>
-
 > **NOTE** Developers can opt-in in this mode via exporting `PLAYWRIGHT_BROWSERS_PATH=$HOME/pw-browsers` in their `.bashrc`.
 
-<br>
-
 ## Download from artifact repository
 
 By default, Playwright downloads browsers from Microsoft and Google public CDNs.
@@ -91,8 +87,6 @@ It is also possible to use a per-browser download hosts using `PLAYWRIGHT_CHROMI
 $ PLAYWRIGHT_FIREFOX_DOWNLOAD_HOST=192.168.1.1 PLAYWRIGHT_DOWNLOAD_HOST=192.168.1.78 npm i -D playwright
 ```
 
-<br>
-
 ## Skip browser downloads
 
 In certain cases, it is desired to avoid browser downloads altogether because browser binaries are managed separately.
@@ -108,8 +102,6 @@ $ set PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD=1
 $ npm i -D playwright
 ```
 
-<br>
-
 ## Download single browser binary
 
 Playwright ships three packages that bundle only a single browser:
@@ -139,6 +131,7 @@ const { webkit } = require('playwright-webkit');
 })();
 ```
 
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/intro.md b/docs/out/intro.md
similarity index 98%
rename from docs/intro.md
rename to docs/out/intro.md
index b654cb68aa..bbcca0bf3f 100644
--- a/docs/intro.md
+++ b/docs/out/intro.md
@@ -108,7 +108,8 @@ Playwright requires Node.js version 10.17 or above. The browser binaries for Chr
 * **macOS**: Requires 10.14 or above.
 * **Linux**: Depending on your Linux distribution, you might need to install additional dependencies to run the browsers.
   * Firefox requires Ubuntu 18.04+
-  * For Ubuntu 18.04, the additional dependencies are defined in [our Docker image](docker/Dockerfile.bionic), which is based on Ubuntu.
+  * For Ubuntu 18.04, the additional dependencies are defined in [our Docker image](https://github.com/microsoft/playwright/blob/master/utils/docker/Dockerfile.bionic), which is based on Ubuntu.
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/languages.md b/docs/out/languages.md
similarity index 99%
rename from docs/languages.md
rename to docs/out/languages.md
index 939f0e1b93..6cf787a820 100644
--- a/docs/languages.md
+++ b/docs/out/languages.md
@@ -54,6 +54,7 @@ go get github.com/mxschmitt/playwright-go
 
 * [GitHub repo](https://github.com/mxschmitt/playwright-go)
 * [Documentation](https://pkg.go.dev/github.com/mxschmitt/playwright-go?tab=doc)
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/mobile.md b/docs/out/mobile.md
similarity index 99%
rename from docs/mobile.md
rename to docs/out/mobile.md
index ce92f598c7..a37021bced 100644
--- a/docs/mobile.md
+++ b/docs/out/mobile.md
@@ -42,6 +42,7 @@ const { _clank } = require('playwright');
 - Passing `viewport: null` is necessary to make sure resolution is not emulated.
 - Device needs to be awake to produce screenshots. Enabling "Stay awake" developer mode will help.
 - We didn't run all the tests against the device, so not everything works.
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/multi-pages.md b/docs/out/multi-pages.md
similarity index 99%
rename from docs/multi-pages.md
rename to docs/out/multi-pages.md
index 795d4c9ee7..4b04e37cdd 100644
--- a/docs/multi-pages.md
+++ b/docs/out/multi-pages.md
@@ -109,6 +109,7 @@ page.on('popup', async popup => {
 
 #### API reference
 - [page.on('popup')](api/class-page.md#pageonpopup)
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/navigations.md b/docs/out/navigations.md
similarity index 99%
rename from docs/navigations.md
rename to docs/out/navigations.md
index 5b220ef725..afae215d2b 100644
--- a/docs/navigations.md
+++ b/docs/out/navigations.md
@@ -170,6 +170,7 @@ await page.screenshot();
 
 #### API reference
 - [page.waitForFunction(pageFunction[, arg, options])](api/class-page.md#pagewaitforfunctionpagefunction-arg-options)
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/network.md b/docs/out/network.md
similarity index 99%
rename from docs/network.md
rename to docs/out/network.md
index 844a528412..20efd22123 100644
--- a/docs/network.md
+++ b/docs/out/network.md
@@ -187,6 +187,7 @@ await page.route('**/*', route => {
 - [route.abort([errorCode])](api/class-route.md#routeaborterrorcode)
 
 <br/>
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/pom.md b/docs/out/pom.md
similarity index 99%
rename from docs/pom.md
rename to docs/out/pom.md
index c3f74b7fc7..ab2d0bf8b1 100644
--- a/docs/pom.md
+++ b/docs/out/pom.md
@@ -52,6 +52,7 @@ await searchPage.search('search query');
 
 ### API reference
 - [Page]
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/selectors.md b/docs/out/selectors.md
similarity index 99%
rename from docs/selectors.md
rename to docs/out/selectors.md
index 0ef4e0998c..6a8b57bdbf 100644
--- a/docs/selectors.md
+++ b/docs/out/selectors.md
@@ -350,6 +350,7 @@ Attribute engines are selecting based on the corresponding attribute value. For
 [text]: #text-and-textlight
 [xpath]: #xpath
 [id]: #id-data-testid-data-test-id-data-test-and-their-light-counterparts
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/showcase.md b/docs/out/showcase.md
similarity index 99%
rename from docs/showcase.md
rename to docs/out/showcase.md
index 04557e93e4..bfb34fd5c2 100644
--- a/docs/showcase.md
+++ b/docs/out/showcase.md
@@ -53,6 +53,7 @@ title: "Community Showcase"
 ## Contributing
 
 Did we miss something in this list? Send us a PR!
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/test-runners.md b/docs/out/test-runners.md
similarity index 99%
rename from docs/test-runners.md
rename to docs/out/test-runners.md
index df207636ba..e96f861443 100644
--- a/docs/test-runners.md
+++ b/docs/out/test-runners.md
@@ -38,8 +38,6 @@ it('should work', async () => {
 });
 ```
 
-<br>
-
 ## AVA
 
 Tests run concurrently in AVA, so a single page variable cannot be shared between tests. Instead, create new pages with a macro function.
@@ -65,8 +63,6 @@ test('should work', pageMacro, async (t, page) => {
 });
 ```
 
-<br>
-
 ## Mocha
 
 Mocha looks very similar to the Jest/Jasmine setup, and functions in the same way.
@@ -95,8 +91,6 @@ it('should work', async () => {
 });
 ```
 
-<br>
-
 ## Multiple Browsers
 
 These simple examples can be extended to support multiple browsers using an environment variable.
@@ -111,6 +105,7 @@ beforeAll(async() => {
 ```
 
 Then set `BROWSER=firefox` to run your tests with firefox, or any other browser.
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/troubleshooting.md b/docs/out/troubleshooting.md
similarity index 95%
rename from docs/troubleshooting.md
rename to docs/out/troubleshooting.md
index be55c81374..d285305e2c 100644
--- a/docs/troubleshooting.md
+++ b/docs/out/troubleshooting.md
@@ -12,7 +12,7 @@ title: "Troubleshooting"
 
 Playwright does self-inspection every time it runs to make sure the browsers can be launched successfully. If there are missing dependencies, playwright will print instructions to acquire them.
 
-We also provide [Ubuntu 18.04 dockerfile](docker/Dockerfile.bionic) and [Ubuntu 20.04 dockerfile](docker/Dockerfile.focal) with the list of Debian dependencies.
+We also provide [Ubuntu 18.04 dockerfile](https://github.com/microsoft/playwright/blob/master/utils/docker/Dockerfile.bionic) and [Ubuntu 20.04 dockerfile](https://github.com/microsoft/playwright/blob/master/utils/docker/Dockerfile.focal) with the list of Debian dependencies.
 
 ## Code transpilation issues
 
@@ -35,6 +35,7 @@ Playwright requires Node.js 10 or higher. Node.js 8 is not supported, and will c
 # Please file an issue
 
 Playwright is a new project, and we are watching the issues very closely. As we solve common issues, this document will grow to include the common answers.
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/verification.md b/docs/out/verification.md
similarity index 99%
rename from docs/verification.md
rename to docs/out/verification.md
index d8f61d7237..768ced6311 100644
--- a/docs/verification.md
+++ b/docs/out/verification.md
@@ -150,6 +150,7 @@ const [popup] = await Promise.all([
 - [page.on('requestfailed')](api/class-page.md#pageonrequestfailed)
 - [page.on('dialog')](api/class-page.md#pageondialog)
 - [page.on('popup')](api/class-page.md#pageonpopup)
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs/why-playwright.md b/docs/out/why-playwright.md
similarity index 97%
rename from docs/why-playwright.md
rename to docs/out/why-playwright.md
index 0dd3ea4257..0b0d8af02a 100644
--- a/docs/why-playwright.md
+++ b/docs/out/why-playwright.md
@@ -34,12 +34,13 @@ Playwright enables fast, reliable and capable automation across all modern brows
 * **TypeScript support**. Playwright ships with built-in types for auto-completion and other benefits.
 * **Debugging tools**. Playwright works with the [editor debugger and browser developer tools](./debug.md) to pause execution and inspect the web page.
 * **Language bindings**. Playwright is also available in [Python](https://github.com/microsoft/playwright-python) and [C#](https://github.com/microsoft/playwright-sharp). Learn about [supported languages](./languages.md).
-* **Deploy tests to CI**. First-party [Docker image](docker/README.md) and [GitHub Actions](https://github.com/microsoft/playwright-github-action) to deploy tests to [your preferred CI/CD provider](./ci.md).
+* **Deploy tests to CI**. First-party [Docker image](./docker.md) and [GitHub Actions](https://github.com/microsoft/playwright-github-action) to deploy tests to [your preferred CI/CD provider](./ci.md).
 
 ## Limitations
 * **Legacy Edge and IE11 support**. Playwright does not support legacy Microsoft Edge or IE11 ([deprecation notice](https://techcommunity.microsoft.com/t5/microsoft-365-blog/microsoft-365-apps-say-farewell-to-internet-explorer-11-and/ba-p/1591666)). The new Microsoft Edge (on Chromium) is supported.
 * **Java language bindings**: The Playwright API cannot be used in Java or Ruby today. This is a temporary limitation as Playwright is built to support bindings for any language.
 * **Test on real mobile devices**: Playwright uses desktop browsers to emulate mobile devices. If you are interested in running on real mobile devices, please [upvote this issue](https://github.com/microsoft/playwright/issues/1122).
+
 [Playwright]: api/class-playwright.md "Playwright"
 [Browser]: api/class-browser.md "Browser"
 [BrowserContext]: api/class-browsercontext.md "BrowserContext"
diff --git a/docs-src/README.md b/docs/src/README.md
similarity index 96%
rename from docs-src/README.md
rename to docs/src/README.md
index e6273e14bd..9d57c5aea9 100644
--- a/docs-src/README.md
+++ b/docs/src/README.md
@@ -40,10 +40,10 @@ Playwright is a library to automate [Chromium](https://www.chromium.org/Home), [
     - [Page object models](./pom.md)
 1. Integrations
     - [Test runners](./test-runners.md)
-    - [Docker](./docker/README.md)
+    - [Docker](././docker.md)
     - [Continuous integration](./ci.md)
 1. Reference
-    - [API Reference](./api.md)
+    - [API Reference](./api/class-playwright.md)
     - [Actionability](./actionability.md)
     - [Advanced installation](./installation.md)
     - [Extensibility](./extensibility.md)
diff --git a/docs-src/actionability.md b/docs/src/actionability.md
similarity index 79%
rename from docs-src/actionability.md
rename to docs/src/actionability.md
index d20b7f6c34..5d55e5fda2 100644
--- a/docs-src/actionability.md
+++ b/docs/src/actionability.md
@@ -11,13 +11,13 @@ Some actions like `page.click()` support `{force: true}` option that disable non
 
 | Actions | Performed checks |
 | ------ | ------- |
-| `check()`<br>`click()`<br>`dblclick()`<br>`tap()`<br>`uncheck()` | [Visible]<br>[Stable]<br>[Enabled]<br>[Receiving Events]<br>[Attached] |
-| `hover()` | [Visible]<br>[Stable]<br>[Receiving Events]<br>[Attached] |
-| `fill()` | [Visible]<br>[Enabled]<br>[Editable]<br>[Attached] |
-| `dispatchEvent()`<br>`focus()`<br>`press()`<br>`setInputFiles()`<br>`selectOption()`<br>`type()` | [Attached] |
-| `scrollIntoViewIfNeeded()`<br>`screenshot()` | [Visible]<br>[Stable]<br>[Attached] |
-| `selectText()` | [Visible]<br>[Attached] |
-| `getAttribute()`<br>`innerText()`<br>`innerHTML()`<br>`textContent()` | [Attached] |
+| `check()`<br></br>`click()`<br></br>`dblclick()`<br></br>`tap()`<br></br>`uncheck()` | [Visible]<br></br>[Stable]<br></br>[Enabled]<br></br>[Receiving Events]<br></br>[Attached] |
+| `hover()` | [Visible]<br></br>[Stable]<br></br>[Receiving Events]<br></br>[Attached] |
+| `fill()` | [Visible]<br></br>[Enabled]<br></br>[Editable]<br></br>[Attached] |
+| `dispatchEvent()`<br></br>`focus()`<br></br>`press()`<br></br>`setInputFiles()`<br></br>`selectOption()`<br></br>`type()` | [Attached] |
+| `scrollIntoViewIfNeeded()`<br></br>`screenshot()` | [Visible]<br></br>[Stable]<br></br>[Attached] |
+| `selectText()` | [Visible]<br></br>[Attached] |
+| `getAttribute()`<br></br>`innerText()`<br></br>`innerHTML()`<br></br>`textContent()` | [Attached] |
 
 ### Visible
 
diff --git a/docs-src/api-body.md b/docs/src/api-body.md
similarity index 100%
rename from docs-src/api-body.md
rename to docs/src/api-body.md
diff --git a/docs-src/api-params.md b/docs/src/api-params.md
similarity index 100%
rename from docs-src/api-params.md
rename to docs/src/api-params.md
diff --git a/docs-src/assertions.md b/docs/src/assertions.md
similarity index 100%
rename from docs-src/assertions.md
rename to docs/src/assertions.md
diff --git a/docs-src/auth.md b/docs/src/auth.md
similarity index 100%
rename from docs-src/auth.md
rename to docs/src/auth.md
diff --git a/docs-src/ci.md b/docs/src/ci.md
similarity index 90%
rename from docs-src/ci.md
rename to docs/src/ci.md
index 436fdf24dc..10e07a4513 100644
--- a/docs-src/ci.md
+++ b/docs/src/ci.md
@@ -12,7 +12,7 @@ configurations for common CI providers.
 
 3 steps to get your tests running on CI:
 
-1. **Ensure CI agent can run browsers**: Use [our Docker image](docker/README.md)
+1. **Ensure CI agent can run browsers**: Use [our Docker image](./docker.md)
    in Linux agents. Windows and macOS agents do not require any additional dependencies.
 1. **Install Playwright**: In most projects, this would be done with `npm ci`
    (or `npm install`). Playwright would install the relevant browsers automatically.
@@ -35,7 +35,7 @@ We run [our tests](/.github/workflows/tests.yml) on GitHub Actions, across a mat
 
 ### Docker
 
-We have a [pre-built Docker image](docker/README.md) which can either be used directly, or as a reference to update your existing Docker definitions.
+We have a [pre-built Docker image](./docker.md) which can either be used directly, or as a reference to update your existing Docker definitions.
 
 Suggested configuration
 1. By default, Docker runs a container with a `/dev/shm` shared memory space 64MB.
@@ -65,7 +65,7 @@ Suggested configuration
 
 For Windows or macOS agents, no additional configuration required, just install Playwright and run your tests.
 
-For Linux agents, you can use [our Docker container](docker/README.md) with Azure Pipelines support for [running containerized jobs](https://docs.microsoft.com/en-us/azure/devops/pipelines/process/container-phases?view=azure-devops). Alternatively, you can refer to the [Dockerfile](docker/README.md) to see additional dependencies that need to be installed on a Ubuntu agent.
+For Linux agents, you can use [our Docker container](./docker.md) with Azure Pipelines support for [running containerized jobs](https://docs.microsoft.com/en-us/azure/devops/pipelines/process/container-phases?view=azure-devops). Alternatively, you can refer to the [Dockerfile](./docker.md) to see additional dependencies that need to be installed on a Ubuntu agent.
 
 ```yml
 pool:
@@ -136,9 +136,9 @@ before_install:
 
 ### CircleCI
 
-We run our tests on CircleCI, with our [pre-built Docker image](docker/README.md). Running Playwright smoothly on CircleCI requires the following steps:
+We run our tests on CircleCI, with our [pre-built Docker image](./docker.md). Running Playwright smoothly on CircleCI requires the following steps:
 
-1. Use the pre-built [Docker image](docker/README.md) in your config like so:
+1. Use the pre-built [Docker image](./docker.md) in your config like so:
 
    ```yaml
    docker:
@@ -159,7 +159,7 @@ We run our tests on CircleCI, with our [pre-built Docker image](docker/README.md
 
 ### Jenkins
 
-Jenkins supports Docker agents for pipelines. Use the [Playwright Docker image](docker/README.md)
+Jenkins supports Docker agents for pipelines. Use the [Playwright Docker image](./docker.md)
 to run tests on Jenkins.
 
 ```groovy
@@ -178,7 +178,7 @@ pipeline {
 
 ### Bitbucket Pipelines
 
-Bitbucket Pipelines can use public [Docker images as build environments](https://confluence.atlassian.com/bitbucket/use-docker-images-as-build-environments-792298897.html). To run Playwright tests on Bitbucket, use our public Docker image ([see Dockerfile](docker/README.md)).
+Bitbucket Pipelines can use public [Docker images as build environments](https://confluence.atlassian.com/bitbucket/use-docker-images-as-build-environments-792298897.html). To run Playwright tests on Bitbucket, use our public Docker image ([see Dockerfile](./docker.md)).
 
 ```yml
 image: mcr.microsoft.com/playwright:bionic
@@ -193,7 +193,7 @@ const browser = await chromium.launch({ chromiumSandbox: false });
 
 ### GitLab CI
 
-To run Playwright tests on GitLab, use our public Docker image ([see Dockerfile](docker/README.md)).
+To run Playwright tests on GitLab, use our public Docker image ([see Dockerfile](./docker.md)).
 
 ```yml
 stages:
@@ -267,7 +267,7 @@ const { chromium } = require('playwright');
 const browser = await chromium.launch({ headless: false });
 ```
 
-On Linux agents, headful execution requires [Xvfb](https://en.wikipedia.org/wiki/Xvfb) to be installed. Our [Docker image](docker/README.md) and GitHub Action have Xvfb pre-installed. To run browsers in headful mode with Xvfb, add `xvfb-run` before the Node.js command.
+On Linux agents, headful execution requires [Xvfb](https://en.wikipedia.org/wiki/Xvfb) to be installed. Our [Docker image](./docker.md) and GitHub Action have Xvfb pre-installed. To run browsers in headful mode with Xvfb, add `xvfb-run` before the Node.js command.
 
 ```
 xvfb-run node index.js
diff --git a/docs-src/cli.md b/docs/src/cli.md
similarity index 96%
rename from docs-src/cli.md
rename to docs/src/cli.md
index bc02374335..7fca00b0ea 100644
--- a/docs-src/cli.md
+++ b/docs/src/cli.md
@@ -30,7 +30,7 @@ $ npx playwright codegen wikipedia.org
 
 Run `codegen` and perform actions in the browser. Playwright CLI will generate JavaScript code for the user interactions. `codegen` will attempt to generate resilient text-based selectors.
 
-<img src="https://user-images.githubusercontent.com/284612/92536033-7e7ebe00-f1ed-11ea-9e1a-7cbd912e3391.gif">
+<img src="https://user-images.githubusercontent.com/284612/92536033-7e7ebe00-f1ed-11ea-9e1a-7cbd912e3391.gif"></img>
 
 ## Open pages
 
@@ -70,7 +70,7 @@ npx playwright --timezone="Europe/Rome" --geolocation="41.890221,12.492348" --la
 ## Inspect selectors
 During `open` or `codegen`, you can use following API inside the developer tools console of any browser.
 
-<img src="https://user-images.githubusercontent.com/284612/92536317-37dd9380-f1ee-11ea-875d-daf1b206dd56.png">
+<img src="https://user-images.githubusercontent.com/284612/92536317-37dd9380-f1ee-11ea-875d-daf1b206dd56.png"></img>
 
 #### playwright.$(selector)
 
diff --git a/docs-src/core-concepts.md b/docs/src/core-concepts.md
similarity index 100%
rename from docs-src/core-concepts.md
rename to docs/src/core-concepts.md
diff --git a/docs-src/debug.md b/docs/src/debug.md
similarity index 99%
rename from docs-src/debug.md
rename to docs/src/debug.md
index 9e900e6aa8..4987d571f5 100644
--- a/docs-src/debug.md
+++ b/docs/src/debug.md
@@ -53,7 +53,7 @@ a Playwright script. Developer tools help to:
 * **See console logs** during execution (or learn how to [read logs via API](./verification.md#console-logs))
 * Check **network activity** and other developer tools features
 
-<a href="https://user-images.githubusercontent.com/284612/77234134-5f21a500-6b69-11ea-92ec-1c146e1333ec.png"><img src="https://user-images.githubusercontent.com/284612/77234134-5f21a500-6b69-11ea-92ec-1c146e1333ec.png" width="500" alt="Chromium Developer Tools"></a>
+<a href="https://user-images.githubusercontent.com/284612/77234134-5f21a500-6b69-11ea-92ec-1c146e1333ec.png"><img src="https://user-images.githubusercontent.com/284612/77234134-5f21a500-6b69-11ea-92ec-1c146e1333ec.png" width="500" alt="Chromium Developer Tools"></img></a>
 
 > **For WebKit**: Note that launching WebKit Inspector during the execution will
   prevent the Playwright script from executing any further.
@@ -105,14 +105,14 @@ composite selectors. To use this:
     * `playwright.inspect(selector)`: Inspect the selector in the Elements panel.
     * `playwright.clear()`: Clear existing highlights.
 
-<a href="https://user-images.githubusercontent.com/284612/86857345-299abc00-c073-11ea-9e31-02923a9f0d4b.png"><img src="https://user-images.githubusercontent.com/284612/86857345-299abc00-c073-11ea-9e31-02923a9f0d4b.png" width="500" alt="Highlight selectors"></a>
+<a href="https://user-images.githubusercontent.com/284612/86857345-299abc00-c073-11ea-9e31-02923a9f0d4b.png"><img src="https://user-images.githubusercontent.com/284612/86857345-299abc00-c073-11ea-9e31-02923a9f0d4b.png" width="500" alt="Highlight selectors"></img></a>
 
 ### Evaluate Source Maps
 
 PWDEBUG also enables source maps for [`page.evaluate` executions](core-concepts.md#evaluation).
 This improves the debugging experience for JavaScript executions in the page context.
 
-<a href="https://user-images.githubusercontent.com/284612/86857568-a6c63100-c073-11ea-82a4-bfd531a4ec87.png"><img src="https://user-images.githubusercontent.com/284612/86857568-a6c63100-c073-11ea-82a4-bfd531a4ec87.png" width="500" alt="Highlight selectors"></a>
+<a href="https://user-images.githubusercontent.com/284612/86857568-a6c63100-c073-11ea-82a4-bfd531a4ec87.png"><img src="https://user-images.githubusercontent.com/284612/86857568-a6c63100-c073-11ea-82a4-bfd531a4ec87.png" width="500" alt="Highlight selectors"></img></a>
 
 ## Verbose API logs
 
diff --git a/docs/docker/README.md b/docs/src/docker.md
similarity index 72%
rename from docs/docker/README.md
rename to docs/src/docker.md
index e5e327eadf..92410a6821 100644
--- a/docs/docker/README.md
+++ b/docs/src/docker.md
@@ -1,21 +1,11 @@
-# Running Playwright in Docker
+---
+id: docker
+title: "Docker"
+---
 
-[Dockerfile.bionic](Dockerfile.bionic) and [Dockerfile.focal](Dockerfile.focal) can be used to run Playwright scripts in Docker environments. These images includes all the dependencies needed to run browsers in a Docker container, including browsers.
+[Dockerfile.bionic](https://github.com/microsoft/playwright/blob/master/utils/docker/Dockerfile.bionic) and [Dockerfile.focal](https://github.com/microsoft/playwright/blob/master/utils/docker/Dockerfile.focal) can be used to run Playwright scripts in Docker environments. These images includes all the dependencies needed to run browsers in a Docker container, including browsers.
 
-- [Usage](#usage)
-  * [Pull the image](#pull-the-image)
-  * [Run the image](#run-the-image)
-    - [End-to-end tests](#end-to-end-tests)
-    - [Crawling and scraping](#crawling-and-scraping)
-  * [Using on CI](#using-on-ci)
-- [Image tags](#image-tags)
-- [Development](#development)
-  * [Build the image](#build-the-image)
-  * [Push](#push)
-- [Base images](#base-images)
-  * [Ubuntu 20](#ubuntu-20)
-  * [Ubuntu 18](#ubuntu-18)
-  * [Alpine](#alpine)
+<!-- TOC -->
 
 ## Usage
 
@@ -49,8 +39,7 @@ On untrusted websites, it's recommended to use a separate user for launching the
 $ docker run -it --rm --ipc=host --user pwuser --security-opt seccomp=seccomp_profile.json mcr.microsoft.com/playwright:bionic /bin/bash
 ```
 
-[`seccomp_profile.json`](seccomp_profile.json) is needed to run Chromium with sandbox. This is
-a [default Docker seccomp profile](https://github.com/docker/engine/blob/d0d99b04cf6e00ed3fc27e81fc3d94e7eda70af3/profiles/seccomp/default.json) with extra user namespace cloning permissions:
+[`seccomp_profile.json`](https://github.com/microsoft/playwright/blob/master/utils/docker/seccomp_profile.json) is needed to run Chromium with sandbox. This is a [default Docker seccomp profile](https://github.com/docker/engine/blob/d0d99b04cf6e00ed3fc27e81fc3d94e7eda70af3/profiles/seccomp/default.json) with extra user namespace cloning permissions:
 
 ```json
 [
@@ -74,7 +63,7 @@ a [default Docker seccomp profile](https://github.com/docker/engine/blob/d0d99b0
 
 ### Using on CI
 
-See our [Continuous Integration guides](../ci.md) for sample configs.
+See our [Continuous Integration guides](./ci.md) for sample configs.
 
 ## Image tags
 
@@ -84,10 +73,10 @@ See [all available image tags](https://mcr.microsoft.com/v2/playwright/tags/list
 
 ### Build the image
 
-Use [`//docs/docker/build.sh`](build.sh) to build the image.
+Use [`//utils/docker/build.sh`](https://github.com/microsoft/playwright/blob/master/utils/docker/build.sh) to build the image.
 
 ```
-$ ./docs/docker/build.sh bionic playwright:localbuild-bionic
+$ ./utils/docker/build.sh bionic playwright:localbuild-bionic
 ```
 
 The image will be tagged as `playwright:localbuild-bionic` and could be run as:
diff --git a/docs-src/emulation.md b/docs/src/emulation.md
similarity index 100%
rename from docs-src/emulation.md
rename to docs/src/emulation.md
diff --git a/docs-src/extensibility.md b/docs/src/extensibility.md
similarity index 100%
rename from docs-src/extensibility.md
rename to docs/src/extensibility.md
diff --git a/docs-src/input.md b/docs/src/input.md
similarity index 98%
rename from docs-src/input.md
rename to docs/src/input.md
index fcfd6278ac..662cd347a6 100644
--- a/docs-src/input.md
+++ b/docs/src/input.md
@@ -251,7 +251,7 @@ You can select input files for upload using the `page.setInputFiles` method. It
 
 #### Example
 
-[This script](examples/upload.js) uploads a file to an `input` element that accepts file uploads.
+[This script](https://github.com/microsoft/playwright/blob/master/utils/docs/examples/upload.js) uploads a file to an `input` element that accepts file uploads.
 
 #### API reference
 
diff --git a/docs-src/installation.md b/docs/src/installation.md
similarity index 99%
rename from docs-src/installation.md
rename to docs/src/installation.md
index 1d647eb24a..eb63d6aa69 100644
--- a/docs-src/installation.md
+++ b/docs/src/installation.md
@@ -61,12 +61,8 @@ $ npm i -D playwright
 
 Playwright keeps track of packages that need those browsers and will garbage collect them as you update Playwright to the newer versions.
 
-<br>
-
 > **NOTE** Developers can opt-in in this mode via exporting `PLAYWRIGHT_BROWSERS_PATH=$HOME/pw-browsers` in their `.bashrc`.
 
-<br>
-
 ## Download from artifact repository
 
 By default, Playwright downloads browsers from Microsoft and Google public CDNs.
@@ -92,8 +88,6 @@ take precedence over `PLAYWRIGHT_DOWNLOAD_HOST`.
 $ PLAYWRIGHT_FIREFOX_DOWNLOAD_HOST=192.168.1.1 PLAYWRIGHT_DOWNLOAD_HOST=192.168.1.78 npm i -D playwright
 ```
 
-<br>
-
 ## Skip browser downloads
 
 In certain cases, it is desired to avoid browser downloads altogether because
@@ -110,8 +104,6 @@ $ set PLAYWRIGHT_SKIP_BROWSER_DOWNLOAD=1
 $ npm i -D playwright
 ```
 
-<br>
-
 ## Download single browser binary
 
 Playwright ships three packages that bundle only a single browser:
diff --git a/docs-src/intro.md b/docs/src/intro.md
similarity index 96%
rename from docs-src/intro.md
rename to docs/src/intro.md
index 7310bafeff..576ac55174 100644
--- a/docs-src/intro.md
+++ b/docs/src/intro.md
@@ -104,5 +104,5 @@ Firefox and WebKit work across the 3 platforms (Windows, macOS, Linux):
 * **Linux**: Depending on your Linux distribution, you might need to install additional
   dependencies to run the browsers.
   * Firefox requires Ubuntu 18.04+
-  * For Ubuntu 18.04, the additional dependencies are defined in [our Docker image](docker/Dockerfile.bionic),
+  * For Ubuntu 18.04, the additional dependencies are defined in [our Docker image](https://github.com/microsoft/playwright/blob/master/utils/docker/Dockerfile.bionic),
     which is based on Ubuntu.
diff --git a/docs-src/languages.md b/docs/src/languages.md
similarity index 100%
rename from docs-src/languages.md
rename to docs/src/languages.md
diff --git a/docs-src/links.md b/docs/src/links.md
similarity index 100%
rename from docs-src/links.md
rename to docs/src/links.md
diff --git a/docs-src/mobile.md b/docs/src/mobile.md
similarity index 100%
rename from docs-src/mobile.md
rename to docs/src/mobile.md
diff --git a/docs-src/multi-pages.md b/docs/src/multi-pages.md
similarity index 100%
rename from docs-src/multi-pages.md
rename to docs/src/multi-pages.md
diff --git a/docs-src/navigations.md b/docs/src/navigations.md
similarity index 100%
rename from docs-src/navigations.md
rename to docs/src/navigations.md
diff --git a/docs-src/network.md b/docs/src/network.md
similarity index 100%
rename from docs-src/network.md
rename to docs/src/network.md
diff --git a/docs-src/pom.md b/docs/src/pom.md
similarity index 100%
rename from docs-src/pom.md
rename to docs/src/pom.md
diff --git a/docs-src/selectors.md b/docs/src/selectors.md
similarity index 100%
rename from docs-src/selectors.md
rename to docs/src/selectors.md
diff --git a/docs-src/showcase.md b/docs/src/showcase.md
similarity index 100%
rename from docs-src/showcase.md
rename to docs/src/showcase.md
diff --git a/docs-src/test-runners.md b/docs/src/test-runners.md
similarity index 99%
rename from docs-src/test-runners.md
rename to docs/src/test-runners.md
index a1305e370c..54a60a9f66 100644
--- a/docs-src/test-runners.md
+++ b/docs/src/test-runners.md
@@ -35,8 +35,6 @@ it('should work', async () => {
 });
 ```
 
-<br>
-
 ## AVA
 
 Tests run concurrently in AVA, so a single page variable cannot be shared between tests. Instead, create new pages with a macro function.
@@ -62,8 +60,6 @@ test('should work', pageMacro, async (t, page) => {
 });
 ```
 
-<br>
-
 ## Mocha
 
 Mocha looks very similar to the Jest/Jasmine setup, and functions in the same way.
@@ -91,8 +87,6 @@ it('should work', async () => {
   assert.equal(await page.title(), 'Example Domain');
 });
 ```
-<br>
-
 ## Multiple Browsers
 
 These simple examples can be extended to support multiple browsers using an environment variable.
diff --git a/docs-src/troubleshooting.md b/docs/src/troubleshooting.md
similarity index 82%
rename from docs-src/troubleshooting.md
rename to docs/src/troubleshooting.md
index 025b948000..0a6360bedc 100644
--- a/docs-src/troubleshooting.md
+++ b/docs/src/troubleshooting.md
@@ -10,7 +10,7 @@ title: "Troubleshooting"
 Playwright does self-inspection every time it runs to make sure the browsers can be launched successfully. If there are missing
 dependencies, playwright will print instructions to acquire them.
 
-We also provide [Ubuntu 18.04 dockerfile](docker/Dockerfile.bionic) and [Ubuntu 20.04 dockerfile](docker/Dockerfile.focal) with the list of Debian dependencies.
+We also provide [Ubuntu 18.04 dockerfile](https://github.com/microsoft/playwright/blob/master/utils/docker/Dockerfile.bionic) and [Ubuntu 20.04 dockerfile](https://github.com/microsoft/playwright/blob/master/utils/docker/Dockerfile.focal) with the list of Debian dependencies.
 
 ## Code transpilation issues
 
diff --git a/docs-src/verification.md b/docs/src/verification.md
similarity index 100%
rename from docs-src/verification.md
rename to docs/src/verification.md
diff --git a/docs-src/why-playwright.md b/docs/src/why-playwright.md
similarity index 95%
rename from docs-src/why-playwright.md
rename to docs/src/why-playwright.md
index 26cb7dbbba..8748e18aa5 100644
--- a/docs-src/why-playwright.md
+++ b/docs/src/why-playwright.md
@@ -43,7 +43,7 @@ Playwright enables fast, reliable and capable automation across all modern brows
 
 * **Language bindings**. Playwright is also available in [Python](https://github.com/microsoft/playwright-python) and [C#](https://github.com/microsoft/playwright-sharp). Learn about [supported languages](./languages.md).
 
-* **Deploy tests to CI**. First-party [Docker image](docker/README.md) and [GitHub Actions](https://github.com/microsoft/playwright-github-action) to deploy tests to [your preferred CI/CD provider](./ci.md).
+* **Deploy tests to CI**. First-party [Docker image](./docker.md) and [GitHub Actions](https://github.com/microsoft/playwright-github-action) to deploy tests to [your preferred CI/CD provider](./ci.md).
 
 ## Limitations
 
diff --git a/docs/docker/Dockerfile.bionic b/utils/docker/Dockerfile.bionic
similarity index 100%
rename from docs/docker/Dockerfile.bionic
rename to utils/docker/Dockerfile.bionic
diff --git a/docs/docker/Dockerfile.focal b/utils/docker/Dockerfile.focal
similarity index 100%
rename from docs/docker/Dockerfile.focal
rename to utils/docker/Dockerfile.focal
diff --git a/docs/docker/build.sh b/utils/docker/build.sh
similarity index 100%
rename from docs/docker/build.sh
rename to utils/docker/build.sh
diff --git a/docs/docker/seccomp_profile.json b/utils/docker/seccomp_profile.json
similarity index 100%
rename from docs/docker/seccomp_profile.json
rename to utils/docker/seccomp_profile.json
diff --git a/docs/docker/tag_and_push.sh b/utils/docker/tag_and_push.sh
similarity index 100%
rename from docs/docker/tag_and_push.sh
rename to utils/docker/tag_and_push.sh
diff --git a/utils/doclint/cli.js b/utils/doclint/cli.js
index 00e8f0f745..a52cf1296b 100755
--- a/utils/doclint/cli.js
+++ b/utils/doclint/cli.js
@@ -40,7 +40,7 @@ run().catch(e => {
 });;
 
 async function run() {
-  const outline = new MDOutline(path.join(PROJECT_DIR, 'docs-src', 'api-body.md'), path.join(PROJECT_DIR, 'docs-src', 'api-params.md'));
+  const outline = new MDOutline(path.join(PROJECT_DIR, 'docs', 'src', 'api-body.md'), path.join(PROJECT_DIR, 'docs', 'src', 'api-params.md'));
   outline.setLinkRenderer(item => {
     const { clazz, member, param, option } = item;
     if (param)
@@ -54,11 +54,11 @@ async function run() {
 
   let generatedLinksSuffix;
   {
-    const links = fs.readFileSync(path.join(PROJECT_DIR, 'docs-src', 'links.md')).toString();
+    const links = fs.readFileSync(path.join(PROJECT_DIR, 'docs', 'src', 'links.md')).toString();
     const localLinks = [];
     for (const clazz of outline.classesArray)
       localLinks.push(`[${clazz.name}]: api/class-${clazz.name.toLowerCase()}.md "${clazz.name}"`);
-    generatedLinksSuffix = localLinks.join('\n') + '\n' + links;
+    generatedLinksSuffix = '\n' + localLinks.join('\n') + '\n' + links;
   }
 
   // Produce api.md
@@ -70,7 +70,7 @@ async function run() {
         type: 'text',
         text: `---
 id: class-${clazz.name.toLowerCase()}
-title: "class: ${clazz.name}"
+title: "${clazz.name}"
 ---
 `});
       result.push(...(clazz.spec || []).map(c => md.clone(c)));
@@ -87,7 +87,7 @@ title: "class: ${clazz.name}"
       for (const member of clazz.membersArray) {
         // Iterate members
         /** @type {MarkdownNode} */
-        const memberNode = { type: 'h4', children: [] };
+        const memberNode = { type: 'h2', children: [] };
         if (member.kind === 'event') {
           memberNode.text = `${clazz.varName}.on('${member.name}')`;
         } else if (member.kind === 'property') {
@@ -95,10 +95,8 @@ title: "class: ${clazz.name}"
         } else if (member.kind === 'method') {
           // Patch method signatures
           memberNode.text = `${clazz.varName}.${member.name}(${member.signature})`;
-          for (const arg of member.argsArray) {
-            if (arg.type)
-              memberNode.children.push(renderProperty(`\`${arg.name}\``, arg.type, arg.spec));
-          }
+          for (const arg of member.argsArray)
+            memberNode.children.push(renderProperty(`\`${arg.name}\``, arg.type, arg.spec));
         }
 
         // Append type
@@ -116,23 +114,23 @@ title: "class: ${clazz.name}"
         memberNode.children.push(...(member.spec || []).map(c => md.clone(c)));
         result.push(memberNode);
       }
-      writeAssumeNoop(path.join(PROJECT_DIR, 'docs', `class-${clazz.name.toLowerCase()}.md`), [md.render(result), generatedLinksSuffix].join('\n'), dirtyFiles);
+      writeAssumeNoop(path.join(PROJECT_DIR, 'docs', 'out', 'api', `class-${clazz.name.toLowerCase()}.md`), [md.render(result), generatedLinksSuffix].join('\n'), dirtyFiles);
     }
   }
 
   // Produce other docs
   {
-    for (const name of fs.readdirSync(path.join(PROJECT_DIR, 'docs-src'))) {
+    for (const name of fs.readdirSync(path.join(PROJECT_DIR, 'docs', 'src'))) {
       if (name === 'links.md' || name.startsWith('api-'))
         continue;
-      const content = fs.readFileSync(path.join(PROJECT_DIR, 'docs-src', name)).toString();
+      const content = fs.readFileSync(path.join(PROJECT_DIR, 'docs', 'src', name)).toString();
       const nodes = md.parse(content);
       outline.renderLinksInText(nodes);
       for (const node of nodes) {
         if (node.text === '<!-- TOC -->')
           node.text = md.generateToc(nodes);
       }
-      writeAssumeNoop(path.join(PROJECT_DIR, 'docs', name), [md.render(nodes), generatedLinksSuffix].join('\n'), dirtyFiles);
+      writeAssumeNoop(path.join(PROJECT_DIR, 'docs', 'out', name), [md.render(nodes), generatedLinksSuffix].join('\n'), dirtyFiles);
     }
   }
 
@@ -189,7 +187,8 @@ title: "class: ${clazz.name}"
  * @param {Set<string>} dirtyFiles
  */
 function writeAssumeNoop(name, content, dirtyFiles) {
-  const oldContent = fs.readFileSync(name).toString();
+  fs.mkdirSync(path.dirname(name), { recursive: true });
+  const oldContent = fs.existsSync(name) ? fs.readFileSync(name).toString() : '';
   if (oldContent !== content) {
     fs.writeFileSync(name, content);
     dirtyFiles.add(name);
diff --git a/utils/doclint/generateApiJson.js b/utils/doclint/generateApiJson.js
index 91467d7200..0bcb97ce24 100644
--- a/utils/doclint/generateApiJson.js
+++ b/utils/doclint/generateApiJson.js
@@ -22,7 +22,7 @@ const { MDOutline } = require('./MDBuilder');
 const PROJECT_DIR = path.join(__dirname, '..', '..');
 
 {
-  const outline = new MDOutline(path.join(PROJECT_DIR, 'docs-src', 'api-body.md'), path.join(PROJECT_DIR, 'docs-src', 'api-params.md'));
+  const outline = new MDOutline(path.join(PROJECT_DIR, 'docs', 'src', 'api-body.md'), path.join(PROJECT_DIR, 'docs', 'src', 'api-params.md'));
   outline.setLinkRenderer(item => {
     const { clazz, member, param, option } = item;
     if (param)
diff --git a/utils/generate_types/index.js b/utils/generate_types/index.js
index 989d9666f1..054a9cf869 100644
--- a/utils/generate_types/index.js
+++ b/utils/generate_types/index.js
@@ -36,7 +36,7 @@ let hadChanges = false;
     fs.mkdirSync(typesDir)
   writeFile(path.join(typesDir, 'protocol.d.ts'), fs.readFileSync(path.join(PROJECT_DIR, 'src', 'server', 'chromium', 'protocol.ts'), 'utf8'));
   writeFile(path.join(typesDir, 'trace.d.ts'), fs.readFileSync(path.join(PROJECT_DIR, 'src', 'trace', 'traceTypes.ts'), 'utf8'));
-  const outline = new MDOutline(path.join(PROJECT_DIR, 'docs-src', 'api-body.md'), path.join(PROJECT_DIR, 'docs-src', 'api-params.md'));
+  const outline = new MDOutline(path.join(PROJECT_DIR, 'docs', 'src', 'api-body.md'), path.join(PROJECT_DIR, 'docs', 'src', 'api-params.md'));
   outline.copyDocsFromSuperclasses([]);
   const createMemberLink = (text) => {
     const anchor = text.toLowerCase().split(',').map(c => c.replace(/[^a-z]/g, '')).join('-');
diff --git a/utils/watch.js b/utils/watch.js
index fdff62caf7..7d841bc1d3 100644
--- a/utils/watch.js
+++ b/utils/watch.js
@@ -26,8 +26,8 @@ process.on('exit', () => spawns.forEach(s => s.kill()));
 
 runOnChanges(['src/protocol/protocol.yml'], 'utils/generate_channels.js');
 runOnChanges([
-  'docs-src/api-body.md',
-  'docs-src/api-params.md',
+  'docs/src/api-body.md',
+  'docs/src/api-params.md',
   'utils/generate_types/overrides.d.ts',
   'utils/generate_types/exported.json',
   'src/server/chromium/protocol.ts',