Skip to content

A reactive notebook for Python — run reproducible experiments, query with SQL, execute as a script, deploy as an app, and version with git. Stored as pure Python. All in a modern, AI-native editor.

Unify Markdown typography across renderers (#10709)

Kiran Gadhave2c3a53b75626
diff --git a/frontend/e2e-tests/visual-regression.spec.ts-snapshots/edit-dark-390x720-chromium-linux.png b/frontend/e2e-tests/visual-regression.spec.ts-snapshots/edit-dark-390x720-chromium-linux.png
index c176548058..4ca564039f 100644
Binary files a/frontend/e2e-tests/visual-regression.spec.ts-snapshots/edit-dark-390x720-chromium-linux.png and b/frontend/e2e-tests/visual-regression.spec.ts-snapshots/edit-dark-390x720-chromium-linux.png differ
diff --git a/frontend/e2e-tests/visual-regression.spec.ts-snapshots/edit-light-390x720-chromium-linux.png b/frontend/e2e-tests/visual-regression.spec.ts-snapshots/edit-light-390x720-chromium-linux.png
index 690cf0b41b..bdb3ebc7e9 100644
Binary files a/frontend/e2e-tests/visual-regression.spec.ts-snapshots/edit-light-390x720-chromium-linux.png and b/frontend/e2e-tests/visual-regression.spec.ts-snapshots/edit-light-390x720-chromium-linux.png differ
diff --git a/frontend/src/components/markdown/markdown-renderer.css b/frontend/src/components/markdown/markdown-renderer.css
index f9509269b9..6683096864 100644
--- a/frontend/src/components/markdown/markdown-renderer.css
+++ b/frontend/src/components/markdown/markdown-renderer.css
@@ -1,19 +1,8 @@
+/* Tailwind scans Streamdown's compiled output for utility classes. */
+/* stylelint-disable-next-line at-rule-no-unknown */
@source "../../../node_modules/streamdown/dist/index.js";
.mo-markdown-renderer {
- /* Make headers a bit smaller */
- --text-2xl: 1rem;
- --text-3xl: 1.2rem;
-
- h1,
- h2,
- h3,
- h4,
- h5,
- h6 {
- margin-top: 10px;
- }
-
hr {
margin-top: 8px;
margin-bottom: 12px;
diff --git a/frontend/src/core/islands/main.ts b/frontend/src/core/islands/main.ts
index 386442b0e7..88bd1b4a40 100644
--- a/frontend/src/core/islands/main.ts
+++ b/frontend/src/core/islands/main.ts
@@ -2,6 +2,7 @@
import "./islands.css";
import "../../css/common.css";
import "../../css/globals.css";
+import "../../css/markdown-typography.css";
import "../../css/codehilite.css";
import "../../css/katex.min.css";
import "../../css/md.css";
diff --git a/frontend/src/css/index.css b/frontend/src/css/index.css
index e5053dfc00..63a02fb13b 100644
--- a/frontend/src/css/index.css
+++ b/frontend/src/css/index.css
@@ -1,4 +1,5 @@
@import url("./globals.css");
+@import url("./markdown-typography.css");
@import url("./codehilite.css");
@import url("./common.css");
@import url("./katex-fonts.css");
diff --git a/frontend/src/css/markdown-typography.css b/frontend/src/css/markdown-typography.css
new file mode 100644
index 0000000000..15888c853d
--- /dev/null
+++ b/frontend/src/css/markdown-typography.css
@@ -0,0 +1,51 @@
+/* Copyright 2026 Marimo. All rights reserved. */
+
+:is(.markdown, .mo-markdown-renderer) {
+ :is(h1, h2, h3, h4, h5, h6) {
+ font-family: var(--heading-font);
+ font-weight: inherit;
+ margin-block: 1.5rem 1rem;
+ line-height: 1.25;
+ }
+
+ /* Keep heading sizes relative to the renderer text size. */
+ /* stylelint-disable unit-allowed-list */
+
+ h1 {
+ font-size: 2.25em;
+ }
+
+ h2 {
+ font-size: 1.5em;
+ }
+
+ h3 {
+ font-size: 1.25em;
+ }
+
+ :is(h4, h5, h6) {
+ font-size: 1em;
+ }
+
+ /* stylelint-enable unit-allowed-list */
+
+ :is(ul, ol) > li {
+ margin-block: 0;
+ padding-block: 0;
+ }
+}
+
+:is(.markdown, .mo-markdown-renderer) table {
+ font-variant-numeric: tabular-nums;
+}
+
+:is(.markdown, .mo-markdown-renderer)
+ > :is(h1, h2, h3, h4, h5, h6, p, .paragraph, ul, ol, blockquote) {
+ max-inline-size: var(--markdown-max-width);
+}
+
+@supports (text-wrap: balance) {
+ :is(.markdown, .mo-markdown-renderer) :is(h1, h2, h3, h4, h5, h6) {
+ text-wrap: balance;
+ }
+}
diff --git a/frontend/src/css/md.css b/frontend/src/css/md.css
index ec539674fb..82dbc1cf99 100644
--- a/frontend/src/css/md.css
+++ b/frontend/src/css/md.css
@@ -12,11 +12,6 @@
margin-block-end: 0;
}
-.markdown ul li,
-.markdown ol li {
- margin-block: 0;
-}
-
/* Restore browser default bullet cycling that Tailwind Typography overrides */
.markdown ul ul {
list-style-type: revert;
@@ -41,28 +36,6 @@
margin-inline: 0;
}
-.markdown h1,
-.markdown h2,
-.markdown h3,
-.markdown h4,
-.markdown h5,
-.markdown h6 {
- font-weight: inherit;
- font-family: var(--heading-font);
-
- /*
- Anchor heading spacing to GitHub's markdown rhythm (Primer): a uniform
- 24px top / 16px bottom margin and 1.25 line-height across every level,
- letting font-size — not margin — carry the hierarchy. Tailwind Typography's
- prose defaults scale heading margins per-level up to ~2em (≈48px on h2),
- which is tuned for long-form articles and reads as too airy in a notebook.
- Ref: https://github.com/sindresorhus/github-markdown-css
- */
- margin-top: 1.5rem;
- margin-bottom: 1rem;
- line-height: 1.25;
-}
-
.markdown hr {
margin-block: 0.5rem;
}