From 2ba7e54c8186a3c265bfd6f0abbc1c5be29ec1fe Mon Sep 17 00:00:00 2001
From: Claire Chabas <claire.chabas@gmail.com>
Date: Wed, 23 Jul 2025 15:46:44 +0200
Subject: [PATCH] Fix headings styles in hint block (#3497)

---
 .changeset/many-moons-shave.md                           | 5 +++++
 packages/gitbook/src/components/DocumentView/Heading.tsx | 2 ++
 packages/gitbook/src/components/DocumentView/Hint.tsx    | 6 ++++--
 3 files changed, 11 insertions(+), 2 deletions(-)
 create mode 100644 .changeset/many-moons-shave.md

diff --git a/.changeset/many-moons-shave.md b/.changeset/many-moons-shave.md
new file mode 100644
index 000000000..fd3a908e1
--- /dev/null
+++ b/.changeset/many-moons-shave.md
@@ -0,0 +1,5 @@
+---
+"gitbook": patch
+---
+
+Fix headings styles in hint block
diff --git a/packages/gitbook/src/components/DocumentView/Heading.tsx b/packages/gitbook/src/components/DocumentView/Heading.tsx
index 769bb66ba..d06207719 100644
--- a/packages/gitbook/src/components/DocumentView/Heading.tsx
+++ b/packages/gitbook/src/components/DocumentView/Heading.tsx
@@ -46,6 +46,8 @@ export function Heading(props: BlockProps<DocumentBlockHeading>) {
                     'flex-1',
                     'z-[1]',
                     'justify-self-start',
+                    'max-w-full',
+                    'break-words',
                     getTextAlignment(block.data.align),
                     textStyle.lineHeight
                 )}
diff --git a/packages/gitbook/src/components/DocumentView/Hint.tsx b/packages/gitbook/src/components/DocumentView/Hint.tsx
index bcc9e5bc7..9d8b283a7 100644
--- a/packages/gitbook/src/components/DocumentView/Hint.tsx
+++ b/packages/gitbook/src/components/DocumentView/Hint.tsx
@@ -52,8 +52,10 @@ export function Hint(props: BlockProps<DocumentBlockHint>) {
             {hasHeading ? (
                 <Block
                     style={tcls(
-                        'flip-heading-hash !py-4 items-start px-4 pl-3 text-[1em] *:flex-none',
-                        hasHeading ? hintStyle.header : null
+                        '!py-4 w-full items-start pl-3 text-[1em] *:flex-none',
+                        // Heading hash styles
+                        'flip-heading-hash pr-8',
+                        hintStyle.header
                     )}
                     ancestorBlocks={[...ancestorBlocks, block]}
                     {...contextProps}