[SilvaViniF]

Summary

GitLab issue/MR descriptions and comments rendered as a single wall of text: Markdown headings (## Problem to solve, ## Proposed solution, …) lost their size hierarchy and block spacing, so every section ran into the next paragraph.

This switches both surfaces to variant="document" with the same typography classes the GitHub item dialog already uses.

Screenshots

Real Orca GitLab item dialog captures via Electron CDP (agent-browser / Playwright over --remote-debugging-port). Same live dialog surface this PR changes (GitLabItemDialog → CommentMarkdown).

Issues created on gitlab.com/neil148/test so each fixture exercises a different markdown shape.

1. GitLab default issue template

Before (compact)	After (document)

Headings like Problem to solve run into the following paragraph before; after they get real block hierarchy + spacing.

2. Heading hierarchy (h1–h4)

Before (compact)	After (document)

3. Lists, tasks, and code

Before (compact)	After (document)

4. GFM table + blockquote

Before (compact)	After (document)

5. Dense multi-section body

Before (compact)	After (document)

Window context

Before	After

Testing

• pnpm lint — clean for the changed files
• pnpm typecheck
• pnpm test — CommentMarkdown.test.tsx passes (20 tests)
• pnpm build
• Added tests: two CommentMarkdown cases asserting the document variant renders headings as block <h2> while the compact variant does not — a direct regression guard for this bug.

AI Review Report

• Correctness: No issues. The change only swaps the CommentMarkdown variant and adds a className; the rendered content was already fetched and already passed through CommentMarkdown. The only removed behavior is the compact rendering of these two surfaces — which was the bug.
• Interaction with recent main: Rebased onto current main (which now includes fix(pr-comments): make the review sidebar legible for structured bot markdown #9209, "make the review sidebar legible for structured bot markdown"). Confirmed no overlap: fix(pr-comments): make the review sidebar legible for structured bot markdown #9209 reworks the compact renderer + PR-review sidebar (pr-comment-presentation.ts) and adds comment-md-h/role="heading" semantics, but it does not touch the item dialogs and adds no global block-flow CSS — so the GitLab dialog's compact rendering is unchanged and this fix is still required. Both PRs' CommentMarkdown tests coexist.
• Cross-platform (macOS / Linux / Windows): No platform-dependent code — no shortcuts, paths, shell, or Electron platform branches. Pure renderer markup + Tailwind; identical on all three, light/dark unaffected.
• SSH/remote/local: No new data flow or timing; renders content the dialog already loads.
• Provider neutrality: GitLab-specific and aligns GitLab with the existing GitHub sibling; no generic behavior changed.
• UI quality: Matches the GitHub item dialog exactly (same variant + className), so the two dialogs read as one design.

Security Audit

• Input handling: No new input. comment.body / details.body were already fetched from GitLab and already rendered through CommentMarkdown before this change.
• Sanitization: Both compact and document variants run the identical pipeline (rehypeRaw → rehypeSanitize with the shared schema). The document variant does not relax sanitization, so the XSS posture is unchanged.
• Command execution / path handling / auth / secrets / IPC / dependencies: None touched.
• Follow-up: none.

Notes

No platform-specific behavior. Scope is a single topic (GitLab item dialog markdown rendering); no unrelated changes.

ELI5

GitLab issue and MR descriptions rendered as one flat wall of text — headings lost size and spacing. They now use the same document markdown styling as GitHub items so sections are readable.

[AmethystLiang]

thanks for the PR. looking forward to reviewing it soon

[coderabbitai]

📝 Walkthrough

Walkthrough

GitLab comments and work item descriptions now render with CommentMarkdown in document mode and dedicated styling for wrapping, links, inline code, and preformatted blocks. Tests verify that document mode renders Markdown headings as block-level elements, while compact mode preserves headings as inline text.

🚥 Pre-merge checks | ✅ 4 | ❌ 1

❌ Failed checks (1 warning)

Check name	Status	Explanation	Resolution
Docstring Coverage	⚠️ Warning	Docstring coverage is 0.00% which is insufficient. The required threshold is 80.00%.	Write docstrings for the functions missing them to satisfy the coverage threshold.

✅ Passed checks (4 passed)

Check name	Status	Explanation
Linked Issues check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Out of Scope Changes check	✅ Passed	Check skipped because no linked issues were found for this pull request.
Title check	✅ Passed	The title is concise and accurately summarizes the main GitLab markdown rendering change.
Description check	✅ Passed	The description includes Summary, Screenshots, Testing, AI Review Report, Security Audit, and Notes, covering the required template sections.

---

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

• X
• Mastodon
• Reddit
• LinkedIn

_{Comment @coderabbitai help to get the list of available commands.}

[nwparker]

@AmethystLiang need your stamp