What's a Custom Page?

👍

This page is a Custom Page! Look up at the URL. Back to the help article.

Use Custom Pages when you want to keep your ReadMe project's top navigation but customize everything below the search bar.

What's different?

Left: Custom Page, Right: Docs page

Custom Pages change a few things compared to standard Documentation pages:

  1. No left sidebar navigation
  2. No table of contents, even if headers are used
  3. A different URL path (/page instead of /docs)
  4. No page voting
  5. No "Updated x days ago"
🚧

Custom Pages are not affected by versioning and are shared. If you delete a Custom Page it will be removed from everywhere.

What's the same?

You can add a Custom Page to your subnavigation in Admin Settings > Navigation. It will appear as a new item using the same header name or a custom title.

Modes

Markdown or HTML Mode

Custom Pages have two modes:

  1. Markdown: The standard mode used in Documentation section
  2. HTML: The code is sanitized. If you want to include CSS or JavaScript, do so in Appearance > Custom Javascript/Stylesheet.