Add formatting support for implicit descriptions

Author: jamesmengo

.changeset/proud-chefs-relate.md

@@ -0,0 +1,5 @@
+---
+'@shopify/prettier-plugin-liquid': patch
+---
+
+Prevent prettier from appending `@description` annotation before implicit descriptions

packages/prettier-plugin-liquid/src/printer/print/liquid.ts

@@ -581,10 +581,14 @@ export function printLiquidDocDescription(
   _args: LiquidPrinterArgs,
 ): Doc {
   const node = path.getValue();
-  const parts: Doc[] = ['@description'];
+  const parts: Doc[] = [];
+
+  if (!node.isImplicit) {
+    parts.push('@description ');
+  }
 
   if (node.content?.value) {
-    parts.push(' ', node.content.value);
+    parts.push(node.content.value);
   }
 
   return parts;

packages/prettier-plugin-liquid/src/test/liquid-doc/fixed.liquid

@@ -124,3 +124,10 @@ It should add padding between dissimilar nodes
 
   @param {String} param3 - param with description
 {% enddoc %}
+
+It should not append an implicit description with an @description annotation
+{% doc %}
+  This is an implicit description
+
+  @description This is an explicit description
+{% enddoc %}

packages/prettier-plugin-liquid/src/test/liquid-doc/index.liquid

@@ -118,3 +118,10 @@ It should add padding between dissimilar nodes
   @description This is a description
   @param {String} param3 - param with description
 {% enddoc %}
+
+It should not append an implicit description with an @description annotation
+{% doc %}
+This is an implicit description
+
+  @description This is an explicit description
+{% enddoc %}