feat(llms): add related links to raw markdown endpoint (#3724)

Author: HugoRCD

playground/content.config.ts

@@ -36,6 +36,11 @@ const content = defineCollection({
     date: z.date(),
     rawbody: z.string(),
     testd: property(z.object({})).inherit('components/TestD.vue'),
+    links: z.array(z.object({
+      label: z.string(),
+      icon: z.string(),
+      to: z.string(),
+    })),
   }),
 })
 

playground/content/1.real-content/links-test.md

@@ -0,0 +1,23 @@
+---
+title: Links Test
+description: A page to test frontmatter links in raw markdown output.
+links:
+  - label: Source
+    icon: i-simple-icons-github
+    to: https://github.com/nuxt/content
+    size: sm
+  - label: Documentation
+    icon: i-lucide-book-open
+    to: https://content.nuxt.com
+    size: sm
+---
+
+## Introduction
+
+This page tests that frontmatter metadata (including `links`) is correctly included in the raw markdown output.
+
+Visit `/raw/real-content/links-test.md` to see the raw output with frontmatter.
+
+## Content
+
+Some example content to verify the body is still rendered correctly alongside the frontmatter.

playground/nuxt.config.ts

@@ -3,6 +3,7 @@ export default defineNuxtConfig({
     '@nuxt/ui',
     '@nuxthub/core',
     '@nuxt/content',
+    'nuxt-llms',
   ],
   content: {
     experimental: {
@@ -42,4 +43,8 @@ export default defineNuxtConfig({
     // Or use PGlite with NuxtHub:
     // db: 'postgresql',
   },
+  llms: {
+    domain: 'http://localhost:3000',
+    title: 'Content Playground',
+  },
 })

playground/package.json

@@ -17,6 +17,7 @@
     "better-sqlite3": "^12.6.0",
     "drizzle-orm": "^0.45.1",
     "nuxt": "^4.2.2",
+    "nuxt-llms": "^0.2.0",
     "pg": "^8.17.1",
     "remark-code-import": "^1.2.0",
     "shiki-transformer-color-highlight": "^1.0.0"

pnpm-lock.yaml

@@ -2,6 +2,7 @@ import { withLeadingSlash } from 'ufo'
 import { stringify } from 'minimark/stringify'
 import { queryCollection } from '@nuxt/content/server'
 import type { Collections, PageCollectionItemBase, ResolvedCollection } from '@nuxt/content'
+import type { MinimarkNode } from '../../../../../../types/tree'
 import { getRouterParams, eventHandler, createError, setHeader } from 'h3'
 import { useRuntimeConfig } from '#imports'
 import collections from '#content/manifest'
@@ -42,6 +43,18 @@ export default eventHandler(async (event) => {
     page.body.value.unshift(['h1', {}, page.title])
   }
 
+  // Append related links at the end if present
+  const links = (page as unknown as Record<string, unknown>).links || (page.meta as Record<string, unknown>)?.links
+  if (Array.isArray(links) && links.length > 0) {
+    const linkItems = links
+      .filter((link: { label?: string, to?: string }) => link.label && link.to)
+      .map((link: { label: string, to: string }) => ['li', {}, ['a', { href: link.to }, link.label]])
+    if (linkItems.length > 0) {
+      page.body.value.push(['hr'] as unknown as MinimarkNode)
+      page.body.value.push(['ul', {}, ...linkItems] as unknown as MinimarkNode)
+    }
+  }
+
   setHeader(event, 'Content-Type', 'text/markdown; charset=utf-8')
   return stringify({ ...page.body, type: 'minimark' }, { format: 'markdown/html' })
 })