Format Reference

Warning

This page is an internal format reference for contributors. It compiles every supported markdown and MDX format on a single page so reviewers can spot rendering regressions in one pass. It is hidden from the sidebar, excluded from the sitemap and llms.txt, and tagged noindex,nofollow. Do not link to it from user-facing guides.

Objective

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Nullam vehicula augue sit amet libero fringilla, nec auctor magna pretium. This guide compiles every supported format so that a single visual pass can confirm nothing is broken after a theme or build change.

Requirements

  • An with access to the Control Panel
  • Basic familiarity with Markdown and MDX
  • A browser to verify that all formats render correctly

Instructions

1 โ€” Plain text and inline formatting

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Pellentesque habitant morbi tristique senectus. Use inline code to reference technical terms, file paths like /etc/hosts, or commands like sudo systemctl restart nginx.

You can also combine them: bold code or italic code.

Superscript for footnotes1 and line breaks
between phrases are also supported.

1 This is a simulated footnote rendered with superscript HTML.

Tooltip example: hover over this wordThis is a tooltip with inline code and a link. to see the overlay.


2 โ€” Headings

H4 โ€” Fourth-level heading

H5 โ€” Fifth-level heading (use sparingly)

3 โ€” Images

Image from the shared public folder (referenced by absolute path, shared across all locales):

OVHcloud account login screen

Second image from a different guide folder (still a shared public asset):

API console actions screenshot


4 โ€” Code blocks

Bash:

#!/bin/bash
# Create and mount a logical volume for SAP HANA data
pvcreate /dev/sdb
vgcreate vg_hana /dev/sdb
lvcreate -L 500G -n lv_hanadata vg_hana
mkfs.xfs /dev/vg_hana/lv_hanadata
mount /dev/vg_hana/lv_hanadata /hana/data
echo "Mount successful"

Console (interactive shell output):

$ lsblk
NAME          MAJ:MIN RM   SIZE RO TYPE  MOUNTPOINT
sda             8:0    0 447.1G  0 disk
โ”œโ”€sda1          8:1    0   512M  0 part  /boot/efi
โ”œโ”€sda2          8:2    0     1G  0 part  /boot
โ””โ”€sda3          8:3    0 445.6G  0 part
  โ””โ”€md0         9:0    0 445.6G  0 raid1 /
sdb             8:16   0  10.5T  0 disk

$ df -h /hana/data
Filesystem                       Size  Used Avail Use% Mounted on
/dev/mapper/vg_hana-lv_hanadata  500G  1.2G  499G   1% /hana/data

JSON:

{
  "serviceName": "pcc-1-2-3-4",
  "ram": 512,
  "storage": {
    "type": "NVMe",
    "sizeGb": 10240
  },
  "tags": ["production", "sap-hana"]
}

YAML:

version: "3.8"
services:
  app:
    image: nginx:latest
    ports:
      - "80:80"
    volumes:
      - ./html:/usr/share/nginx/html:ro

5 โ€” Callouts

INFO

Info callout โ€” Lorem ipsum dolor sit amet, consectetur adipiscing elit. Use this for neutral supplementary information that helps the reader but is not critical.

TIP

Tip callout โ€” Pellentesque habitant morbi tristique senectus et netus. Use tips to share best practices or shortcuts.

Warning

Warning callout โ€” Sed do eiusmod tempor incididunt ut labore et dolore magna aliqua. Use warnings when the user must pay attention to avoid data loss or service disruption.

  • This warning has a list item
  • And another one :::

:::danger Danger callout โ€” Ut enim ad minim veniam, quis nostrud exercitation. Use danger for irreversible or destructive actions.

Empty blockquote (plain > syntax, no type annotation):

Lorem ipsum dolor sit amet, consectetur adipiscing elit. This is an unstyled blockquote, also known as an "empty" callout.


6 โ€” Details (collapsible sections)

Click to expand โ€” Basic collapsible

Lorem ipsum dolor sit amet, consectetur adipiscing elit. Sed ut perspiciatis unde omnis iste natus error sit voluptatem accusantium doloremque laudantium.

Nemo enim ipsam voluptatem quia voluptas sit aspernatur aut odit aut fugit.

Click to expand โ€” Collapsible with rich content

This collapsible contains multiple content types:

A code block:

echo "Hello from inside a collapsible"

A table:

ParameterTypeDescription
hoststringThe target hostname or IP
portnumberThe port to connect to
timeoutnumberConnection timeout in ms

An info callout:

INFO

You can nest callouts inside collapsibles.


7 โ€” Tables

Simple table:

