microsoft · Jun Yan (junyan72) · Jun 20, 2026 · Jun 19, 2026 · Jun 20, 2026 · Jun 20, 2026
diff --git a/Sources/MarkdownText/Models/MarkdownRenderConfig+Builders.swift b/Sources/MarkdownText/Models/MarkdownRenderConfig+Builders.swift
@@ -17,7 +17,8 @@ extension MarkdownRenderConfig {
       tableStyle: tableStyle,
       inlineStyle: inlineStyle,
       textContextMenu: textContextMenu,
-      citationConfig: citationConfig
+      citationConfig: citationConfig,
+      blockSpacing: blockSpacing
     )
   }
 
@@ -32,7 +33,8 @@ extension MarkdownRenderConfig {
       tableStyle: tableStyle,
       inlineStyle: inlineStyle,
       textContextMenu: textContextMenu,
-      citationConfig: citationConfig
+      citationConfig: citationConfig,
+      blockSpacing: blockSpacing
     )
   }
 
@@ -47,7 +49,8 @@ extension MarkdownRenderConfig {
       tableStyle: tableStyle,
       inlineStyle: inlineStyle,
       textContextMenu: textContextMenu,
-      citationConfig: citationConfig
+      citationConfig: citationConfig,
+      blockSpacing: blockSpacing
     )
   }
 
@@ -62,7 +65,8 @@ extension MarkdownRenderConfig {
       tableStyle: tableStyle,
       inlineStyle: inlineStyle,
       textContextMenu: textContextMenu,
-      citationConfig: citationConfig
+      citationConfig: citationConfig,
+      blockSpacing: blockSpacing
     )
   }
 
@@ -77,7 +81,8 @@ extension MarkdownRenderConfig {
       tableStyle: tableStyle,
       inlineStyle: inlineStyle,
       textContextMenu: textContextMenu,
-      citationConfig: citationConfig
+      citationConfig: citationConfig,
+      blockSpacing: blockSpacing
     )
   }
 
@@ -92,7 +97,8 @@ extension MarkdownRenderConfig {
       tableStyle: value,
       inlineStyle: inlineStyle,
       textContextMenu: textContextMenu,
-      citationConfig: citationConfig
+      citationConfig: citationConfig,
+      blockSpacing: blockSpacing
     )
   }
 
@@ -107,7 +113,8 @@ extension MarkdownRenderConfig {
       tableStyle: tableStyle,
       inlineStyle: value,
       textContextMenu: textContextMenu,
-      citationConfig: citationConfig
+      citationConfig: citationConfig,
+      blockSpacing: blockSpacing
     )
   }
 
@@ -123,7 +130,24 @@ extension MarkdownRenderConfig {
       tableStyle: tableStyle,
       inlineStyle: inlineStyle,
       textContextMenu: value,
-      citationConfig: citationConfig
+      citationConfig: citationConfig,
+      blockSpacing: blockSpacing
+    )
+  }
+
+  /// Returns a copy with `blockSpacing` replaced.
+  public func withBlockSpacing(value: CGFloat) -> MarkdownRenderConfig {
+    MarkdownRenderConfig(
+      shouldAnimateText: shouldAnimateText,
+      blockQuoteStyle: blockQuoteStyle,
+      headingStyle: headingStyle,
+      orderedListStyle: orderedListStyle,
+      paragraphStyle: paragraphStyle,
+      tableStyle: tableStyle,
+      inlineStyle: inlineStyle,
+      textContextMenu: textContextMenu,
+      citationConfig: citationConfig,
+      blockSpacing: value
     )
   }
 }
