
Paragraph Margins: Visual Guide to Proper Spacing
A comprehensive demonstration of paragraph spacing for optimal readability

Heading Margins: Visual Guide to Proper Spacing
A comprehensive demonstration of heading spacing for optimal readability

List Margins: Visual Guide to Proper Spacing
A comprehensive demonstration of list spacing for optimal readability
<100 subscribers



Paragraph Margins: Visual Guide to Proper Spacing
A comprehensive demonstration of paragraph spacing for optimal readability

Heading Margins: Visual Guide to Proper Spacing
A comprehensive demonstration of heading spacing for optimal readability

List Margins: Visual Guide to Proper Spacing
A comprehensive demonstration of list spacing for optimal readability
Share Dialog
Share Dialog
This guide illustrates the correct margin specifications between embedded content and various other elements. Each example precisely demonstrates the pixel measurements needed to maintain proper visual hierarchy and readability.
This paragraph precedes an embedded element. When transitioning from paragraph text to an embed, we use a 32px margin. This larger spacing acknowledges the significant visual shift that occurs when moving from text to embedded content. The 32px margin provides enough space for the reader's eye to transition between your content and the embedded external content.
This paragraph appears 32px below the embedded content above. When returning to paragraph text after an embed, we maintain the same 32px spacing to create symmetry in the document's vertical rhythm. Embeds create significant visual breaks in content, so the larger margin helps re-establish the reading rhythm when returning to text.
The 24px spacing between a heading and an embed follows the same pattern as heading-to-content spacing throughout the document. This creates consistency while acknowledging that the embed is content that belongs to the heading above it.
The 40px spacing before a heading creates a clear section break, regardless of what content type precedes it. This consistent approach to section transitions improves content structure and readability, particularly when an embed concludes one section before moving to a new topic.
This list precedes an embedded element
When transitioning from a list to an embed
We use a 32px margin
This acknowledges the stronger visual break that embeds create
This list appears 32px below the embedded content
The increased spacing helps transition from third-party to native content
While maintaining the overall document flow
Each content type receives appropriate spacing based on its visual weight
javascript// Placeholder code
const margins = {
standard: 24, // text elements
visual: 32, // images, tables, embeds
section: 40 // headings, dividers
};
console.log(`Embed margins: ${margins.visual}px`);javascript// Placeholder code
const margins = {
standard: 24, // text elements
visual: 32, // images, tables, embeds
section: 40 // headings, dividers
};
console.log(`Embed margins: ${margins.visual}px`);

Table header | Table header |
|---|---|
Table row | Table row |
Table header | Table header |
|---|---|
Table row | Table row |
Multiple embeds in sequence need clear separation to be perceived as distinct elements:
The 40px spacing between consecutive embeds creates sufficient separation to indicate these are distinct elements, preventing them from visually merging into a single unit.
Note the 40px spacing between the divider and the embed. Dividers signal significant breaks in content, so the larger margin helps establish a clear separation between sections.
The 40px spacing from an embed to a divider creates a clear section break. This larger margin is used consistently for transitions between major content sections.
This visual guide demonstrates all embed margin specifications within our typography system:
Text Elements to/from Embed:
Paragraph to/from Embed: 32px
List to/from Embed: 32px
Code Block to/from Embed: 32px
Heading to Embed: 24px
Visual Elements to/from Embed:
Image to/from Embed: 32px
Table to/from Embed: 32px
Embed to Embed: 40px
Embed-Specific Spacing:
Embed to Caption: 12px
Embed Caption to Next Element: 24px (except headings: 40px)
Section Transitions:
Embed to Heading: 40px
Divider to/from Embed: 40px
These margin specifications create a balanced visual rhythm that enhances the reader's experience by:
Providing appropriate transitions between native and embedded content
Creating clear separation between distinct embedded elements
Maintaining consistent document flow
Supporting intuitive content hierarchy
Improving overall readability and content integration
Consistent application of these spacing guidelines helps readers process embedded content more effectively while maintaining the overall flow of the document.
This guide illustrates the correct margin specifications between embedded content and various other elements. Each example precisely demonstrates the pixel measurements needed to maintain proper visual hierarchy and readability.
This paragraph precedes an embedded element. When transitioning from paragraph text to an embed, we use a 32px margin. This larger spacing acknowledges the significant visual shift that occurs when moving from text to embedded content. The 32px margin provides enough space for the reader's eye to transition between your content and the embedded external content.
This paragraph appears 32px below the embedded content above. When returning to paragraph text after an embed, we maintain the same 32px spacing to create symmetry in the document's vertical rhythm. Embeds create significant visual breaks in content, so the larger margin helps re-establish the reading rhythm when returning to text.
The 24px spacing between a heading and an embed follows the same pattern as heading-to-content spacing throughout the document. This creates consistency while acknowledging that the embed is content that belongs to the heading above it.
The 40px spacing before a heading creates a clear section break, regardless of what content type precedes it. This consistent approach to section transitions improves content structure and readability, particularly when an embed concludes one section before moving to a new topic.
This list precedes an embedded element
When transitioning from a list to an embed
We use a 32px margin
This acknowledges the stronger visual break that embeds create
This list appears 32px below the embedded content
The increased spacing helps transition from third-party to native content
While maintaining the overall document flow
Each content type receives appropriate spacing based on its visual weight
javascript// Placeholder code
const margins = {
standard: 24, // text elements
visual: 32, // images, tables, embeds
section: 40 // headings, dividers
};
console.log(`Embed margins: ${margins.visual}px`);javascript// Placeholder code
const margins = {
standard: 24, // text elements
visual: 32, // images, tables, embeds
section: 40 // headings, dividers
};
console.log(`Embed margins: ${margins.visual}px`);

Table header | Table header |
|---|---|
Table row | Table row |
Table header | Table header |
|---|---|
Table row | Table row |
Multiple embeds in sequence need clear separation to be perceived as distinct elements:
The 40px spacing between consecutive embeds creates sufficient separation to indicate these are distinct elements, preventing them from visually merging into a single unit.
Note the 40px spacing between the divider and the embed. Dividers signal significant breaks in content, so the larger margin helps establish a clear separation between sections.
The 40px spacing from an embed to a divider creates a clear section break. This larger margin is used consistently for transitions between major content sections.
This visual guide demonstrates all embed margin specifications within our typography system:
Text Elements to/from Embed:
Paragraph to/from Embed: 32px
List to/from Embed: 32px
Code Block to/from Embed: 32px
Heading to Embed: 24px
Visual Elements to/from Embed:
Image to/from Embed: 32px
Table to/from Embed: 32px
Embed to Embed: 40px
Embed-Specific Spacing:
Embed to Caption: 12px
Embed Caption to Next Element: 24px (except headings: 40px)
Section Transitions:
Embed to Heading: 40px
Divider to/from Embed: 40px
These margin specifications create a balanced visual rhythm that enhances the reader's experience by:
Providing appropriate transitions between native and embedded content
Creating clear separation between distinct embedded elements
Maintaining consistent document flow
Supporting intuitive content hierarchy
Improving overall readability and content integration
Consistent application of these spacing guidelines helps readers process embedded content more effectively while maintaining the overall flow of the document.
No comments yet