Logical volumeRecommended size
/usr/sapMIN(32 GB)
/hana/data1 ร— RAM
/hana/logยฝ ร— RAM (max 512 GB)
/hana/sharedMIN(1 ร— RAM, 1 TB)
/hana/backup/hana/data + /hana/log

Table with HTML line breaks in cells:

ConditionFormula
RAM โ‰ค 512 GB/hana/log = ยฝ ร— RAM
Example: 256 GB RAM โ†’ 128 GB log
RAM > 512 GB/hana/log = 512 GB (fixed cap)
Example: 1 TB RAM โ†’ 512 GB log

8 โ€” Lists

Unordered list:

  • Lorem ipsum dolor sit amet
  • Consectetur adipiscing elit
  • Sed do eiusmod tempor incididunt

Nested unordered list:

  • Universe level
    • Product level
      • Section level
        • Guide level (deepest nesting)
    • Another product
      • Its section

Numbered list:

  1. Connect to the .
  2. Navigate to Bare Metal Cloud > Dedicated Servers.
  3. Select your server from the list.
  4. Click the Install button to launch the reinstallation wizard.
  5. Confirm your choice in the modal dialog.

Numbered list with a custom start value:

  1. Review the partition layout proposed by the wizard.
  2. Click Confirm to finalize the installation.

Internal link (guide path): All about your OVHcloud username

Internal link (shortcut alias):

External link: OVHcloud community forum

Link inside a sentence: To manage your SSH keys, log in to the and navigate to My account > SSH keys.

Inline code outside a link: Use the --force flag only when you are certain the operation is safe.

Inline code inside a link: See the /me/api/credential endpoint reference for authentication details.

Sentence mixing both: the GET /me call returns your account details, whereas plain text links like do not use code formatting.


10 โ€” API calls

Single GET call:

GET/me

POST call with a path parameter:

POST/dedicatedCloud/{serviceName}/sap

PUT call limited to EU and CA regions:

PUT/nutanix/{serviceName}

DELETE call:


11 โ€” Tabs

Basic tabs:

Linux / macOS
Windows (PowerShell)
Windows (PuTTY)
ssh ubuntu@192.0.2.1 -i ~/.ssh/my_key

12 โ€” Embedded video


12b โ€” Guided-tour iframe


13 โ€” Russian-doll (nested formats)

The following tabs each contain multiple nested format types.

API + Callout
Image + Callout
Collapsible + Code + Table
List + API + Image

Use the following API call to retrieve your service information:

GET/me/api/logs/self
INFO

This endpoint returns a paginated list. Use the offset and limit query parameters to navigate through results. The maximum page size is 100.

Warning

Logs are retained for 90 days only. Archive them regularly if you need a longer audit trail.


14 โ€” Russian-doll: formats inside a Details

Expand โ€” API call, image, callout, code block, table and nested list inside a collapsible

Use this API call to list your active credentials:

GET/me/api/credential

The Control Panel shows the same data under Account > API > My credentials:

OVHcloud IAM policies screen

Info

Credentials created via the API and credentials created via the Control Panel are interchangeable โ€” they share the same underlying token store.

Warning

If you rotate a credential that is embedded in an automation script, update the script before revoking the old credential, or your automation will fail.

Revoke a credential by its ID with:

# Replace <credentialId> with the numeric ID returned by the GET call above
curl -X DELETE "https://eu.api.ovh.com/v1/me/api/credential/<credentialId>" \
  -H "X-Ovh-Application: <appKey>" \
  -H "X-Ovh-Consumer: <consumerKey>" \
  -H "X-Ovh-Timestamp: $(date +%s)" \
  -H "X-Ovh-Signature: <signature>"

Recommended rotation schedule by credential scope:

ScopeRotation intervalAutomation-safe?
full-access30 daysNo โ€” manual only
read-only90 daysYes
scoped60 daysYes

Steps to rotate safely:

  1. Create the new credential via the API or Control Panel.
  2. Update all scripts and CI/CD pipelines that use the old credential:
    • Check your .env files and secret stores
    • Check scheduled jobs and cron tasks
      • Look for hardcoded tokens in shell scripts
      • Look for tokens injected as environment variables
  3. Validate that the new credential works end-to-end.
  4. Revoke the old credential.

15 โ€” Nested Details (russian-doll collapsibles)

Two depth levels of collapsibles using raw HTML <details>. The Rspress container syntax (:::details) does not support nesting โ€” use HTML for any nested case.

Outer collapsible โ€” click to expand

The outer block can contain any MDX content.

Inner collapsible โ€” click to expand

The inner block is fully nested.

  • A list item
  • Another list item
echo "Inner code block"
INFO

Callouts also render inside nested collapsibles.

Back at the outer level after the inner closes.


Go further

Join our community of users.

Was this page helpful?