Markdown

There are some nifty MDX components available for use in Markdown content. Because these components are included globally, you don't need to do anything special to use them (like renaming .md to .mdx or manually importing them at the top of the file).

Product screenshots

The <ProductScreenshot /> component encapsulates an image with a border and background. It's useful since the app's background matches the website background, and without using this component, it can be hard to differentiate between the screenshot and normal page content. (See an example of this component in action.)

It supports dark mode screenshots (optional). Here's how to use it:

1. Import the image(s) at the top of the post (directly following the MDX file's frontmatter and dashes):

   ---
   export const ImgSampleConfigLight = "https://res.cloudinary.com/dmukukwp6/image/upload/posthog.com/contents/handbook/images/tutorials/limit-session-recordings/sampling-config-light.png"
   export const ImgSampleConfigDark = "https://res.cloudinary.com/dmukukwp6/image/upload/posthog.com/contents/handbook/images/tutorials/limit-session-recordings/sampling-config-dark.png"

2. Use the component wherever you want the image to appear.

   <ProductScreenshot
     imageLight={ImgSampleConfigLight} 
     imageDark={ImgSampleConfigDark} 
     alt="Sampling config shown set to 100% i.e. no sampling" 
     classes="rounded"
   />

   Optionally pass zoom={false} if you don't want the image to be zoomable, otherwise it will be zoomable by default.

   Note: If you don't have a dark image, just leave out the imageDark prop and the light screenshot will be used for both color modes.

Product videos

Th <ProductVideo /> component works the same as product screenshots (above) but supports light and dark videos.

1. Import the video(s) at the top of the post (directly following the MDX file's frontmatter and dashes):

   ---
   export const NewFunnelLight = "https://res.cloudinary.com/dmukukwp6/video/upload/posthog.com/contents/handbook/images/docs/user-guides/funnels/new-funnel.mp4"
   export const NewFunnelDark = "https://res.cloudinary.com/dmukukwp6/video/upload/posthog.com/contents/handbook/images/docs/user-guides/funnels/new-funnel-dark.mp4"

2. Use the component wherever you want the video(s) to appear.

   <ProductVideo
     videoLight={NewFunnelLight} 
     videoDark={NewFunnelDark} 
     classes="rounded"
   />

   Note: If you don't have a dark video, just leave out the videoDark prop and the light video will be used for both color modes.

Codeblocks

The PostHog website has a custom codeblock component that comes with a number of useful features built-in:

• Syntax highDarking
• Multiple snippets in a single codeblock
• Specifying which file a snippet is from

Basic codeblock

Codeblocks in PostHog are created by enclosing your snippet using three backticks (```) or three tildes (~~~), as shown below:

```
{
    "name": "Max, Hedgehog in Residence",
    "age": 2
}
```

This will produce the following codeblock:

{
    "name": "Max, Hedgehog in Residence",
    "age": 2
}

Adding syntax highlighting

Syntax highlighting can be added by specifying a language for the codeblock, which is done by appending the name of the language directly after the opening backticks or tildes as shown below.

```json
{
    "name": "Max, Hedgehog in Residence",
    "age": 2
}
```

This will produce the following output:

{
    "name": "Max, Hedgehog in Residence",
    "age": 2
}

Supported languages

Here is a list of all the languages that are supported in codeblocks:

Frontend

Backend

Misc.

Note: If you want syntax highlighting for a snippet in another language, feel free to add your language to the imports here and open a PR.

Multiple code snippets in one block

With PostHog's MultiLanguage component, it's possible to group multiple code snippets together into a single block.

<MultiLanguage>

```js
console.log("Hello world!")
```

```html
<div>Hello world!</div>
```

</MultiLanguage>

Note: Make sure to include empty lines between all your code snippets, as well as above and below the MultiLanguage tag

This will render the following codeblock:

console.log("Hello world!")

Specifying which file a snippet is from

You can specify a filename that a code snippet belongs to using the file parameter, which will be displayed in the top bar of the block.

```yaml file=values.yaml
cloud: 'aws'
ingress:
    hostname: <your-hostname>
    nginx:
        enabled: true
cert-manager:
    enabled: true
```

Note: Make sure not to surround your filename in quotes. Each parameter-value pair is delimited by spaces.

This produces the following codeblock:

cloud: 'aws'
ingress:
    hostname: <your-hostname>
    nginx:
        enabled: true
cert-manager:
    enabled: true

Private links

Sometimes we link to confidential information in our handbook. Since the handbook is public, it's useful to indicate when a link is private so visitors aren't confused as to why they can't access a URL. Use the <PrivateLink /> component for this. (Here's an example.)

<PrivateLink url="https://path/to/private/link">
  click here
</PrivateLink>

Private links will always open in a new tab.