---
title: "Markdown Types API"
description: "Detailed documentation of all types related to the Markdown extension in Tiptap."
canonical_url: "https://tiptap.dev/docs/editor/markdown/api/types"
---

# Markdown Types API

Detailed documentation of all types related to the Markdown extension in Tiptap.

## Types

### `MarkdownExtensionOptions`

Options for configuring the Markdown extension.

```typescript
type MarkdownExtensionOptions = {
  indentation?: {
    style?: 'space' | 'tab'
    size?: number
  }
  marked?: typeof marked
  markedOptions?: MarkedOptions
}
```

---

### `MarkdownExtensionSpec`

Configuration for Markdown support in extensions.

```typescript
type MarkdownExtensionSpec = {
  parseName?: string
  renderName?: string
  markdownName?: string // Legacy
  parseMarkdown?: (token: MarkdownToken, helpers: MarkdownParseHelpers) => MarkdownParseResult
  renderMarkdown?: (node: JSONContent, helpers: MarkdownRendererHelpers, context: RenderContext) => string
  isIndenting?: boolean
  tokenizer?: MarkdownTokenizer
}
```

---

### `MarkdownToken`

Token structure from MarkedJS.

```typescript
type MarkdownToken = {
  type: string
  raw?: string
  text?: string
  tokens?: MarkdownToken[]
  [key: string]: any
}
```

---

### `MarkdownParseHelpers`

Helpers passed to parse handlers.

```typescript
type MarkdownParseHelpers = {
  parseInline: (tokens: MarkdownToken[]) => JSONContent[]
  parseChildren: (tokens: MarkdownToken[]) => JSONContent[]
  createTextNode: (text: string, marks?: Array<{ type: string; attrs?: any }>) => JSONContent
  createNode: (type: string, attrs?: any, content?: JSONContent[]) => JSONContent
  applyMark: (markType: string, content: JSONContent[], attrs?: any) => MarkdownParseResult
}
```

---

### `MarkdownRendererHelpers`

Helpers passed to render handlers.

```typescript
type MarkdownRendererHelpers = {
  renderChildren: (nodes: JSONContent | JSONContent[], separator?: string) => string
  wrapInBlock: (prefix: string, content: string) => string
  indent: (content: string) => string
}
```

---

### `RenderContext`

Context information passed to render handlers.

```typescript
type RenderContext = {
  index: number // Node index in parent
  level: number // Nesting level
  parentType?: string // Parent node type
  meta: Record<string, any> // Custom metadata
}
```

---

### `MarkdownTokenizer`

Custom tokenizer for MarkedJS.

```typescript
type MarkdownTokenizer = {
  name: string
  level?: 'block' | 'inline'
  start?: (src: string) => number | undefined
  tokenize: (src: string, tokens: MarkdownToken[], lexer: MarkdownLexerConfiguration) => MarkdownToken | undefined
}
```

---

### `MarkdownLexerConfiguration`

Lexer helpers for custom tokenizers.

```typescript
type MarkdownLexerConfiguration = {
  inlineTokens: (src: string) => MarkdownToken[]
  blockTokens: (src: string) => MarkdownToken[]
}
```

---

### `MarkdownParseResult`

Result type for parse handlers.

```typescript
type MarkdownParseResult = JSONContent | JSONContent[] | { mark: string; content: JSONContent[]; attrs?: any } | null
```

---

### `ExtendableMarkdownSpec`

Markdown configuration in extensions.

```typescript
type ExtendableMarkdownSpec = {
  name?: string
  parseName?: string
  renderName?: string
  parse?: (token: MarkdownToken, helpers: MarkdownParseHelpers) => MarkdownParseResult
  render?: (node: JSONContent, helpers: MarkdownRendererHelpers, context: RenderContext) => string
  isIndenting?: boolean
  tokenizer?: MarkdownTokenizer
}
```