notionary 0.2.24__py3-none-any.whl → 0.2.26__py3-none-any.whl

notionary/blocks/callout/callout_models.py

@@ -27,6 +27,7 @@ class CalloutBlock(BaseModel):
     icon: Optional[IconObject] = None
     children: Optional[list[Block]] = None
 
+
 class CreateCalloutBlock(BaseModel):
     type: Literal["callout"] = "callout"
     callout: CalloutBlock

notionary/database/client.py

@@ -1,7 +1,5 @@
 from typing import Any, Dict, Optional
 
-from urllib3.util import response
-
 from notionary.base_notion_client import BaseNotionClient
 from notionary.database.models import (
     NotionDatabaseResponse,

notionary/page/models.py

@@ -2,6 +2,8 @@ from typing import Any, Literal, Optional, Union
 
 from pydantic import BaseModel, ConfigDict
 
+from notionary.blocks.models import ParentObject
+
 
 class TextContent(BaseModel):
     content: str
@@ -241,13 +243,6 @@ class NotionCover(BaseModel):
     external: Optional[ExternalCover] = None
 
 
-# Parent types for Pydantic
-class NotionParent(BaseModel):
-    type: str  # 'database_id', 'page_id', 'workspace'
-    database_id: Optional[str] = None
-    page_id: Optional[str] = None
-
-
 # User type for Pydantic
 class NotionUser(BaseModel):
     object: str  # 'user'
@@ -274,7 +269,7 @@ class NotionDatabaseResponse(BaseModel):
     properties: dict[
         str, Any
     ]  # Using Any for flexibility with different property schemas
-    parent: NotionParent
+    parent: ParentObject
     url: str
     public_url: Optional[str] = None
     archived: bool
@@ -290,7 +285,7 @@ class NotionPageResponse(BaseModel):
     last_edited_by: NotionUser
     cover: Optional[NotionCover] = None
     icon: Optional[Icon] = None
-    parent: NotionParent
+    parent: ParentObject
     archived: bool
     in_trash: bool
     properties: dict[str, Any]

notionary/page/notion_page.py

@@ -1,13 +1,16 @@
 from __future__ import annotations
 
+from ast import Dict
 import asyncio
 import random
 from typing import TYPE_CHECKING, Any, Callable, Optional, Union
 
+from yaml import Token
+
 from notionary.blocks.client import NotionBlockClient
 from notionary.comments import CommentClient, Comment
 from notionary.blocks.syntax_prompt_builder import SyntaxPromptBuilder
-from notionary.blocks.models import DatabaseParent
+from notionary.blocks.models import DatabaseParent, ParentObject
 from notionary.blocks.registry.block_registry import BlockRegistry
 from notionary.database.client import NotionDatabaseClient
 from notionary.file_upload.client import NotionFileUploadClient
@@ -61,6 +64,7 @@ class NotionPage(LoggingMixin):
 
         self._client = NotionPageClient(token=token)
         self._block_client = NotionBlockClient(token=token)
+        self._database_client = NotionDatabaseClient(token=token)
         self._comment_client = CommentClient(token=token)
         self._page_data = None
 
@@ -433,30 +437,20 @@ class NotionPage(LoggingMixin):
         """
         Get the value of a specific property.
         """
-        if not self._parent_database:
-            return None
-
-        database_property_schema = self._parent_database.properties.get(property_name)
-
-        if not database_property_schema:
+        if property_name not in self._properties:
             self.logger.warning(
-                "Property '%s' not found in database schema", property_name
+                "Property '%s' not found in page properties", property_name
             )
             return None
 
-        property_type = database_property_schema.get("type")
+        property_schema: dict = self._properties.get(property_name)
+
+        property_type = property_schema.get("type")
 
         if property_type == "relation":
             return await self._get_relation_property_values_by_name(property_name)
 
-        if property_name not in self._properties:
-            self.logger.warning(
-                "Property '%s' not found in page properties", property_name
-            )
-            return None
-
-        property_data = self._properties.get(property_name)
-        return extract_property_value(property_data)
+        return extract_property_value(property_schema)
 
     async def _get_relation_property_values_by_name(
         self, property_name: str
@@ -464,7 +458,7 @@ class NotionPage(LoggingMixin):
         """
         Retrieve the titles of all related pages for a relation property.
         """
-        page_property_schema = self.properties.get(property_name)
+        page_property_schema = self._properties.get(property_name)
         relation_page_ids = [
             rel.get("id") for rel in page_property_schema.get("relation", [])
         ]
@@ -477,23 +471,25 @@ class NotionPage(LoggingMixin):
         """
         Get the available options for a property (select, multi_select, status, relation).
         """
-        if not self._parent_database:
-            self.logger.error(
-                "Parent database not set. Cannot get options for property: %s",
-                property_name,
+        if property_name not in self.properties:
+            self.logger.warning(
+                "Property '%s' not found in page properties", property_name
             )
             return []
 
-        try:
-            return await self._parent_database.get_options_by_property_name(
-                property_name=property_name
-            )
-        except Exception as e:
-            self.logger.error(
-                "Error getting options for property '%s': %s", property_name, str(e)
-            )
-            return []
+        property_schema: dict = self.properties.get(property_name)
+        property_type = property_schema.get("type")
+
+        if property_type in ["select", "multi_select", "status"]:
+            options = property_schema.get(property_type, {}).get("options", [])
+            return [option.get("name", "") for option in options]
+
+        if property_type == "relation" and self._parent_database:
+            return await self._parent_database._get_relation_options(property_name)
+
+        return []
 
+    # Fix this for pages that do not ah
     async def set_property_value_by_name(self, property_name: str, value: Any) -> Any:
         """
         Set the value of a specific property by its name.

notionary/page/writer/handler/equation_handler.py

@@ -8,7 +8,7 @@ from notionary.page.writer.handler.line_handler import (
 
 
 class EquationHandler(LineHandler):
-    """Handles equation block specific logic with batching.
+    r"""Handles equation block specific logic with batching.
 
     Markdown syntax:
     $$

notionary-0.2.26.dist-info/METADATA

@@ -0,0 +1,270 @@
+Metadata-Version: 2.3
+Name: notionary
+Version: 0.2.26
+Summary: Python library for programmatic Notion workspace management - databases, pages, and content with advanced Markdown support
+License: MIT
+Author: Mathis Arends
+Author-email: mathisarends27@gmail.com
+Requires-Python: >=3.9
+Classifier: License :: OSI Approved :: MIT License
+Classifier: Programming Language :: Python :: 3
+Classifier: Programming Language :: Python :: 3.9
+Classifier: Programming Language :: Python :: 3.10
+Classifier: Programming Language :: Python :: 3.11
+Classifier: Programming Language :: Python :: 3.12
+Classifier: Programming Language :: Python :: 3.13
+Requires-Dist: aiofiles (>=24.1.0,<25.0.0)
+Requires-Dist: httpx (>=0.28.0)
+Requires-Dist: posthog (>=6.3.1,<7.0.0)
+Requires-Dist: pydantic (>=2.11.4)
+Requires-Dist: python-dotenv (>=1.1.0)
+Project-URL: Homepage, https://github.com/mathisarends/notionary
+Description-Content-Type: text/markdown
+
+<picture>
+  <source media="(prefers-color-scheme: dark)" srcset="./static/notionary-dark.png">
+  <source media="(prefers-color-scheme: light)" srcset="./static/notionary-light.png">
+  <img alt="Notionary logo: dark mode shows a white logo, light mode shows a black logo." src="./static/browser-use.png"  width="full">
+</picture>
+
+<h1 align="center">The Modern Notion API for Python & AI Agents</h1>
+
+<div align="center">
+
+[![Python Version](https://img.shields.io/badge/python-3.8%2B-blue.svg)](https://www.python.org/downloads/)
+[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
+[![Documentation](https://img.shields.io/badge/docs-mathisarends.github.io-blue.svg)](https://mathisarends.github.io/notionary/)
+
+**Transform complex Notion API interactions into simple, Pythonic code.**  
+Perfect for developers building AI agents, automation workflows, and dynamic content systems.
+
+</div>
+
+---
+
+## Why Notionary?
+
+- **AI-Native Design** - Built specifically for AI agents with schema-driven markdown syntax
+- **Smart Discovery** - Find pages and databases by name with fuzzy matching—no more hunting for IDs
+- **Extended Markdown** - Rich syntax for toggles, columns, callouts, and media uploads
+- **Async-First** - Modern Python with full async/await support and high performance
+- **Round-Trip** - Read existing content, modify it, and write it back while preserving formatting
+- **Complete Coverage** - Every Notion block type supported with type safety
+
+---
+
+## Installation
+
+```bash
+pip install notionary
+```
+
+Set up your [Notion integration](https://www.notion.so/profile/integrations) and configure your token:
+
+```bash
+export NOTION_SECRET=your_integration_key
+```
+
+---
+
+## See It in Action
+
+### Creating Rich Database Entries
+
+https://github.com/user-attachments/assets/da8b4691-bee4-4b0f-801e-dccacb630398
+
+*Create styled project pages with properties, content, and rich formatting*
+
+### Local File Uploads (Videos & Images)
+
+https://github.com/user-attachments/assets/a079ec01-bb56-4c65-8260-7b1fca42ac68
+
+*Upload videos and images using simple markdown syntax - files are automatically uploaded to Notion*
+
+---
+
+## Quick Start
+
+### Find → Create → Update Flow
+
+```python
+import asyncio
+from notionary import NotionPage, NotionDatabase
+
+async def main():
+    # Find pages by name - fuzzy matching included!
+    page = await NotionPage.from_page_name("Meeting Notes")
+    
+    # Option 1: Direct Extended Markdown
+    await page.append_markdown("""
+    ## Action Items
+    - [x] Review project proposal
+    - [ ] Schedule team meeting  
+    - [ ] Update documentation
+
+    [callout](Meeting decisions require follow-up "💡")
+    
+    +++ Details
+    Additional context and next steps...
+    +++
+    """)
+    
+    # Option 2: Type-Safe Builder (maps to same markdown internally)
+    await page.append_markdown(lambda builder: (
+        builder
+        .h2("Project Status") 
+        .callout("Milestone reached!", "🎉")
+        .columns(
+            lambda col: col.h3("Completed").bulleted_list([
+                "API design", "Database setup", "Authentication"
+            ]),
+            lambda col: col.h3("In Progress").bulleted_list([
+                "Frontend UI", "Testing", "Documentation"  
+            ]),
+            width_ratios=[0.6, 0.4]
+        )
+        .toggle("Budget Details", lambda t: t
+            .table(["Item", "Cost", "Status"], [
+                ["Development", "$15,000", "Paid"],
+                ["Design", "$8,000", "Pending"]
+            ])
+        )
+    ))
+
+asyncio.run(main())
+```
+
+### Complete Block Support
+
+Every Notion block type with extended syntax:
+
+| Block Type | Markdown Syntax | Use Case |
+|------------|-----------------|----------|
+| **Callouts** | `[callout](Text "🔥")` | Highlighting key information |
+| **Toggles** | `+++ Title\nContent\n+++` | Collapsible sections |
+| **Columns** | `::: columns\n::: column\nContent\n:::\n:::` | Side-by-side layouts |
+| **Tables** | Standard markdown tables | Structured data |
+| **Media** | `[video](./file.mp4)(caption:Description)` | Auto-uploading files |
+| **Code** | Standard code fences with captions | Code snippets |
+| **Equations** | `$LaTeX$` | Mathematical expressions |
+| **TOC** | `[toc](blue_background)` | Auto-generated navigation |
+
+---
+
+## What You Can Build 💡
+
+### **AI Content Systems**
+- **Report Generation**: AI agents that create structured reports, documentation, and analysis
+- **Content Pipelines**: Automated workflows that process data and generate Notion pages
+- **Knowledge Management**: AI-powered documentation systems with smart categorization
+
+### **Workflow Automation**  
+- **Project Management**: Sync project status, update timelines, generate progress reports
+- **Data Integration**: Connect external APIs and databases to Notion workspaces
+- **Template Systems**: Dynamic page generation from templates and data sources
+
+### **Content Management**
+- **Bulk Operations**: Mass page updates, content migration, and database management  
+- **Media Handling**: Automated image/video uploads with proper organization
+- **Cross-Platform**: Sync content between Notion and other platforms
+
+---
+
+## Key Features
+
+<table>
+<tr>
+<td width="50%">
+
+### Smart Discovery
+- Find pages/databases by name
+- Fuzzy matching for approximate searches  
+- No more hunting for IDs or URLs
+
+### Extended Markdown
+- Rich syntax beyond standard markdown
+- Callouts, toggles, columns, media uploads
+- Schema provided for AI agent integration
+
+### Modern Python 
+- Full async/await support
+- Type hints throughout  
+- High-performance batch operations
+
+</td>
+<td width="50%">
+
+### Round-Trip Editing
+- Read existing content as markdown
+- Edit and modify preserving formatting
+- Write back to Notion seamlessly
+
+### AI-Ready Architecture
+- Schema-driven syntax for LLM prompts
+- Perfect for AI content generation
+- Handles complex nested structures
+
+### Complete Coverage
+- Every Notion block type supported
+- File uploads with automatic handling
+- Database operations and properties
+
+</td>
+</tr>
+</table>
+
+---
+
+## Examples & Documentation
+
+### Full Documentation
+[**mathisarends.github.io/notionary**](https://mathisarends.github.io/notionary/) - Complete API reference, guides, and tutorials
+
+### Quick Links
+- [**Getting Started**](https://mathisarends.github.io/notionary/get-started/) - Setup and first steps
+- [**Page Management**](https://mathisarends.github.io/notionary/page/) - Content and properties  
+- [**Database Operations**](https://mathisarends.github.io/notionary/database/) - Queries and management
+- [**Block Types Reference**](https://mathisarends.github.io/notionary/blocks/) - Complete syntax guide
+
+### Hands-On Examples
+
+**Core Functionality:**
+- [Page Management](examples/page_example.py) - Create, update, and manage pages
+- [Database Operations](examples/database.py) - Connect and query databases  
+- [Workspace Discovery](examples/workspace_discovery.py) - Explore your workspace
+
+**Extended Markdown:**
+- [Basic Formatting](examples/markdown/basic.py) - Text, lists, and links
+- [Callouts & Highlights](examples/markdown/callout.py) - Information boxes  
+- [Toggle Sections](examples/markdown/toggle.py) - Collapsible content
+- [Multi-Column Layouts](examples/markdown/columns.py) - Side-by-side design
+- [Tables & Data](examples/markdown/table.py) - Structured presentations
+
+---
+
+## Contributing
+
+We welcome contributions from the community! Whether you're:
+- **Fixing bugs** - Help improve stability and reliability
+- **Adding features** - Extend functionality for new use cases  
+- **Improving docs** - Make the library more accessible
+- **Sharing examples** - Show creative applications and patterns
+
+Check our [**Contributing Guide**](https://mathisarends.github.io/notionary/contributing/) to get started.
+
+---
+
+<div align="center">
+
+**Ready to revolutionize your Notion workflows?**
+
+[📖 **Read the Docs**](https://mathisarends.github.io/notionary/) • [🚀 **Getting Started**](https://mathisarends.github.io/notionary/get-started/) • [💻 **Browse Examples**](examples/)
+
+*Built with ❤️ for Python developers and AI agents*
+
+---
+
+**Transform complex Notion API interactions into simple, powerful code.**
+
+</div>
+

{notionary-0.2.24.dist-info → notionary-0.2.26.dist-info}/RECORD

@@ -22,7 +22,7 @@ notionary/blocks/bulleted_list/bulleted_list_models.py,sha256=QN21PIwAP7MQoIjZeU
 notionary/blocks/callout/__init__.py,sha256=17rdvOF5W1aPxkp-pk13rLgkx6pIciCsub3ncAv_zXk,363
 notionary/blocks/callout/callout_element.py,sha256=6Ss1jv1cqAM4GuNGvuy7dCFjpp-dLavf-wXevn3IEmw,3575
 notionary/blocks/callout/callout_markdown_node.py,sha256=2zZNMwg8uiGBqaMOUVOTlIK8kiq20IQ0Ylv7ZFUm-bc,602
-notionary/blocks/callout/callout_models.py,sha256=E58ko2ujDV80HlI20S9etbCMTm6a_IaSp9waUozWTa8,863
+notionary/blocks/callout/callout_models.py,sha256=g_xU7oiRRseoSO86dqHPIiwoseGvvnl3jsPZbBMT-mE,865
 notionary/blocks/child_database/__init__.py,sha256=FzjjHOS9Je2oXuxLK9S9Oq56-EDEZRTJBfDzkacFpY0,368
 notionary/blocks/child_database/child_database_element.py,sha256=1pxtoB_XTIWorYp984TpsPMZy8A5IdQ15nJALyzme-c,2279
 notionary/blocks/child_database/child_database_models.py,sha256=SP6S9tKTetKNdCkYY3QCxeXd2lq1DyfdNvDhKlhD22Q,264
@@ -123,7 +123,7 @@ notionary/comments/__init__.py,sha256=G0OWsaN2VgbykvhLlNSweL_f0bl16j9NpidH2UNbFc
 notionary/comments/client.py,sha256=vWjgPFk_TPY7peq10aJc7WTG-b0q6Fn8qirAlzlqLls,7311
 notionary/comments/models.py,sha256=O2-yg-0Xrs8xrzLUa4793FlyNn3HbTRsv4dqaskI6ps,3409
 notionary/database/__init__.py,sha256=4tdML0fBzkOCpiWT6q-L--5NELFLbTPD0IUA_E8yZno,155
-notionary/database/client.py,sha256=mN_8XHvIQkRxiWbgBfvncgw4IRiCFX3bVLMLBvtk1Ig,5398
+notionary/database/client.py,sha256=NQWUcfMLAYsnTefFgOjgOHMYN7rn_IRBrsKPUlUY0c8,5361
 notionary/database/database.py,sha256=sdo830KVInR4enaEaeMHaPadNfYnPLy5R3OW2f74w28,16558
 notionary/database/database_filter_builder.py,sha256=YIkdghD5VbdwLJISMRiJ0WIJTm8jcDIL22yrvZau4sA,5950
 notionary/database/database_provider.py,sha256=HB-hZ9pMjronLJS8w_b1GiQ-Ecz1uJbrWpnePL67BCA,8956
@@ -137,8 +137,8 @@ notionary/file_upload/models.py,sha256=bSNgw5WzkOuotyalqkkcVC_Ue6YRHR-CSJV7nZRV_
 notionary/file_upload/notion_file_upload.py,sha256=vOEEh8g8Sj4JedrK9e-NYjJ0HXH3iGdM5N74kkVXVZQ,13221
 notionary/page/client.py,sha256=IOsjWOsmODxOq-7OF0y-gcuC2HUbMIT0SvJZHrH9weQ,4520
 notionary/page/markdown_whitespace_processor.py,sha256=SbWLL6bdeTGds_khDNX2mQe00lGYUFvH6PX8_xpNvBA,4634
-notionary/page/models.py,sha256=pD8FlK8KtnUrIITTd2jg_yJICakgPE4ysZiS9KiMpr0,7088
-notionary/page/notion_page.py,sha256=6aQqAqiEg6gb5lISKkV6a2UzIixgOZ-7eivlvXpyHvc,23689
+notionary/page/models.py,sha256=zk9QOgCDzVfYfT1Gp2bL1_Bw-QUyfWxwTTIPzIayQ7g,6945
+notionary/page/notion_page.py,sha256=P8J2lvq7xM0UwbL0wEFGi9w7jNPg43ewutmYpJINe1w,23662
 notionary/page/page_content_deleting_service.py,sha256=G3im6VotG1tgI-SaqoQR-gSnOloF6CEnft1qxLps4as,4546
 notionary/page/page_content_writer.py,sha256=t8N7yfW--ac7szvDmTdecFEfcF5Nz95vyCQ-lpYcOUw,3046
 notionary/page/page_context.py,sha256=27vrTRZP7NsaS4dEp4pBNR30Re2hh00qKlL3xt4YtpI,1773
@@ -161,7 +161,7 @@ notionary/page/writer/handler/__init__.py,sha256=8rAzBvmeaPYoYIB5Fd3XHCKFMmbSdlD
 notionary/page/writer/handler/code_handler.py,sha256=Xn5SitI2fnJkS38_RGtMEY0EOqwy8m-wnqaNetRx7hY,2671
 notionary/page/writer/handler/column_handler.py,sha256=JIwvWMPiNsMKAG6UEMpkiglD0kKsXQFu1dP1V6L5Keg,5415
 notionary/page/writer/handler/column_list_handler.py,sha256=k_exJ87d8i9MGV_uKxAB_mdpmcf5nfOZQ1bqHUoJHiA,5309
-notionary/page/writer/handler/equation_handler.py,sha256=vflcoaSNNnLxbI_8oE_o33etmF3CxvWYnVQCJ7gbbd8,2844
+notionary/page/writer/handler/equation_handler.py,sha256=ipS26TfAAOAUmOLPl36oMDurRHxXBfFMFZCrJe2iYUE,2845
 notionary/page/writer/handler/line_handler.py,sha256=miuU7MXJj1Ae_B_r4a84s9tJaJ8xWNo-LAeD6RqJ-aM,1163
 notionary/page/writer/handler/line_processing_context.py,sha256=F2GxDXIOgvZHxiDP-VDe8JUHGcsszMexPG0W9E9y39E,1739
 notionary/page/writer/handler/regular_line_handler.py,sha256=2T8xOi4ybcugMJL-sPyVvU0KRVQzFSPpvLibrixIJLA,3223
@@ -196,7 +196,7 @@ notionary/util/page_id_utils.py,sha256=AA00kRO-g3Cc50tf_XW_tb5RBuPKLuBxRa0D8LYhL
 notionary/util/singleton.py,sha256=CKAvykndwPRZsA3n3MAY_XdCR59MBjjKP0vtm2BcvF0,428
 notionary/util/singleton_metaclass.py,sha256=DMvrh0IbAV8nIG1oX-2Yz57Uk1YHB647DNxoI3pAT3s,809
 notionary/workspace.py,sha256=QP4WcOIdQnlVr4M7hpGaFT-Fori_QRhsV-SBC2lnwTU,3809
-notionary-0.2.24.dist-info/LICENSE,sha256=zOm3cRT1qD49eg7vgw95MI79rpUAZa1kRBFwL2FkAr8,1120
-notionary-0.2.24.dist-info/METADATA,sha256=TAnB9piH5MJLjSJSgv3opZrGb7vVtqT8HFKrJr44ohM,9580
-notionary-0.2.24.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
-notionary-0.2.24.dist-info/RECORD,,
+notionary-0.2.26.dist-info/LICENSE,sha256=zOm3cRT1qD49eg7vgw95MI79rpUAZa1kRBFwL2FkAr8,1120
+notionary-0.2.26.dist-info/METADATA,sha256=YQ47PvnCFcARf1p99-fZWoYnedbR0S5G2rQRUa6e4KY,9143
+notionary-0.2.26.dist-info/WHEEL,sha256=b4K_helf-jlQoXBBETfwnf4B04YC67LOev0jo4fX5m8,88
+notionary-0.2.26.dist-info/RECORD,,

notionary-0.2.24.dist-info/METADATA

@@ -1,250 +0,0 @@
-Metadata-Version: 2.3
-Name: notionary
-Version: 0.2.24
-Summary: Python library for programmatic Notion workspace management - databases, pages, and content with advanced Markdown support
-License: MIT
-Author: Mathis Arends
-Author-email: mathisarends27@gmail.com
-Requires-Python: >=3.9
-Classifier: License :: OSI Approved :: MIT License
-Classifier: Programming Language :: Python :: 3
-Classifier: Programming Language :: Python :: 3.9
-Classifier: Programming Language :: Python :: 3.10
-Classifier: Programming Language :: Python :: 3.11
-Classifier: Programming Language :: Python :: 3.12
-Classifier: Programming Language :: Python :: 3.13
-Requires-Dist: aiofiles (>=24.1.0,<25.0.0)
-Requires-Dist: httpx (>=0.28.0)
-Requires-Dist: posthog (>=6.3.1,<7.0.0)
-Requires-Dist: pydantic (>=2.11.4)
-Requires-Dist: python-dotenv (>=1.1.0)
-Project-URL: Homepage, https://github.com/mathisarends/notionary
-Description-Content-Type: text/markdown
-
-<picture>
-  <source media="(prefers-color-scheme: dark)" srcset="./static/notionary-dark.png">
-  <source media="(prefers-color-scheme: light)" srcset="./static/notionary-light.png">
-  <img alt="Notionary logo: dark mode shows a white logo, light mode shows a black logo." src="./static/browser-use.png"  width="full">
-</picture>
-
-<h1 align="center">Notion API simplified for Python developers 🐍</h1>
-
-<div align="center">
-
-[![Python Version](https://img.shields.io/badge/python-3.8%2B-blue.svg)](https://www.python.org/downloads/)
-[![License](https://img.shields.io/badge/license-MIT-green.svg)](LICENSE)
-[![Documentation](https://img.shields.io/badge/docs-mathisarends.github.io-blue.svg)](https://mathisarends.github.io/notionary/)
-
-Transform complex Notion API interactions into simple, Pythonic code. Build AI agents, automate workflows, and create dynamic content with ease.
-
-</div>
-
----
-
-## Why Notionary?
-
-- **Smart Discovery**: Find pages and databases by name—no more hunting for URLs or IDs
-- **Rich Markdown**: Convert extended Markdown (callouts, toggles, columns) directly into beautiful Notion blocks
-- **Async-First**: Built for modern Python with full async/await support and high performance
-- **AI-Ready**: Perfect foundation for AI agents that generate and manage Notion content
-- **Round-Trip**: Read existing content, modify it, and write it back while preserving formatting
-
----
-
-## Quick Start
-
-```bash
-pip install notionary
-```
-
-Set up your [Notion integration](https://www.notion.so/profile/integrations) and add your token:
-
-```bash
-NOTION_SECRET=your_integration_key
-```
-
-### Simple Flow: Find → Create → Update
-
-<video width="100%" controls>
-  <source src="./static/demo.mp4" type="video/mp4">
-  Your browser does not support the video tag.
-</video>
-
-_Demo: Converting markdown to structured Notion content with callouts, columns, and tables_
-
-```python
-import asyncio
-from notionary import NotionPage, NotionDatabase
-
-async def main():
-    # Work with pages - find by name, no exact match needed!
-    page = await NotionPage.from_page_name("Meeting Notes")
-
-    # Direct Markdown - quick & intuitive
-    await page.append_markdown("""
-    ## Action Items
-    - Review project proposal
-    - Schedule team meeting
-    - Update documentation
-
-    [callout](Important meeting decisions require follow-up "💡")
-    """)
-
-    # Builder Pattern - type-safe & powerful for complex layouts
-    await page.append_markdown(lambda builder: (
-        builder
-        .h2("Project Status")
-        .callout("Project milestone reached!", "🎉")
-        .columns(
-            lambda col: (col
-                .h3("Completed")
-                .bulleted_list(["API design", "Database setup", "Authentication"])
-            ),
-            lambda col: (col
-                .h3("In Progress")
-                .bulleted_list(["Frontend UI", "Testing", "Documentation"])
-            )
-        )
-        .table(
-            headers=["Task", "Owner", "Due Date"],
-            rows=[
-                ["Launch prep", "Alice", "2024-03-15"],
-                ["Marketing", "Bob", "2024-03-20"]
-            ]
-        )
-    ))
-
-asyncio.run(main())
-```
-
-### Create Rich Database Entries
-
-<video width="100%" controls>
-  <source src="./static/create_page_in_database_demo.mp4" type="video/mp4">
-  Your browser does not support the video tag.
-</video>
-
-_Demo: Creating a styled project page in a Notion database with properties, content, and rich formatting_
-
-```python
-# Work with databases - connect and create styled entries
-db = await NotionDatabase.from_database_name("Projects")
-
-# Create new project with full styling
-project = await db.create_blank_page()
-await project.set_title("New Marketing Campaign")
-await project.set_emoji_icon("🚀")
-await project.set_random_gradient_cover()
-
-# Set database properties
-await project.set_property_value_by_name("Status", "Planning")
-await project.set_property_value_by_name("Priority", "High")
-await project.set_property_value_by_name("Team Lead", "sarah@company.com")
-
-# Add rich content to the new page
-await project.replace_content(lambda builder: (
-    builder
-    .h1("Campaign Overview")
-    .callout("New marketing initiative targeting Q2 growth", "🎯")
-    .h2("Goals & Objectives")
-    .numbered_list([
-        "Increase brand awareness by 25%",
-        "Generate 500 qualified leads",
-        "Launch in 3 target markets"
-    ])
-    .h2("Budget Breakdown")
-    .table(
-        headers=["Category", "Allocated", "Spent", "Remaining"],
-        rows=[
-            ["Digital Ads", "$15,000", "$3,200", "$11,800"],
-            ["Content Creation", "$8,000", "$1,500", "$6,500"],
-            ["Events", "$12,000", "$0", "$12,000"]
-        ]
-    )
-    .divider()
-    .toggle("Technical Requirements", lambda toggle: (
-        toggle
-        .paragraph("Platform specifications and integration details.")
-        .bulleted_list([
-            "CRM integration with Salesforce",
-            "Analytics tracking setup",
-            "Landing page development"
-        ])
-    ))
-))
-
-print(f"✅ Created styled project: {project.url}")
-```
-
-### Extended Markdown Syntax
-
-Notionary supports rich formatting with callouts, toggles, multi-column layouts, tables, media embeds, and more. Use either direct markdown syntax or the type-safe builder pattern.
-
-See the complete [Block Types documentation](https://mathisarends.github.io/notionary/blocks/) for all available formatting options and syntax examples.
-
-## What You Can Build
-
-- **AI Content Generation** - Perfect for AI agents that create structured reports and documentation
-- **Workflow Automation** - Update project status, sync data between databases, generate reports
-- **Dynamic Documentation** - Auto-generate team docs, API references, and knowledge bases
-- **Content Management** - Bulk page updates, template generation, and content migration
-
-## Core Features
-
-| Feature              | Description                                            |
-| -------------------- | ------------------------------------------------------ |
-| **Smart Discovery**  | Find pages/databases by name with fuzzy matching       |
-| **Rich Markdown**    | Extended syntax for callouts, toggles, columns, tables |
-| **Async-First**      | Modern Python with full async/await support            |
-| **Round-Trip**       | Read content as markdown, edit, and write back         |
-| **AI-Ready**         | Generate system prompts for AI content creation        |
-| **All Block Types**  | Support for every Notion block type                    |
-| **Type Safety**      | Full type hints for better IDE support                 |
-| **High Performance** | Efficient batch operations and caching                 |
-
-## Examples & Documentation
-
-Explore comprehensive guides and real-world examples:
-
-- **[📖 Full Documentation](https://mathisarends.github.io/notionary/)** - Complete API reference and guides
-- **[Getting Started](https://mathisarends.github.io/notionary/get-started/)** - Quick setup and first steps
-- **[Page Management](https://mathisarends.github.io/notionary/page/)** - Work with page content and properties
-- **[Database Operations](https://mathisarends.github.io/notionary/database/)** - Query and manage databases
-- **[Block Types](https://mathisarends.github.io/notionary/blocks/)** - Complete formatting reference
-
-Check out the `examples/` directory for hands-on tutorials:
-
-### Core Examples
-
-- **[Page Management](examples/page_example.py)** - Create, update, and manage pages
-- **[Database Operations](examples/database.py)** - Connect to and query databases
-- **[Workspace Discovery](examples/workspace_discovery.py)** - Explore your workspace
-
-### Markdown Examples
-
-- **[Basic Formatting](examples/markdown/basic.py)** - Text, lists, and links
-- **[Callouts](examples/markdown/callout.py)** - Eye-catching information boxes
-- **[Toggles](examples/markdown/toggle.py)** - Collapsible content sections
-- **[Multi-Column](examples/markdown/columns.py)** - Side-by-side layouts
-- **[Tables](examples/markdown/table.py)** - Structured data presentation
-
-## Contributing
-
-We'd love your help making Notionary even better!
-
-Whether it's fixing bugs, adding features, improving docs, or sharing examples - all contributions are welcome.
-
-See our [Contributing Guide](https://mathisarends.github.io/notionary/contributing/) to get started.
-
----
-
-<div align="center">
-
-**Ready to transform your Notion workflow?**
-
-[📖 Read the Docs](https://mathisarends.github.io/notionary/) • [Getting Started](https://mathisarends.github.io/notionary/get-started/) • [Examples](examples/)
-
-Built with ❤️ for the Python community
-
-</div>
-