# Patitas

> Modern Markdown parser for Python 3.14t

## Overview

- [Patitas](/patitas/): A Python Markdown parser and CommonMark parser for typed ASTs, directives, frontmatter, and notebook content

## Documentation

- [Documentation](/patitas/docs/): Documentation for the Patitas Python Markdown parser, including CommonMark syntax, directives, frontmatter, and typed AST APIs

## Releases

- [0.1.0](/patitas/releases/0.1.0/): Initial release of Patitas
- [0.2.0](/patitas/releases/0.2.0/): Incremental parsing, AST diffing, visitor/transform, serialization
- [0.3.0](/patitas/releases/0.3.0/): Notebook parsing, MathRole KaTeX compatibility
- [0.3.1](/patitas/releases/0.3.1/): Parse cache, excerpt support, examples, directive options fix
- [0.3.2](/patitas/releases/0.3.2/): LLM renderer, sanitization policies, extract_text, parallel benchmark
- [0.3.3](/patitas/releases/0.3.3/): Frontmatter parsing — parse_frontmatter, extract_body, PyYAML
- [0.3.4](/patitas/releases/0.3.4/): Fix preserves_raw_content for list-like directive content (list-table)
- [0.3.5](/patitas/releases/0.3.5/): O(log n) line lookup, benchmark suite, excerpt/directive fixes
- [0.4.0](/patitas/releases/0.4.0/): Content linting, sanitizer XSS fix, directive rendering fix, nesting limits
- [Releases](/patitas/releases/): Patitas release history

## About

- [About](/patitas/docs/about/): Architecture, performance, security, and design philosophy for the Patitas Python Markdown parser
- [Architecture](/patitas/docs/about/architecture/): How the lexer, parser, and renderer work
- [Parser Comparison](/patitas/docs/about/comparison/): An honest comparison of Patitas vs markdown-it-py, Python-Markdown, and mistune
- [The Bengal Ecosystem](/patitas/docs/about/ecosystem/): A structured reactive stack — every layer written in pure Python for 3.14t free-threading
- [Performance](/patitas/docs/about/performance/): Benchmarks and optimization strategies
- [Thread Safety](/patitas/docs/about/thread-safety/): Free-threading and concurrency support

## Directives

- [Directives](/patitas/docs/directives/): MyST-style directive extensions for the Patitas Python Markdown parser
- [Admonition](/patitas/docs/directives/admonition/): Callout boxes for notes, warnings, and tips
- [Container](/patitas/docs/directives/container/): Generic wrapper divs for styling
- [Dropdown](/patitas/docs/directives/dropdown/): Collapsible content sections
- [Tabs](/patitas/docs/directives/tabs/): Tabbed content panels

## Extending

- [Extending](/patitas/docs/extending/): Custom directives, roles, and plugins
- [AST Processing](/patitas/docs/extending/ast-processing/): Visit and transform the Markdown AST
- [Custom Directives](/patitas/docs/extending/custom-directives/): Create your own directive handlers
- [AST Diffing](/patitas/docs/extending/diffing/): Structural diff on frozen AST trees
- [LLM Safety](/patitas/docs/extending/llm-safety/): Sanitize and render Markdown for LLM context (RAG, retrieval)
- [Plugins](/patitas/docs/extending/plugins/): Bundle extensions into reusable plugins
- [Serialization](/patitas/docs/extending/serialization/): Cache and transfer AST as dict or JSON

## Get Started

- [Get Started](/patitas/docs/get-started/): Install Patitas and parse your first Markdown document with a Python Markdown parser built for typed AST workflows
- [Examples](/patitas/docs/get-started/examples/): Runnable examples showcasing Patitas capabilities
- [Installation](/patitas/docs/get-started/installation/): Install Patitas and optional extras
- [Quickstart](/patitas/docs/get-started/quickstart/): Parse your first Markdown document in 2 minutes

## Reference

- [Reference](/patitas/docs/reference/): API reference for parsing Markdown, rendering HTML, and working with Patitas AST nodes
- [API Reference](/patitas/docs/reference/api/): Functions, classes, and modules
- [AST Nodes](/patitas/docs/reference/nodes/): AST node types and structure

## Syntax

- [Syntax](/patitas/docs/syntax/): CommonMark and Markdown syntax reference for the Patitas Python Markdown parser
- [Block Syntax](/patitas/docs/syntax/blocks/): Paragraphs, headings, lists, and other block elements
- [Code](/patitas/docs/syntax/code/): Inline code, fenced blocks, and indented code
- [Inline Syntax](/patitas/docs/syntax/inline/): Emphasis, strong, code, and other inline elements
- [Links](/patitas/docs/syntax/links/): Inline links, reference links, and autolinks

## Troubleshooting

- [Troubleshooting](/patitas/docs/troubleshooting/): Common errors and how to fix them

## Optional

- [index.json](/patitas/index.json): Search index with page metadata and excerpts
- [robots.txt](/patitas/robots.txt): Content Signals directives for AI crawlers