Full Markdown + Markdoc Syntax Reference

This document covers:

• Standard Markdown syntax
• Markdoc custom tags and usage
• All config options for defining custom tags

1. Headings

H1

H2

H3

H4

H5

H6

2. Emphasis

Bold text Italic text Strikethrough Inline code

3. Links and Images

Example link

4. Blockquotes

This is a blockquote with a single paragraph.

Multiple lines are allowed.

5. Lists

Unordered List

• Item A
• Item B
  • Nested Item B.1

Ordered List

1. First
2. Second
3. Third

6. Code Blocks

Markdown fenced block

// JavaScript code example
function greet(name) {
  return `Hello, ${name}`;
}

7. Horizontal Rule

---

8. Tables

9. Custom Tags (Defined in markdoc-config.ts)

9.1 Page Break

Self-closing tag. Renders a visual or functional break in content.

9.2 Callout Box

Attributes:

• type: info | warning | success | error (optional, default: "info")
• title: optional text heading

9.3 Expandable Details Section

Attribute:

• summary: required