fix(a11y): always show subtle underline on markdown links#1911
fix(a11y): always show subtle underline on markdown links#1911bluzername wants to merge 1 commit intopaperclipai:masterfrom
Conversation
Links in markdown content was only underlined on hover. If you don't hover over the text, you cannot tell what is a link and what is just colored text. This is specially bad for users who have difficulty perceiving color differences. Changed from text-decoration:none to a subtle always-visible underline using 30% opacity of the link color. On hover the underline become full opacity for stronger feedback. This way links are clearly distinguishable from regular text at rest, but the underline is subtle enough to not make the text look cluttered or hard to read. Affect all markdown content across the app: agent instructions, issue descriptions, comments, goal descriptions, etc.
Greptile SummaryThis PR fixes a WCAG accessibility issue by giving markdown links a faint underline (30% opacity) at rest, stepping up to full opacity on hover. The 4-line CSS change is clean and correct — Confidence Score: 5/5Safe to merge — the 4-line CSS change is correct and addresses a real WCAG accessibility gap with no side-effects. All findings are P2 or lower. The CSS logic is sound: color-mix is already used in the same rule, browser support is consistent, and the opacity-based underline approach is idiomatic. The only outstanding items are contribution-guideline housekeeping (thinking path, screenshots) and a trivial CSS redundancy — none of which affect correctness or runtime behavior. No files require special attention. Important Files Changed
Reviews (1): Last reviewed commit: "fix(a11y): make markdown links always un..." | Re-trigger Greptile |
Thinking Path
Problem
Links in rendered markdown content had
text-decoration: noneby default. The underline only appear on hover. This mean if you just look at the page without moving your mouse, you cannot tell which text is a link and which is regular text. The only difference is a slight color shift which is not enough for many users.This is a WCAG accessibility concern - links should be visually distinguishable from surrounding text without relying only on color. Users with low vision, colorblindness, or just bright screen conditions may not notice the subtle color difference.
I noticed this when reading agent instructions that had several links mixed in with regular text. Had to hover over random words to discover which ones are clickable.
What I changed
Instead of removing the underline completely, now links have a very subtle underline at all times:
color-mix(in oklab, currentColor 30%, transparent))The 30% opacity underline is light enough to not make text look cluttered or distracting, but strong enough that you can tell "this text is a link" without hovering. Similar to how GitHub renders links in markdown.
How to test
1 file, 4 lines changed.