notionary 0.1.17__tar.gz → 0.1.18__tar.gz

{notionary-0.1.17 → notionary-0.1.18}/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: notionary
-Version: 0.1.17
+Version: 0.1.18
 Summary: A toolkit to convert between Markdown and Notion blocks
 Home-page: https://github.com/mathisarends/notionary
 Author: Mathis Arends
@@ -33,12 +33,14 @@ Dynamic: summary
 [![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)
 
-**Notionary** is a powerful Python library for interacting with the Notion API, making it easy to create, update, and manage Notion pages and databases programmatically with a clean, intuitive interface.
+**Notionary** is a powerful Python library for interacting with the Notion API, making it easy to create, update, and manage Notion pages and databases programmatically with a clean, intuitive interface. It's specifically designed to be the foundation for AI-driven Notion content generation.
 
 ## Features
 
-- **Rich Markdown Support**: Write Notion pages using intuitive Markdown syntax with custom extensions
+- **Rich Markdown Support**: Create Notion pages using intuitive Markdown syntax with custom extensions
 - **Dynamic Database Operations**: Create, update, and query database entries with schema auto-detection
+- **Extensible Block Registry**: Add, customize, or remove Notion block elements with a flexible registry pattern
+- **LLM-Ready Prompts**: Generate system prompts explaining Markdown syntax for LLMs to create Notion content
 - **Async-First Design**: Built for modern Python with full async/await support
 - **Schema-Based Validation**: Automatic property validation based on database schemas
 - **Intelligent Content Conversion**: Bidirectional conversion between Markdown and Notion blocks
@@ -56,7 +58,7 @@ Notionary extends standard Markdown with special syntax to support Notion-specif
 ### Text Formatting
 
 - Standard Markdown: `**bold**`, `*italic*`, `~~strikethrough~~`, `` `code` ``
-- Highlights: `==highlighted text==`, `==red warning==`, `==blue==`
+- Highlights: `==highlighted text==`, `==red:warning==`, `==blue:note==`
 
 ### Block Elements
 
@@ -111,50 +113,43 @@ Notionary makes it easy to work with Notion databases, automatically handling sc
 
 ```python
 import asyncio
-from notionary.core.database.notion_database_manager import NotionDatabaseManager
+from notionary import NotionDatabaseFactory
 
 async def main():
-    database_id = "1a6389d5-7bd3-8097-aa38-e93cb052615a"
-    db = NotionDatabaseManager(database_id)
-    await db.initialize()
+    # Find database by name with fuzzy matching
+    db_manager = await NotionDatabaseFactory.from_database_name("Projects")
 
+    # Create a new page with properties
     properties = {
         "Title": "Created via Notionary",
-        "Description": "This entry was created using Notionary.",
         "Status": "In Progress",
         "Priority": "High"
     }
 
-    result = await db.create_page(properties)
+    page = await db_manager.create_blank_page()
 
-    if result["success"]:
-        page_id = result["page_id"]
-        await db.update_page(page_id, {"Status": "Completed"})
+    # Set page content with rich Markdown
+    await page.set_title("My New Project")
+    await page.set_page_icon(emoji="🚀")
 
-    filter_conditions = {
-        "property": "Status",
-        "status": {"equals": "Completed"}
-    }
+    markdown = """
+    # Project Overview
 
-    pages = await db.get_pages(limit=10, filter_conditions=filter_conditions)
+    !> [💡] This page was created programmatically using Notionary.
 
-    await db.close()
+    ## Tasks
+    - [ ] Define project scope
+    - [ ] Create timeline
+    - [ ] Assign resources
 
-if __name__ == "__main__":
-    asyncio.run(main())
-```
-
-## Finding Databases by Name
-
-Use fuzzy matching to find databases:
+    +++ Implementation Details
+      This project will use our standard architecture with custom extensions.
+    """
 
-```python
-from notionary.core.database.notion_database_manager_factory import NotionDatabaseFactory
+    await page.replace_content(markdown)
 
-async def main():
-    db_manager = await NotionDatabaseFactory.from_database_name("Projects")
-    print(f"Found database: {db_manager.title}")
-    await db_manager.close()
+if __name__ == "__main__":
+    asyncio.run(main())
 ```
 
 ## Page Content Management
@@ -162,11 +157,11 @@ async def main():
 Create rich Notion pages using enhanced Markdown:
 
 ```python
-from notionary.core.page.notion_page_manager import NotionPageManager
+from notionary import NotionPage
 
 async def create_rich_page():
     url = "https://www.notion.so/Your-Page-1cd389d57bd381e58be9d35ce24adf3d"
-    page_manager = NotionPageManager(url=url)
+    page_manager = NotionPage(url=url)
 
     await page_manager.set_title("Notionary Demo")
     await page_manager.set_page_icon(emoji="✨")
@@ -190,20 +185,71 @@ async def create_rich_page():
     await page_manager.replace_content(markdown)
 ```
 
-## Perfect for AI Agents and Automation
+## Block Registry & Builder
 
-- **Dynamic Content Generation**: AI agents can generate content in Markdown and render it as Notion pages
-- **Schema-Aware Operations**: Automatically validate and format properties
-- **Simplified API**: Easier integration with AI workflows
+Notionary uses a flexible registry pattern with a builder to customize which Notion elements are supported, allowing programmatic creation of complex UI layouts that were previously only possible through Notion's UI:
+
+```python
+from notionary import NotionPage
+from notionary.elements.block_element_registry_builder import BlockElementRegistryBuilder
+
+# Create a registry with standard Notion elements
+registry = BlockElementRegistryBuilder.create_standard_registry()
+
+# Or build a custom registry with only the elements you need
+custom_registry = (
+    BlockElementRegistryBuilder()
+    .with_headings()
+    .with_callouts()
+    .with_toggles()
+    .with_lists()
+    .with_tables()
+    .with_paragraphs()
+    .build()
+)
+
+# Apply this registry to a page to enable custom Markdown support
+page = NotionPage(url="https://www.notion.so/your-page-url")
+page.block_registry = custom_registry
+
+# Now your page supports exactly the elements you've defined
+await page.replace_content("# Custom heading with only selected elements")
+```
+
+This registry approach gives you granular control over which Notion UI elements can be created through Markdown, making it possible to programmatically construct any page layout that would normally require manual UI interaction.
+
+## AI-Ready LLM Prompt Generation
+
+Notionary can automatically generate comprehensive system prompts for LLMs to understand Notion's custom Markdown syntax:
+
+```python
+from notionary.elements.block_element_registry_builder import BlockElementRegistryBuilder
+
+registry = BlockElementRegistryBuilder.create_standard_registry()
+llm_system_prompt = registry.generate_llm_prompt()
+
+# Use this prompt with your LLM to generate Notion-compatible Markdown
+print(llm_system_prompt)
+```
+
+This makes Notionary the perfect foundation for AI-driven Notion content generation, enabling LLMs to create properly formatted Notion pages.
 
 ## Examples
 
-See the `examples` folder for:
+See the [examples folder](examples/) for more comprehensive demonstrations:
+
+- [Database discovery and querying](examples/database_discovery_example.py)
+- [Rich page creation with Markdown](examples/page_example.py)
+- [Database factory usage](examples/database_factory_example.py)
+- [Page lookup and access](examples/page_factory_by_url_example.py)
+- [Iterating through database entries](examples/iter_database_example.py)
+
+## Perfect for AI Agents and Automation
 
-- Database discovery and querying
-- Rich page creation with Markdown
-- Entry management
-- Metadata manipulation
+- **LLM Integration**: Generate Notion-compatible content with LLMs using the system prompt generator
+- **Dynamic Content Generation**: AI agents can generate content in Markdown and render it as Notion pages
+- **Schema-Aware Operations**: Automatically validate and format properties
+- **Simplified API**: Easier integration with AI workflows
 
 ## License
 

notionary-0.1.18/README.md

@@ -0,0 +1,230 @@
+# Notionary 📝
+
+[![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)
+
+**Notionary** is a powerful Python library for interacting with the Notion API, making it easy to create, update, and manage Notion pages and databases programmatically with a clean, intuitive interface. It's specifically designed to be the foundation for AI-driven Notion content generation.
+
+## Features
+
+- **Rich Markdown Support**: Create Notion pages using intuitive Markdown syntax with custom extensions
+- **Dynamic Database Operations**: Create, update, and query database entries with schema auto-detection
+- **Extensible Block Registry**: Add, customize, or remove Notion block elements with a flexible registry pattern
+- **LLM-Ready Prompts**: Generate system prompts explaining Markdown syntax for LLMs to create Notion content
+- **Async-First Design**: Built for modern Python with full async/await support
+- **Schema-Based Validation**: Automatic property validation based on database schemas
+- **Intelligent Content Conversion**: Bidirectional conversion between Markdown and Notion blocks
+
+## Installation
+
+```bash
+pip install notionary
+```
+
+## Custom Markdown Syntax
+
+Notionary extends standard Markdown with special syntax to support Notion-specific features:
+
+### Text Formatting
+
+- Standard Markdown: `**bold**`, `*italic*`, `~~strikethrough~~`, `` `code` ``
+- Highlights: `==highlighted text==`, `==red:warning==`, `==blue:note==`
+
+### Block Elements
+
+#### Callouts
+
+```markdown
+!> [💡] This is a default callout with the light bulb emoji  
+!> [🔔] This is a callout with a bell emoji  
+!> {blue_background} [💧] This is a blue callout with a water drop emoji  
+!> {yellow_background} [⚠️] Warning: This is an important note
+```
+
+#### Toggles
+
+```markdown
++++ How to use NotionPageManager
+
+1. Initialize with NotionPageManager
+2. Update metadata with set_title(), set_page_icon(), etc.
+3. Add content with replace_content() or append_markdown()
+```
+
+#### Bookmarks
+
+```markdown
+[bookmark](https://notion.so "Notion Homepage" "Your connected workspace")
+```
+
+#### Multi-Column Layouts
+
+```markdown
+::: columns
+::: column
+Content for first column
+:::
+::: column
+Content for second column
+:::
+:::
+```
+
+And more:
+
+- Tables with standard Markdown syntax
+- Code blocks with syntax highlighting
+- To-do lists with `- [ ]` and `- [x]`
+- Block quotes with `>`
+
+## Database Management
+
+Notionary makes it easy to work with Notion databases, automatically handling schema detection and property conversion:
+
+```python
+import asyncio
+from notionary import NotionDatabaseFactory
+
+async def main():
+    # Find database by name with fuzzy matching
+    db_manager = await NotionDatabaseFactory.from_database_name("Projects")
+
+    # Create a new page with properties
+    properties = {
+        "Title": "Created via Notionary",
+        "Status": "In Progress",
+        "Priority": "High"
+    }
+
+    page = await db_manager.create_blank_page()
+
+    # Set page content with rich Markdown
+    await page.set_title("My New Project")
+    await page.set_page_icon(emoji="🚀")
+
+    markdown = """
+    # Project Overview
+
+    !> [💡] This page was created programmatically using Notionary.
+
+    ## Tasks
+    - [ ] Define project scope
+    - [ ] Create timeline
+    - [ ] Assign resources
+
+    +++ Implementation Details
+      This project will use our standard architecture with custom extensions.
+    """
+
+    await page.replace_content(markdown)
+
+if __name__ == "__main__":
+    asyncio.run(main())
+```
+
+## Page Content Management
+
+Create rich Notion pages using enhanced Markdown:
+
+```python
+from notionary import NotionPage
+
+async def create_rich_page():
+    url = "https://www.notion.so/Your-Page-1cd389d57bd381e58be9d35ce24adf3d"
+    page_manager = NotionPage(url=url)
+
+    await page_manager.set_title("Notionary Demo")
+    await page_manager.set_page_icon(emoji="✨")
+    await page_manager.set_page_cover("https://images.unsplash.com/photo-1555066931-4365d14bab8c")
+
+    markdown = '''
+    # Notionary Rich Content Demo
+
+    !> [💡] This page was created with Notionary's custom Markdown syntax.
+
+    ## Features
+    - Easy-to-use Python API
+    - **Rich** Markdown support
+    - Async functionality
+
+    +++ Implementation Details
+      Notionary uses a custom converter to transform Markdown into Notion blocks.
+      This makes it easy to create rich content programmatically.
+    '''
+
+    await page_manager.replace_content(markdown)
+```
+
+## Block Registry & Builder
+
+Notionary uses a flexible registry pattern with a builder to customize which Notion elements are supported, allowing programmatic creation of complex UI layouts that were previously only possible through Notion's UI:
+
+```python
+from notionary import NotionPage
+from notionary.elements.block_element_registry_builder import BlockElementRegistryBuilder
+
+# Create a registry with standard Notion elements
+registry = BlockElementRegistryBuilder.create_standard_registry()
+
+# Or build a custom registry with only the elements you need
+custom_registry = (
+    BlockElementRegistryBuilder()
+    .with_headings()
+    .with_callouts()
+    .with_toggles()
+    .with_lists()
+    .with_tables()
+    .with_paragraphs()
+    .build()
+)
+
+# Apply this registry to a page to enable custom Markdown support
+page = NotionPage(url="https://www.notion.so/your-page-url")
+page.block_registry = custom_registry
+
+# Now your page supports exactly the elements you've defined
+await page.replace_content("# Custom heading with only selected elements")
+```
+
+This registry approach gives you granular control over which Notion UI elements can be created through Markdown, making it possible to programmatically construct any page layout that would normally require manual UI interaction.
+
+## AI-Ready LLM Prompt Generation
+
+Notionary can automatically generate comprehensive system prompts for LLMs to understand Notion's custom Markdown syntax:
+
+```python
+from notionary.elements.block_element_registry_builder import BlockElementRegistryBuilder
+
+registry = BlockElementRegistryBuilder.create_standard_registry()
+llm_system_prompt = registry.generate_llm_prompt()
+
+# Use this prompt with your LLM to generate Notion-compatible Markdown
+print(llm_system_prompt)
+```
+
+This makes Notionary the perfect foundation for AI-driven Notion content generation, enabling LLMs to create properly formatted Notion pages.
+
+## Examples
+
+See the [examples folder](examples/) for more comprehensive demonstrations:
+
+- [Database discovery and querying](examples/database_discovery_example.py)
+- [Rich page creation with Markdown](examples/page_example.py)
+- [Database factory usage](examples/database_factory_example.py)
+- [Page lookup and access](examples/page_factory_by_url_example.py)
+- [Iterating through database entries](examples/iter_database_example.py)
+
+## Perfect for AI Agents and Automation
+
+- **LLM Integration**: Generate Notion-compatible content with LLMs using the system prompt generator
+- **Dynamic Content Generation**: AI agents can generate content in Markdown and render it as Notion pages
+- **Schema-Aware Operations**: Automatically validate and format properties
+- **Simplified API**: Easier integration with AI workflows
+
+## License
+
+MIT
+
+## Contributing
+
+Contributions welcome — feel free to submit a pull request!

{notionary-0.1.17 → notionary-0.1.18}/notionary/database/notion_database.py

@@ -217,6 +217,26 @@ class NotionDatabase(LoggingMixin):
             self.logger.error("Error in delete_page: %s", str(e))
             return {"success": False, "message": f"Error: {str(e)}"}
 
+    async def get_last_edited_time(self) -> Optional[str]:
+        """
+        Retrieve the last edited time of the database.
+
+        Returns:
+            ISO 8601 timestamp string of the last database edit, or None if request fails
+        """
+        try:
+            response = await self._client.get(f"databases/{self.database_id}")
+
+            if response and "last_edited_time" in response:
+                return response["last_edited_time"]
+
+            self.logger.warning("Could not retrieve last_edited_time for database %s", self.database_id)
+            return None
+
+        except Exception as e:
+            self.logger.error("Error fetching last_edited_time: %s", str(e))
+            return None
+
     async def close(self) -> None:
         """Close the client connection."""
         await self._client.close()

{notionary-0.1.17 → notionary-0.1.18}/notionary.egg-info/PKG-INFO

@@ -1,6 +1,6 @@
 Metadata-Version: 2.4
 Name: notionary
-Version: 0.1.17
+Version: 0.1.18
 Summary: A toolkit to convert between Markdown and Notion blocks
 Home-page: https://github.com/mathisarends/notionary
 Author: Mathis Arends
@@ -33,12 +33,14 @@ Dynamic: summary
 [![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)
 
-**Notionary** is a powerful Python library for interacting with the Notion API, making it easy to create, update, and manage Notion pages and databases programmatically with a clean, intuitive interface.
+**Notionary** is a powerful Python library for interacting with the Notion API, making it easy to create, update, and manage Notion pages and databases programmatically with a clean, intuitive interface. It's specifically designed to be the foundation for AI-driven Notion content generation.
 
 ## Features
 
-- **Rich Markdown Support**: Write Notion pages using intuitive Markdown syntax with custom extensions
+- **Rich Markdown Support**: Create Notion pages using intuitive Markdown syntax with custom extensions
 - **Dynamic Database Operations**: Create, update, and query database entries with schema auto-detection
+- **Extensible Block Registry**: Add, customize, or remove Notion block elements with a flexible registry pattern
+- **LLM-Ready Prompts**: Generate system prompts explaining Markdown syntax for LLMs to create Notion content
 - **Async-First Design**: Built for modern Python with full async/await support
 - **Schema-Based Validation**: Automatic property validation based on database schemas
 - **Intelligent Content Conversion**: Bidirectional conversion between Markdown and Notion blocks
@@ -56,7 +58,7 @@ Notionary extends standard Markdown with special syntax to support Notion-specif
 ### Text Formatting
 
 - Standard Markdown: `**bold**`, `*italic*`, `~~strikethrough~~`, `` `code` ``
-- Highlights: `==highlighted text==`, `==red warning==`, `==blue==`
+- Highlights: `==highlighted text==`, `==red:warning==`, `==blue:note==`
 
 ### Block Elements
 
@@ -111,50 +113,43 @@ Notionary makes it easy to work with Notion databases, automatically handling sc
 
 ```python
 import asyncio
-from notionary.core.database.notion_database_manager import NotionDatabaseManager
+from notionary import NotionDatabaseFactory
 
 async def main():
-    database_id = "1a6389d5-7bd3-8097-aa38-e93cb052615a"
-    db = NotionDatabaseManager(database_id)
-    await db.initialize()
+    # Find database by name with fuzzy matching
+    db_manager = await NotionDatabaseFactory.from_database_name("Projects")
 
+    # Create a new page with properties
     properties = {
         "Title": "Created via Notionary",
-        "Description": "This entry was created using Notionary.",
         "Status": "In Progress",
         "Priority": "High"
     }
 
-    result = await db.create_page(properties)
+    page = await db_manager.create_blank_page()
 
-    if result["success"]:
-        page_id = result["page_id"]
-        await db.update_page(page_id, {"Status": "Completed"})
+    # Set page content with rich Markdown
+    await page.set_title("My New Project")
+    await page.set_page_icon(emoji="🚀")
 
-    filter_conditions = {
-        "property": "Status",
-        "status": {"equals": "Completed"}
-    }
+    markdown = """
+    # Project Overview
 
-    pages = await db.get_pages(limit=10, filter_conditions=filter_conditions)
+    !> [💡] This page was created programmatically using Notionary.
 
-    await db.close()
+    ## Tasks
+    - [ ] Define project scope
+    - [ ] Create timeline
+    - [ ] Assign resources
 
-if __name__ == "__main__":
-    asyncio.run(main())
-```
-
-## Finding Databases by Name
-
-Use fuzzy matching to find databases:
+    +++ Implementation Details
+      This project will use our standard architecture with custom extensions.
+    """
 
-```python
-from notionary.core.database.notion_database_manager_factory import NotionDatabaseFactory
+    await page.replace_content(markdown)
 
-async def main():
-    db_manager = await NotionDatabaseFactory.from_database_name("Projects")
-    print(f"Found database: {db_manager.title}")
-    await db_manager.close()
+if __name__ == "__main__":
+    asyncio.run(main())
 ```
 
 ## Page Content Management
@@ -162,11 +157,11 @@ async def main():
 Create rich Notion pages using enhanced Markdown:
 
 ```python
-from notionary.core.page.notion_page_manager import NotionPageManager
+from notionary import NotionPage
 
 async def create_rich_page():
     url = "https://www.notion.so/Your-Page-1cd389d57bd381e58be9d35ce24adf3d"
-    page_manager = NotionPageManager(url=url)
+    page_manager = NotionPage(url=url)
 
     await page_manager.set_title("Notionary Demo")
     await page_manager.set_page_icon(emoji="✨")
@@ -190,20 +185,71 @@ async def create_rich_page():
     await page_manager.replace_content(markdown)
 ```
 
-## Perfect for AI Agents and Automation
+## Block Registry & Builder
 
-- **Dynamic Content Generation**: AI agents can generate content in Markdown and render it as Notion pages
-- **Schema-Aware Operations**: Automatically validate and format properties
-- **Simplified API**: Easier integration with AI workflows
+Notionary uses a flexible registry pattern with a builder to customize which Notion elements are supported, allowing programmatic creation of complex UI layouts that were previously only possible through Notion's UI:
+
+```python
+from notionary import NotionPage
+from notionary.elements.block_element_registry_builder import BlockElementRegistryBuilder
+
+# Create a registry with standard Notion elements
+registry = BlockElementRegistryBuilder.create_standard_registry()
+
+# Or build a custom registry with only the elements you need
+custom_registry = (
+    BlockElementRegistryBuilder()
+    .with_headings()
+    .with_callouts()
+    .with_toggles()
+    .with_lists()
+    .with_tables()
+    .with_paragraphs()
+    .build()
+)
+
+# Apply this registry to a page to enable custom Markdown support
+page = NotionPage(url="https://www.notion.so/your-page-url")
+page.block_registry = custom_registry
+
+# Now your page supports exactly the elements you've defined
+await page.replace_content("# Custom heading with only selected elements")
+```
+
+This registry approach gives you granular control over which Notion UI elements can be created through Markdown, making it possible to programmatically construct any page layout that would normally require manual UI interaction.
+
+## AI-Ready LLM Prompt Generation
+
+Notionary can automatically generate comprehensive system prompts for LLMs to understand Notion's custom Markdown syntax:
+
+```python
+from notionary.elements.block_element_registry_builder import BlockElementRegistryBuilder
+
+registry = BlockElementRegistryBuilder.create_standard_registry()
+llm_system_prompt = registry.generate_llm_prompt()
+
+# Use this prompt with your LLM to generate Notion-compatible Markdown
+print(llm_system_prompt)
+```
+
+This makes Notionary the perfect foundation for AI-driven Notion content generation, enabling LLMs to create properly formatted Notion pages.
 
 ## Examples
 
-See the `examples` folder for:
+See the [examples folder](examples/) for more comprehensive demonstrations:
+
+- [Database discovery and querying](examples/database_discovery_example.py)
+- [Rich page creation with Markdown](examples/page_example.py)
+- [Database factory usage](examples/database_factory_example.py)
+- [Page lookup and access](examples/page_factory_by_url_example.py)
+- [Iterating through database entries](examples/iter_database_example.py)
+
+## Perfect for AI Agents and Automation
 
-- Database discovery and querying
-- Rich page creation with Markdown
-- Entry management
-- Metadata manipulation
+- **LLM Integration**: Generate Notion-compatible content with LLMs using the system prompt generator
+- **Dynamic Content Generation**: AI agents can generate content in Markdown and render it as Notion pages
+- **Schema-Aware Operations**: Automatically validate and format properties
+- **Simplified API**: Easier integration with AI workflows
 
 ## License
 

{notionary-0.1.17 → notionary-0.1.18}/setup.py

@@ -2,7 +2,7 @@ from setuptools import setup, find_namespace_packages
 
 setup(
     name="notionary",
-    version="0.1.17",
+    version="0.1.18",
     packages=find_namespace_packages(include=["notionary*"]),
     install_requires=[
         "notion-client>=2.0.0",

notionary-0.1.17/README.md

@@ -1,184 +0,0 @@
-# Notionary 📝
-
-[![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)
-
-**Notionary** is a powerful Python library for interacting with the Notion API, making it easy to create, update, and manage Notion pages and databases programmatically with a clean, intuitive interface.
-
-## Features
-
-- **Rich Markdown Support**: Write Notion pages using intuitive Markdown syntax with custom extensions
-- **Dynamic Database Operations**: Create, update, and query database entries with schema auto-detection
-- **Async-First Design**: Built for modern Python with full async/await support
-- **Schema-Based Validation**: Automatic property validation based on database schemas
-- **Intelligent Content Conversion**: Bidirectional conversion between Markdown and Notion blocks
-
-## Installation
-
-```bash
-pip install notionary
-```
-
-## Custom Markdown Syntax
-
-Notionary extends standard Markdown with special syntax to support Notion-specific features:
-
-### Text Formatting
-
-- Standard Markdown: `**bold**`, `*italic*`, `~~strikethrough~~`, `` `code` ``
-- Highlights: `==highlighted text==`, `==red warning==`, `==blue==`
-
-### Block Elements
-
-#### Callouts
-
-```markdown
-!> [💡] This is a default callout with the light bulb emoji  
-!> [🔔] This is a callout with a bell emoji  
-!> {blue_background} [💧] This is a blue callout with a water drop emoji  
-!> {yellow_background} [⚠️] Warning: This is an important note
-```
-
-#### Toggles
-
-```markdown
-+++ How to use NotionPageManager
-
-1. Initialize with NotionPageManager
-2. Update metadata with set_title(), set_page_icon(), etc.
-3. Add content with replace_content() or append_markdown()
-```
-
-#### Bookmarks
-
-```markdown
-[bookmark](https://notion.so "Notion Homepage" "Your connected workspace")
-```
-
-#### Multi-Column Layouts
-
-```markdown
-::: columns
-::: column
-Content for first column
-:::
-::: column
-Content for second column
-:::
-:::
-```
-
-And more:
-
-- Tables with standard Markdown syntax
-- Code blocks with syntax highlighting
-- To-do lists with `- [ ]` and `- [x]`
-- Block quotes with `>`
-
-## Database Management
-
-Notionary makes it easy to work with Notion databases, automatically handling schema detection and property conversion:
-
-```python
-import asyncio
-from notionary.core.database.notion_database_manager import NotionDatabaseManager
-
-async def main():
-    database_id = "1a6389d5-7bd3-8097-aa38-e93cb052615a"
-    db = NotionDatabaseManager(database_id)
-    await db.initialize()
-
-    properties = {
-        "Title": "Created via Notionary",
-        "Description": "This entry was created using Notionary.",
-        "Status": "In Progress",
-        "Priority": "High"
-    }
-
-    result = await db.create_page(properties)
-
-    if result["success"]:
-        page_id = result["page_id"]
-        await db.update_page(page_id, {"Status": "Completed"})
-
-    filter_conditions = {
-        "property": "Status",
-        "status": {"equals": "Completed"}
-    }
-
-    pages = await db.get_pages(limit=10, filter_conditions=filter_conditions)
-
-    await db.close()
-
-if __name__ == "__main__":
-    asyncio.run(main())
-```
-
-## Finding Databases by Name
-
-Use fuzzy matching to find databases:
-
-```python
-from notionary.core.database.notion_database_manager_factory import NotionDatabaseFactory
-
-async def main():
-    db_manager = await NotionDatabaseFactory.from_database_name("Projects")
-    print(f"Found database: {db_manager.title}")
-    await db_manager.close()
-```
-
-## Page Content Management
-
-Create rich Notion pages using enhanced Markdown:
-
-```python
-from notionary.core.page.notion_page_manager import NotionPageManager
-
-async def create_rich_page():
-    url = "https://www.notion.so/Your-Page-1cd389d57bd381e58be9d35ce24adf3d"
-    page_manager = NotionPageManager(url=url)
-
-    await page_manager.set_title("Notionary Demo")
-    await page_manager.set_page_icon(emoji="✨")
-    await page_manager.set_page_cover("https://images.unsplash.com/photo-1555066931-4365d14bab8c")
-
-    markdown = '''
-    # Notionary Rich Content Demo
-
-    !> [💡] This page was created with Notionary's custom Markdown syntax.
-
-    ## Features
-    - Easy-to-use Python API
-    - **Rich** Markdown support
-    - Async functionality
-
-    +++ Implementation Details
-      Notionary uses a custom converter to transform Markdown into Notion blocks.
-      This makes it easy to create rich content programmatically.
-    '''
-
-    await page_manager.replace_content(markdown)
-```
-
-## Perfect for AI Agents and Automation
-
-- **Dynamic Content Generation**: AI agents can generate content in Markdown and render it as Notion pages
-- **Schema-Aware Operations**: Automatically validate and format properties
-- **Simplified API**: Easier integration with AI workflows
-
-## Examples
-
-See the `examples` folder for:
-
-- Database discovery and querying
-- Rich page creation with Markdown
-- Entry management
-- Metadata manipulation
-
-## License
-
-MIT
-
-## Contributing
-
-Contributions welcome — feel free to submit a pull request!