space below <p> tags is too big

[jencastrodoesstuff]

Summary

Paragraph and list spacing in the published docs is noticeably larger than in Notion.

Reproduction Steps

1. Author or edit content in Notion with standard paragraph and list spacing.
2. Publish the page through the usual sync workflow.
3. Compare the rendered spacing on the docs site.

Current Behavior

Rendered docs add significantly more bottom margin after paragraphs (<p>) and lists compared to Notion, so content appears more spaced out than authors intend.

Expected Behavior

Spacing between paragraphs and lists should more closely match Notion so editors can preview layout changes reliably while authoring.

Impact

The mismatch makes it difficult to predict the final layout and requires extra QA passes to achieve the intended formatting.

[luandro]

Research Notes

Key references

• Docusaurus uses the Infima design system; typography spacing is controlled by CSS variables such as --ifm-paragraph-margin-bottom and --ifm-list-margin (https://docusaurus.io/docs/styling-layout and https://infima.dev/docs/utilities/spacing/).
• Theme overrides can be applied globally in src/css/custom.css or scoped to .theme-doc-markdown to limit changes to docs content (https://docusaurus.io/docs/styling-layout#styling-your-site-with-infima).

Findings

• Default Infima spacing is 1rem (~16px) for paragraphs and list items, which is noticeably larger than Notion’s ~8px default. Matching Notion requires reducing those custom properties in docs content only.
• Lists inherit margin from paragraph settings, so overriding paragraph spacing alone may not fully align bullet/numbered lists.

Implementation directions

• Define tighter spacing tokens in a docs-specific scope to avoid affecting landing pages:

.theme-doc-markdown p {
  margin-bottom: 0.5rem;
}
.theme-doc-markdown ul,
.theme-doc-markdown ol {
  margin-bottom: 0.75rem;
}

• Alternatively, override Infima variables once and reuse them:

:root {
  --ifm-paragraph-margin-bottom: 0.5rem;
  --ifm-list-margin: 0.75rem;
}

• If we want parity measurement, capture computed margins in Notion (browser inspector) and translate to rem based on the site’s base font size (usually 16px).

Open questions / TODOs

• Should we align only docs pages or site-wide? If marketing pages depend on default spacing, prefer the scoped override.
• Validate downstream effects such as admonitions and callouts—many Infima components depend on the same spacing variables.
• Consider offering authors a preview mode reflecting the new spacing to avoid reintroducing mismatch later.