feat: Add markdown toggle (alt+m) to switch between rendered and raw… #10383

srivatsj · 2025-10-01T23:49:06Z

… display

Implements feature request from #6499 to toggle between rendered and raw markdown mode.

Add alt+m keybinding to toggle markdown rendering globally
Add renderMarkdown setting to UI config (default: true)
Update MarkdownDisplay to support raw mode with syntax highlighting
Update GeminiMessage, GeminiMessageContent, and ToolMessage to respect toggle
Add UIStateContext to test utilities for component testing
Visual indicator in footer (currently commented out)

Fixes #6499

TLDR

Add alt+m keybinding to toggle markdown rendering globally
Add renderMarkdown setting to UI config (default: true)
Update MarkdownDisplay to support raw mode with syntax highlighting
Update GeminiMessage, GeminiMessageContent, and ToolMessage to respect toggle
Add UIStateContext to test utilities for component testing
Visual indicator in footer (currently commented out)

Dive Deeper

Reviewer Test Plan

Testing Matrix

	🍏	🪟	🐧
npm run	❓	❓	❓
npx	❓	❓	❓
Docker	❓	❓	❓
Podman	❓	-	-
Seatbelt	❓	-	-

Linked issues / bugs

google-cla · 2025-10-01T23:49:10Z

Thanks for your pull request! It looks like this may be your first contribution to a Google open source project. Before we can look at your pull request, you'll need to sign a Contributor License Agreement (CLA).

View this failed invocation of the CLA check for more information.

For the most up to date status, view the checks section at the bottom of the pull request.

packages/cli/src/ui/keyMatchers.test.ts

packages/cli/src/ui/utils/MarkdownDisplay.tsx

packages/cli/src/ui/components/Footer.tsx

jacob314

This is really helpful. Added some comments. Approved after those are addressed and there is a snapshot test fo the raw markdown display cases in GeminiMessage and ToolMessage.

packages/cli/src/ui/components/messages/GeminiMessage.test.tsx

packages/cli/src/ui/components/messages/ToolMessageRawMarkdown.test.tsx

packages/cli/src/ui/utils/MarkdownDisplay.tsx

packages/cli/src/config/settingsSchema.ts

packages/cli/src/ui/components/Footer.tsx

packages/cli/src/ui/contexts/KeypressContext.tsx

… display Implements feature request from google-gemini#6499 to toggle between rendered and raw markdown mode. - Add Ctrl+B keybinding to toggle markdown rendering globally - Add renderMarkdown setting to UI config (default: true) - Update MarkdownDisplay to support raw mode with syntax highlighting - Update GeminiMessage, GeminiMessageContent, and ToolMessage to respect toggle - Add UIStateContext to test utilities for component testing - Visual indicator in footer (currently commented out) Fixes google-gemini#6499

- Modified MarkdownDisplay to pass showLineNumbers: false when renderMarkdown is false - Line numbers were confusing in raw mode due to chunked Gemini output - Added snapshot tests for GeminiMessage and ToolMessage raw markdown rendering - Tests verify line numbers are hidden in raw mode but shown in rendered mode

- ✅ keyBindings.ts - Updated to Alt+Shift+M (command+shift+m) - ✅ keyMatchers.test.ts - Updated tests for Alt+Shift+M - ✅ MarkdownDisplay.tsx - Fixed line numbers in raw mode - ✅ Snapshot files - Updated and cleaned (4 obsolete snapshots removed)

…er access Added dual Alt/Option key support for cross-terminal compatibility: - Unicode mapping for terminals that send Unicode chars (iTerm2, VSCode) - ESC sequence handling for terminals that send escape sequences - Improved letter key handling to support both uppercase and lowercase with modifiers - Updated tests to reflect new Cmd+M keybinding

… (lines 414-422) 2. ✅ Updated AppContainer.tsx to always initialize renderMarkdown to true instead of reading from settings