diff --git a/Sources/MarkdownText/Models/MarkdownRenderConfig.swift b/Sources/MarkdownText/Models/MarkdownRenderConfig.swift
@@ -33,6 +33,9 @@ public struct MarkdownRenderConfig: Hashable, Sendable {
   public let textContextMenu: TextContextMenu?
   /// Configuration that controls inline citation parsing and rendering.
   public let citationConfig: CitationConfig
+  /// Vertical spacing between adjacent blocks (paragraphs, headings,
+  /// code blocks, lists, etc.). Defaults to 30.
+  public let blockSpacing: CGFloat
 
   /// Font and color style for a uniformly-styled run of markdown text.
   public struct MarkdownTextStyle: Hashable, Sendable {
@@ -175,6 +178,9 @@ public struct MarkdownRenderConfig: Hashable, Sendable {
     )
   }
 
+  /// Default inter-block spacing.
+  public static let defaultBlockSpacing: CGFloat = 30
+
   /// Default styling for `blockQuoteStyle`.
   public static let defaultBlockQuoteStyle = MarkdownTextStyle(
     textFonts: Typography.baseTextFonts,
@@ -237,7 +243,8 @@ public struct MarkdownRenderConfig: Hashable, Sendable {
     tableStyle: MarkdownTableTextStyle = MarkdownRenderConfig.defaultTableStyle,
     inlineStyle: MarkdownInlineTextStyle = MarkdownRenderConfig.defaultInlineStyle,
     textContextMenu: TextContextMenu? = nil,
-    citationConfig: CitationConfig = .default
+    citationConfig: CitationConfig = .default,
+    blockSpacing: CGFloat = MarkdownRenderConfig.defaultBlockSpacing
   ) {
     self.shouldAnimateText = shouldAnimateText
     self.blockQuoteStyle = blockQuoteStyle
@@ -248,6 +255,7 @@ public struct MarkdownRenderConfig: Hashable, Sendable {
     self.inlineStyle = inlineStyle
     self.textContextMenu = textContextMenu
     self.citationConfig = citationConfig
+    self.blockSpacing = blockSpacing
   }
 
   /// The default render config, equivalent to calling `init()` with no

diff --git a/Sources/MarkdownText/UI/BlockView.swift b/Sources/MarkdownText/UI/BlockView.swift
@@ -8,14 +8,16 @@ import SwiftUI
 
 struct BlockView: View {
 
+  @Environment(\.markdownConfig) var config: MarkdownRenderConfig
+
   let renderables: [MarkdownRenderable]
 
   init(renderables: [MarkdownRenderable]) {
     self.renderables = renderables
   }
 
   var body: some View {
-    VStack(alignment: .leading, spacing: 30) {
+    VStack(alignment: .leading, spacing: config.blockSpacing) {
       ForEach(renderables) { renderable in
         SingleBlockView(renderable: renderable)
       }

diff --git a/Tests/MarkdownTextTests/MarkdownTextSnapshotTests.swift b/Tests/MarkdownTextTests/MarkdownTextSnapshotTests.swift
@@ -288,4 +288,21 @@ final class MarkdownTextSnapshotTests: SnapshotTestCase {
     }
     assert(view)
   }
+
+  func testCustomBlockSpacing() async throws {
+    let text = """
+    ## Heading
+
+    This is a paragraph with some text to render.
+
+    Another paragraph right here.
+    """
+    let config = MarkdownRenderConfig.default.withBlockSpacing(value: 10)
+    let document = await parser.parse(text: text)
+    let renderables = await RenderableDocument(document: document, config: config)
+    let view = CanvasView {
+      DocumentView(renderableDocument: renderables, config: config).padding(.horizontal, 24)
+    }
+    assert(view)
+  }
 }
diff --git a/...ts__/MarkdownTextSnapshotTests/testCustomBlockSpacing.iPadPro11-light-US-en.png b/...ts__/MarkdownTextSnapshotTests/testCustomBlockSpacing.iPadPro11-light-US-en.png
diff --git a/...kdownTextSnapshotTests/testCustomBlockSpacing.iPadPro11Landscape-dark-US-en.png b/...kdownTextSnapshotTests/testCustomBlockSpacing.iPadPro11Landscape-dark-US-en.png
diff --git a/...hots__/MarkdownTextSnapshotTests/testCustomBlockSpacing.iPhone16-dark-US-en.png b/...hots__/MarkdownTextSnapshotTests/testCustomBlockSpacing.iPhone16-dark-US-en.png
diff --git a/...ots__/MarkdownTextSnapshotTests/testCustomBlockSpacing.iPhone16-light-US-en.png b/...ots__/MarkdownTextSnapshotTests/testCustomBlockSpacing.iPhone16-light-US-en.png