fix(utils): handle descriptions ending in code block in report.md

Author: matejchalk

packages/utils/src/lib/__snapshots__/report-to-md.spec.ts.snap

@@ -393,31 +393,31 @@ ESLint rule **require-render-return**, from _react_ plugin. [📖 Docs](https://
 
 🟨 <b>1.2 s</b> (score: 76)
 
- [📖 Docs](https://developer.chrome.com/docs/lighthouse/performance/first-contentful-paint/)
+[📖 Docs](https://developer.chrome.com/docs/lighthouse/performance/first-contentful-paint/)
 
 ### Largest Contentful Paint (Lighthouse)
 
 🟨 <b>1.5 s</b> (score: 81)
 
- [📖 Docs](https://developer.chrome.com/docs/lighthouse/performance/largest-contentful-paint/)
+[📖 Docs](https://developer.chrome.com/docs/lighthouse/performance/largest-contentful-paint/)
 
 ### Total Blocking Time (Lighthouse)
 
 🟩 <b>0 ms</b> (score: 100)
 
- [📖 Docs](https://developer.chrome.com/docs/lighthouse/performance/lighthouse-total-blocking-time/)
+[📖 Docs](https://developer.chrome.com/docs/lighthouse/performance/lighthouse-total-blocking-time/)
 
 ### Cumulative Layout Shift (Lighthouse)
 
 🟩 <b>0</b> (score: 100)
 
- [📖 Docs](https://web.dev/cls/)
+[📖 Docs](https://web.dev/cls/)
 
 ### Speed Index (Lighthouse)
 
 🟩 <b>1.2 s</b> (score: 93)
 
- [📖 Docs](https://developer.chrome.com/docs/lighthouse/performance/speed-index/)
+[📖 Docs](https://developer.chrome.com/docs/lighthouse/performance/speed-index/)
 
 
 

packages/utils/src/lib/report-to-md.ts

@@ -304,9 +304,21 @@ function getDocsAndDescription({
   docsUrl,
   description,
 }: AuditReport | CategoryConfig): string {
-  return docsUrl
-    ? `${description || ''} ${link(docsUrl, '📖 Docs')}` + NEW_LINE + NEW_LINE
-    : '';
+  if (docsUrl) {
+    const docsLink = link(docsUrl, '📖 Docs');
+    if (!description) {
+      return docsLink + NEW_LINE + NEW_LINE;
+    }
+    if (description.endsWith('```')) {
+      // when description ends in code block, link must be moved to next paragraph
+      return description + NEW_LINE + NEW_LINE + docsLink + NEW_LINE + NEW_LINE;
+    }
+    return `${description} ${docsLink}${NEW_LINE}${NEW_LINE}`;
+  }
+  if (description) {
+    return description + NEW_LINE + NEW_LINE;
+  }
+  return '';
 }
 
 function getAuditResult(audit: AuditReport, isHtml = false): string {