# Get Started

URL: /patitas/docs/get-started/
Section: get-started
Description: Install Patitas and parse your first Markdown document with a Python Markdown parser built for typed AST workflows

---

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

## Install

```bash
pip install patitas
```

Requires Python 3.14 or later. See [[docs/get-started/installation|installation]] for alternative methods.

## Parse Markdown

```python
from patitas import parse, render

# Parse to typed AST
doc = parse("# Hello **World**")

# Render to HTML
html = render(doc, source="# Hello **World**")
print(html)
# Output: <h1>Hello <strong>World</strong></h1>
```

## All-in-One

```python
from patitas import Markdown

md = Markdown()
html = md("# Hello **World**")
print(html)
# Output: <h1>Hello <strong>World</strong></h1>
```

## What's Next?

:::{cards}
:columns: 1-2-3
:gap: medium

:::{card} Quickstart
:icon: zap
:link: ./quickstart
:description: Complete walkthrough in 2 minutes
:badge: Start Here
Parse, render, and explore the AST.
:::{/card}

:::{card} Syntax Guide
:icon: code
:link: ../syntax/
:description: Markdown syntax reference
Learn inline, blocks, links, and code.
:::{/card}

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

:::{card} Examples
:icon: play
:link: ./examples
:description: Runnable examples in the repo
Basic, AST, directives, incremental, LLM safety, and more.
:::{/card}

:::{/cards}

## Quick Links

- [[docs/get-started/examples|Examples]] — Runnable examples in `examples/`
- [[docs/reference/api|API Reference]] — parse, render, Markdown class
- [[docs/syntax/inline|Inline Syntax]] — emphasis, links, code
- [[docs/about/architecture|Architecture]] — lexer, parser, renderer