From 68def8a280b2ef1a932934b8bc9d25fb83cb3c5a Mon Sep 17 00:00:00 2001 From: vincent d warmerdam Date: Fri, 1 May 2026 18:53:19 +0200 Subject: [PATCH 1/2] Remove formatter recommendation section from guide Removed the section on adding a formatter to the marimo repo, which included recommendations for rendering rich displays of objects. --- .../integrating_with_marimo/displaying_objects.md | 14 -------------- 1 file changed, 14 deletions(-) diff --git a/docs/guides/integrating_with_marimo/displaying_objects.md b/docs/guides/integrating_with_marimo/displaying_objects.md index 450a8800c37..e7dba1ada57 100644 --- a/docs/guides/integrating_with_marimo/displaying_objects.md +++ b/docs/guides/integrating_with_marimo/displaying_objects.md @@ -143,17 +143,3 @@ def __(): ``` /// - -## Option 4: Add a formatter to the marimo repo - -The recommended way to render rich displays of objects in marimo is to -implement `_display_` if possible, otherwise either the IPython `_repr_*_()_` -protocol or marimo's `_mime_()` protocol. If you are a a user of a library that -does not render properly in marimo, consider asking the library maintainers to -implement one of these protocols. - -If it is not possible to implement a renderer protocol on the type -you want displayed, we will consider contributions to add formatters to the -marimo codebase. [Look at our codebase for -examples](https://github.com/marimo-team/marimo/tree/main/marimo/_output/formatters), -then open a pull request. From 157270278cbfe4c0c946cccd413e79c7fd151a82 Mon Sep 17 00:00:00 2001 From: vincent d warmerdam Date: Wed, 20 May 2026 20:23:48 +0200 Subject: [PATCH 2/2] Clarify object display method implementation steps Removed option 4 regarding adding a formatter to the marimo library. --- docs/guides/integrating_with_marimo/displaying_objects.md | 2 -- 1 file changed, 2 deletions(-) diff --git a/docs/guides/integrating_with_marimo/displaying_objects.md b/docs/guides/integrating_with_marimo/displaying_objects.md index e7dba1ada57..df106b27673 100644 --- a/docs/guides/integrating_with_marimo/displaying_objects.md +++ b/docs/guides/integrating_with_marimo/displaying_objects.md @@ -14,8 +14,6 @@ three options: 2. Implement a `_mime_()` method 3. Implement an IPython-style `_repr_*_()` method -If you can't modify the object, you can also add a formatter to the marimo library (option 4). - The return value of these methods determines what is shown. `_display_` has the highest precedence, then built-in formatters, then `_mime_`, then `IPython` style `_repr_*_` methods.