diff --git a/src/css/custom.scss b/src/css/custom.scss
index c1ad226a58..ccafe9524f 100644
--- a/src/css/custom.scss
+++ b/src/css/custom.scss
@@ -111,6 +111,9 @@ html[data-theme='light'] {
   --ifm-link-color: var(--cypress-color-indigo-500);
 
   --ifm-toc-border-color: var(--ifm-color-gray-100);
+
+  // adjust hue & transparency of `code` so dotted underline shows through in light mode
+  --ifm-code-background: #dadada33;
 }
 
 html[data-theme='dark'] {
diff --git a/src/css/markdown.scss b/src/css/markdown.scss
index e32d1143a1..47560cb5f6 100644
--- a/src/css/markdown.scss
+++ b/src/css/markdown.scss
@@ -36,6 +36,16 @@ div.markdown {
   // add border bottom to code tags that are in a link
   a:has(> code) {
     border-bottom: 1px dotted var(--ifm-link-color);
+
+    &:hover {
+      border-bottom: 1px solid var(--ifm-link-color);
+    }
+  }
+
+  // ensure text links in admonitions have underline
+  .alert a {
+    border-bottom: 1px dotted var(--ifm-link-color);
+
     &:hover {
       border-bottom: 1px solid var(--ifm-link-color);
     }
@@ -71,11 +81,19 @@ div.markdown {
   @media screen and (max-width: 1024px) and (orientation: landscape) {
     a {
       border-bottom: 1px dotted var(--ifm-link-color);
+
+      &:hover {
+        border-bottom: 1px solid var(--ifm-link-color);
+      }
     }
   }
   @media screen and (max-width: 1024px) and (orientation: portrait) {
     a {
       border-bottom: 1px dotted var(--ifm-link-color);
+
+      &:hover {
+        border-bottom: 1px solid var(--ifm-link-color);
+      }
     }
   }
 }