@dropsh/plugin-markdown 0.5.7 → 0.6.0

package/dist/plugins/markdown/src/index.d.ts

@@ -0,0 +1,4 @@
+import type { DropSHPlugin } from "dropsh/plugin";
+import { renderMarkdown } from "./render-md.js";
+export { renderMarkdown };
+export declare function markdownPlugin(): DropSHPlugin;

package/dist/plugins/markdown/src/render-md.d.ts

@@ -0,0 +1,2 @@
+import { type JsonApiDocument, type RenderContext } from "dropsh/plugin";
+export declare function renderMarkdown(doc: JsonApiDocument, _ctx: RenderContext): string;

package/dist/plugins/markdown/src/render-md.js

@@ -24,18 +24,21 @@ function relIds(rel) {
         return [`${data.type}/${data.id}`];
     return [];
 }
-// Flattens any attribute value to a single-line string for `label: value`
-// output. Text-field objects (`{ processed | value }`) collapse to their text;
-// other objects/arrays fall back to compact JSON.
-function fieldValue(v) {
+// Extracts an attribute's text as-is. Long-text objects (`{ value, format,
+// processed }`) resolve to their raw `value` (the markdown source) — never the
+// `processed` HTML; `processed` remains the fallback for text objects that
+// carry no raw value. Other objects/arrays fall back to compact JSON.
+function fieldText(v) {
     if (isScalar(v))
-        return yamlScalar(v);
+        return typeof v === "string" ? v : String(v);
     if (v && typeof v === "object") {
         const o = v;
+        if (typeof o.value === "string" && typeof o.format === "string")
+            return o.value;
         if (typeof o.processed === "string")
-            return yamlScalar(o.processed);
+            return o.processed;
         if (typeof o.value === "string")
-            return yamlScalar(o.value);
+            return o.value;
         return JSON.stringify(v);
     }
     return "";
@@ -45,7 +48,17 @@ function fieldValue(v) {
 function renderResource(res) {
     const lines = [`type: ${res.type}`, `id: ${res.id}`];
     for (const [k, v] of Object.entries(res.attributes ?? {})) {
-        lines.push(`${k}: ${fieldValue(v)}`);
+        const text = fieldText(v);
+        if (text.includes("\n")) {
+            // Multi-line field content (descriptions, comment bodies) is emitted as
+            // a readable indented block, not a `\n`-escaped quoted one-liner.
+            lines.push(`${k}: |`);
+            for (const l of text.replace(/\n+$/, "").split("\n"))
+                lines.push(l === "" ? "" : `  ${l}`);
+        }
+        else {
+            lines.push(`${k}: ${yamlScalar(text)}`);
+        }
     }
     for (const [k, v] of Object.entries(res.relationships ?? {})) {
         const ids = relIds(v);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@dropsh/plugin-markdown",
-  "version": "0.5.7",
+  "version": "0.6.0",
   "type": "module",
   "main": "./dist/plugins/markdown/src/index.js",
   "types": "./dist/plugins/markdown/src/index.d.ts",
@@ -26,7 +26,7 @@
   "devDependencies": {
     "typescript": "^5.6.0",
     "vitest": "^2.1.0",
-    "dropsh": "0.5.7"
+    "dropsh": "0.6.0"
   },
   "scripts": {
     "build": "tsc",