Inline code
Wrap aword or phrase in backticks:
POST /checkout/sessions), field names
(metadata), values (pk_test_…), and file paths (apps/docs/docs.json).
Code blocks
Fence code with triple backticks and a language for syntax highlighting. Optionally add a filename/title after the language:checkout.js
Code groups (multiple languages)
Use<CodeGroup> to show the same task in several languages as tabs — the
standard way integration examples are documented here:
Request & response examples
For API endpoint pages,<RequestExample> and <ResponseExample> render the
request and a sample response side-by-side:
Highlighting, line numbers, and focus
Mintlify supports meta options after the language for emphasis:Conventions for these docs
- Real, runnable examples. Use the real base URL
(
https://api.pocketsflow.com) and realistic IDs. - Never include real secrets. Use
pk_test_…placeholders and read keys from environment variables in examples. - Keep server-side secrets server-side in every sample — never show an API key or webhook signing secret in browser code.
- Match existing examples — the integration guides standardize on cURL / Node.js / PHP tabs.
Related topics
- Docs configuration
- Images & embeds
- Custom platforms — real code examples in context