Markdoc tags

Use Markdoc tags in your project to add rich formatting, interactivity and reuse capability to your content.

The following Markdoc tags are included with the official Markdoc package:

• Partial: Reuse content between project pages.
• Table: Create rich tables with less syntax.
• If and else: Add condition that must be fulfilled to render content.

The following Markdoc tags are custom-made by Redocly:

• Admonition: Add color-coded banners to highlight important information.
• Cards: Organize links in a "card" or "tile" layout.
• Code snippet: Pull fragments code files directly into your documentation pages.
• Code group: Organize a series of code-snippet tags into a tabbed layout.
• Code walkthrough: Create interactive, step-by-step instructions for complex code development tasks.
  • Step: Define individual procedures of a code walkthrough.
  • Toggle: Add toggles to allow users to switch between variants of walkthrough content.
  • Input: Add input fields to code walkthroughs.
• Connect MCP: Add a button that allows users to connect to the MCP (Model Context Protocol) server.
• Image: Embed images into your project.
• Icon: Render Font Awesome icons in your project.
• Inline SVG: Render and style SVG images in your project.
• Login button: Add a login button visible only to unauthenticated users.
• JSON schema: Render schemas inside a pre-styled element.
• JSON Example: Render JSON examples directly in your documentation pages.
• Markdoc Example: Add examples of Markdoc syntax alongside the rendered element.
• OpenAPI code sample: Render sample code snippets directly in your documentation pages.
• OpenAPI response sample: Render response examples directly in your documentation.
• Replay OpenAPI: Add the Replay consoe to make API calls directly from a documentation page.
• Tabs: Organize content variants into switchable tabs.

• Markdoc tag library: Explore Markdoc tags and their rendered examples
• Create code walkthrough: Follow the tutorial to add code walkthroughs to your project