Skip to content

Toggle

Collapsible content section with a title. Content is nested using indentation.

Syntax

+++ Toggle Title
    Content inside toggle.
    More paragraphs, lists, etc.

Examples

+++ Advanced Configuration
    These settings are for power users only.

    - Enable debug mode
    - Set custom timeouts
    - Configure logging

Multiple toggles:

+++ FAQ: Installation
    Download and run the installer.

+++ FAQ: Troubleshooting
    Check system requirements first.

Builder

from notionary.markdown import MarkdownBuilder

markdown = (MarkdownBuilder()
  .h2("Setup Guide")
  .paragraph("Basic steps.")
  .toggle("Advanced Options", lambda t:
    t.paragraph("Power user settings.")
    .bulleted_list(["Debug mode", "Custom timeouts"])
  )
  .build())

Reference

Notion API Reference

For the official Notion API reference on toggle blocks, see https://developers.notion.com/reference/block#toggle