Display "raw markdown mode (cmd+m to toggle)" indicator above input prompt when markdown rendering is disabled, consistent with shell mode and YOLO mode indicators. - Add RawMarkdownIndicator component - Show indicator in Composer when renderMarkdown is false - Add tests for RawMarkdownIndicator visibility - Remove commented markdown toggle code from Footer

jacob314 · 2025-10-15T15:45:00Z

Please update the pr description to mention alt-m rather than ctrl-B. to avoid confusion if someone is looking through the changelog.

jacob314 · 2025-10-15T15:46:30Z

packages/cli/src/ui/components/Composer.test.tsx

  ShellModeIndicator: () => <Text>ShellModeIndicator</Text>,
 }));

+vi.mock('./RawMarkdownIndicator.js', () => ({


Gemini CLI likes to mock too much. This isn't something that should be mocked.

packages/cli/src/ui/components/messages/ToolMessage.tsx

jacob314 · 2025-10-15T15:48:56Z

packages/cli/src/ui/components/RawMarkdownIndicator.tsx

+  <Box>
+    <Text>
+      raw markdown mode
+      <Text color={theme.text.secondary}> (alt+m to toggle) </Text>


make this platform aware. Mac users have no idea what "alt" is. Call it "option+m" for them.

jacob314

This is looking great! Approved after these comments are addressed.

Show "option+m" on macOS and "alt+m" on other platforms for the markdown toggle shortcut, and remove mock from RawMarkdownIndicator tests to verify actual component behavior.

jacob314

…etween rendered and raw… (google-gemini#10383)

…google-gemini#10383) Co-authored-by: Jacob Richman <jacob314@gmail.com>

jacob314 reviewed Oct 2, 2025

View reviewed changes

packages/cli/src/ui/keyMatchers.test.ts Outdated Show resolved Hide resolved

jacob314 reviewed Oct 2, 2025

View reviewed changes

packages/cli/src/ui/utils/MarkdownDisplay.tsx Show resolved Hide resolved

jacob314 reviewed Oct 2, 2025

View reviewed changes

packages/cli/src/ui/components/Footer.tsx Outdated Show resolved Hide resolved

jacob314 reviewed Oct 2, 2025

View reviewed changes

jacob314 reviewed Oct 3, 2025

View reviewed changes

packages/cli/src/ui/components/messages/GeminiMessage.test.tsx Outdated Show resolved Hide resolved

jacob314 reviewed Oct 3, 2025

View reviewed changes

packages/cli/src/ui/components/messages/ToolMessageRawMarkdown.test.tsx Outdated Show resolved Hide resolved

jacob314 reviewed Oct 3, 2025

View reviewed changes

packages/cli/src/ui/utils/MarkdownDisplay.tsx Outdated Show resolved Hide resolved

srivatsj marked this pull request as ready for review October 3, 2025 15:32

srivatsj requested a review from a team as a code owner October 3, 2025 15:32

jacob314 reviewed Oct 7, 2025

View reviewed changes

packages/cli/src/config/settingsSchema.ts Outdated Show resolved Hide resolved

jacob314 reviewed Oct 7, 2025

View reviewed changes

packages/cli/src/ui/components/Footer.tsx Outdated Show resolved Hide resolved

packages/cli/src/ui/contexts/KeypressContext.tsx Outdated Show resolved Hide resolved

packages/cli/src/ui/contexts/KeypressContext.tsx Outdated Show resolved Hide resolved

srivatsj mentioned this pull request Oct 8, 2025

Support Alt+key combinations #10753

Closed

srivatsj added 5 commits October 9, 2025 09:28

Summary of changes:

979cfdc

- ✅ keyBindings.ts - Updated to Alt+Shift+M (command+shift+m) - ✅ keyMatchers.test.ts - Updated tests for Alt+Shift+M - ✅ MarkdownDisplay.tsx - Fixed line numbers in raw mode - ✅ Snapshot files - Updated and cleaned (4 obsolete snapshots removed)

1. ✅ Removed renderMarkdown setting definition from settingsSchema.ts…

3484e69

… (lines 414-422) 2. ✅ Updated AppContainer.tsx to always initialize renderMarkdown to true instead of reading from settings

srivatsj force-pushed the toggle-markdown branch from 0cf58a9 to 3484e69 Compare October 9, 2025 17:09

srivatsj and others added 3 commits October 14, 2025 11:14

Merge branch 'main' into toggle-markdown

81c9347

Merge branch 'main' into toggle-markdown

6189f8e

jacob314 reviewed Oct 15, 2025

View reviewed changes

packages/cli/src/ui/components/messages/ToolMessage.tsx Outdated Show resolved Hide resolved

jacob314 reviewed Oct 15, 2025

View reviewed changes

Add platform-aware key label to raw markdown indicator

279fc6a

Show "option+m" on macOS and "alt+m" on other platforms for the markdown toggle shortcut, and remove mock from RawMarkdownIndicator tests to verify actual component behavior.

srivatsj changed the title ~~feat: Add markdown toggle (Ctrl+B) to switch between rendered and raw…~~ feat: Add markdown toggle (alt+m) to switch between rendered and raw… Oct 15, 2025

SandyTao520 mentioned this pull request Oct 15, 2025

Incomplete Content Display Since v0.2.2 #8532

Closed

jacob314 approved these changes Oct 15, 2025

View reviewed changes

Merge branch 'main' into toggle-markdown

cdffd76

jacob314 added the maintainer:e2e:ok label Oct 15, 2025

jacob314 enabled auto-merge October 15, 2025 17:44

srivatsj added 2 commits October 16, 2025 11:12

Merge branch 'main' into toggle-markdown

f4c0847

Merge branch 'main' into toggle-markdown

c9bfda3

jacob314 added maintainer:e2e:ok and removed maintainer:e2e:ok labels Oct 16, 2025

jacob314 added this pull request to the merge queue Oct 16, 2025

Merged via the queue into google-gemini:main with commit 6ded45e Oct 16, 2025
25 checks passed

thacio added a commit to thacio/auditaria that referenced this pull request Oct 17, 2025

Merge Commit '6ded45e': feat: Add markdown toggle (alt+m) to switch b…

3efd269

…etween rendered and raw… (google-gemini#10383)

Millsondylan pushed a commit to Millsondylan/gemini-cli-1 that referenced this pull request Oct 19, 2025

feat: Add markdown toggle (alt+m) to switch between rendered and raw… (…

eafb896

…google-gemini#10383) Co-authored-by: Jacob Richman <jacob314@gmail.com>

feat: Add markdown toggle (alt+m) to switch between rendered and raw… #10383

feat: Add markdown toggle (alt+m) to switch between rendered and raw… #10383

Uh oh!

Conversation

srivatsj commented Oct 1, 2025 • edited Loading Uh oh! There was an error while loading. Please reload this page.

Uh oh!

TLDR

Dive Deeper

Reviewer Test Plan

Testing Matrix

Linked issues / bugs

Uh oh!

google-cla bot commented Oct 1, 2025

Uh oh!

Uh oh!

Uh oh!

Uh oh!

jacob314 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

Uh oh!

jacob314 commented Oct 15, 2025

Uh oh!

jacob314 Oct 15, 2025

Choose a reason for hiding this comment

Uh oh!

srivatsj Oct 15, 2025

Choose a reason for hiding this comment

Uh oh!

Uh oh!

jacob314 Oct 15, 2025

Choose a reason for hiding this comment

Uh oh!

srivatsj Oct 15, 2025

Choose a reason for hiding this comment

Uh oh!

jacob314 left a comment

Choose a reason for hiding this comment

Uh oh!

jacob314 left a comment

Choose a reason for hiding this comment

Uh oh!

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

2 participants

srivatsj commented Oct 1, 2025 •

edited

Loading