Improve liquid doc indentation and hover formatting

----

- Render Description as markdown instead of plaintext
- Fix indentation for multi-line examples and descriptions

Author: jamesmengo

packages/theme-check-common/src/liquid-doc/liquidDoc.spec.ts

@@ -129,7 +129,7 @@ describe('Unit: getSnippetDefinition', () => {
       liquidDoc: {
         examples: [
           {
-            content: '{{ product }}\n          {{ product.title }}',
+            content: '{{ product }}\n{{ product.title }}',
             nodeType: 'example',
           },
         ],
@@ -276,7 +276,7 @@ describe('Unit: getSnippetDefinition', () => {
       name: 'product-card',
       liquidDoc: {
         description: {
-          content: 'this is an implicit description\n        in a header',
+          content: 'this is an implicit description\nin a header',
           nodeType: 'description',
         },
         parameters: [

packages/theme-check-common/src/liquid-doc/liquidDoc.ts

@@ -68,13 +68,13 @@ export function getSnippetDefinition(
     },
     LiquidDocExampleNode(node: LiquidDocExampleNode) {
       return {
-        content: node.content.value.trim(),
+        content: fixIndentation(node.content.value.trim()),
         nodeType: 'example',
       };
     },
     LiquidDocDescriptionNode(node: LiquidDocDescriptionNode) {
       return {
-        content: node.content.value.trim(),
+        content: fixIndentation(node.content.value.trim()),
         nodeType: 'description',
       };
     },
@@ -108,3 +108,36 @@ export function getSnippetDefinition(
     },
   };
 }
+
+function fixIndentation(text: string): string {
+  const lines = text.split('\n');
+
+  if (lines.length <= 1) return text;
+
+  // Find minimum indentation in one pass, skipping first line and empty lines
+  let minIndent = Infinity;
+
+  for (let i = 1; i < lines.length; i++) {
+    const line = lines[i];
+    if (line.trim().length === 0) continue;
+
+    const indent = line.match(/^\s*/)[0].length;
+    if (indent < minIndent) minIndent = indent;
+
+    // Early exit if we find a line with no indentation
+    if (minIndent === 0) break;
+  }
+
+  // If no valid lines found or no indentation to remove
+  if (minIndent === Infinity || minIndent === 0) return text;
+
+  // Process lines directly without creating additional arrays
+  for (let i = 1; i < lines.length; i++) {
+    const line = lines[i];
+    if (line.trim().length > 0) {
+      lines[i] = line.slice(minIndent);
+    }
+  }
+
+  return lines.join('\n');
+}

packages/theme-language-server-common/src/hover/providers/RenderSnippetHoverProvider.spec.ts

@@ -75,9 +75,7 @@ describe('Module: RenderSnippetHoverProvider', async () => {
 **Description:**
 
 
-\`\`\`plaintext
 This is a description
-\`\`\`
 
 **Parameters:**
 - \`title\`: string - The title of the product

packages/theme-language-server-common/src/hover/providers/RenderSnippetHoverProvider.ts

@@ -51,7 +51,7 @@ export class RenderSnippetHoverProvider implements BaseHoverProvider {
 
     if (liquidDoc.description) {
       const description = liquidDoc.description.content;
-      parts.push('', '**Description:**', '\n', `\`\`\`plaintext\n${description}\n\`\`\``);
+      parts.push('', '**Description:**', '\n', description);
     }
 
     if (liquidDoc.parameters?.length) {