# Documentation

URL: /patitas/docs/
Section: docs
Description: Documentation for the Patitas Python Markdown parser, including CommonMark syntax, directives, frontmatter, and typed AST APIs

---

> For a complete page index, fetch /patitas/llms.txt.

## Start Here

New to Patitas? Start here to parse Markdown, explore the typed AST, add directives,
and use frontmatter or notebook content in Python pipelines.

:::{cards}
:columns: 2
:gap: medium

:::{card} Get Started
:icon: arrow-clockwise
:link: ./get-started/
:description: Install Patitas and parse your first document
:::{/card}

:::{card} API Reference
:icon: bookmark
:link: ./reference/
:description: Complete API documentation with examples
:::{/card}

:::{/cards}

## Learn Patitas

Master CommonMark syntax, directive extensions, and content-processing patterns.

:::{cards}
:columns: 2
:gap: medium

:::{card} Syntax
:icon: code
:link: ./syntax/
:description: Inline, blocks, links, code, and more
:::{/card}

:::{card} Directives
:icon: layers
:link: ./directives/
:description: MyST-style admonitions, tabs, dropdowns
:::{/card}

:::{card} Extending
:icon: starburst
:link: ./extending/
:description: Custom directives, roles, and plugins
:::{/card}

:::{card} About
:icon: info
:link: ./about/
:description: Architecture, performance, security, and design
:::{/card}

:::{/cards}

## Look It Up

Technical specifications and troubleshooting.

:::{cards}
:columns: 2
:gap: medium

:::{card} Reference
:icon: bookmark
:link: ./reference/
:description: API, nodes, and configuration
:::{/card}

:::{card} Troubleshooting
:icon: alert-triangle
:link: ./troubleshooting/
:description: Common errors and how to fix them
:::{/card}

:::{/cards}