Remove formatter recommendation section from guide

[koaning]

Removed the section on adding a formatter to the marimo repo. It's better if folks make their own viewers for their own objects.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
marimo-docs	Ready	Preview, Comment	May 20, 2026 6:24pm

[cubic-dev-ai]

No issues found across 1 file

Architecture diagram

sequenceDiagram
    participant UI as marimo UI (Client)
    participant Kernel as marimo Kernel (Server)
    participant Object as User-Defined Object
    participant Internal as marimo Core Formatters

    Note over Object, Internal: Current State: Rendering Flow

    UI->>Kernel: Request cell execution
    Kernel->>Kernel: Evaluate Python code

    Note over Kernel, Object: Protocol Discovery (Preferred Path)
    
    alt Check marimo specific display
        Kernel->>Object: call _display_()
    else Check IPython compatibility
        Kernel->>Object: call _repr_mimebundle_() or _repr_html_()
    else Check marimo mime protocol
        Kernel->>Object: call _mime_()
    end

    Object-->>Kernel: Return rich media / HTML

    opt If no protocols implemented (Legacy/Built-in Path)
        Kernel->>Internal: Lookup type in marimo/_output/formatters
        Internal-->>Kernel: Return formatted output
        Note right of Internal: CHANGED: Contributions to this<br/>directory are now discouraged.
    end

    Kernel-->>UI: Send MIME data for rendering
    UI->>UI: Render output in notebook

Loading

[Copilot]

Pull request overview

Removes documentation guidance that suggests contributing new object formatters directly to the marimo repository, aligning the guide with the stated preference that library authors/users create their own viewers/renderers.

Changes:

• Deleted the “Option 4: Add a formatter to the marimo repo” section from the integration guide.

[akshayka]

@koaning can you address this?

[koaning]

@copilot I think it's addressed now?

[Copilot]

@copilot I think it's addressed now?

Yes — this is addressed in 1572702. I rechecked docs/guides/integrating_with_marimo/displaying_objects.md, and the guide now consistently presents only 3 options with no stale “Option 4” references.

[github-actions]

🚀 Development release published. You may be able to view the changes at https://marimo.app?v=0.23.7-dev79