docs: add llms raw markdown config

Author: farnabaz

docs/content/docs/2.collections/2.types.md

@@ -33,10 +33,8 @@ Nuxt Content will automatically generate a path for each file in the collection,
 
 Here are examples of generated paths based on file structure:
 
-|                                  |                       |
-| -------------------------------- | --------------------- |
-|                                  |                       |
 | File                             | Path                  |
+| -------------------------------- | --------------------- |
 | `content/index.md`               | `/`                   |
 | `content/about.md`               | `/about`              |
 | `content/blog/index.md`          | `/blog`               |

docs/content/docs/7.integrations/02.llms.md

@@ -31,6 +31,27 @@ export default defineNuxtConfig({
 
 That's it 🚀 `/llms.txt` file is automatically generated and pre-rendered.
 
+## Raw markdown access
+
+When `nuxt-llms` is enabled, Nuxt Content also exposes a raw markdown endpoint so you can stream LLM-ready source files without going through the full rendering pipeline.
+
+- **Endpoint**: `/raw/<content-path>.md` (use the same path as the page URL, drop trailing `/index`, and keep the `.md` extension), returning `text/markdown; charset=utf-8`.
+- **Scope**: only `page` collections are included; exclude specific collections with `llms.contentRawMarkdown.excludeCollections`{lang=ts}. Set `llms.contentRawMarkdown = false`{lang=ts} to disable the endpoint entirely.
+- **Output**: if the requested document is missing a top-level heading or description, the route prepends the title and description to the markdown body before returning it.
+- **llms.txt links**: document links generated in `llms.txt` are automatically rewritten to the `/raw/...md` endpoint (unless the collection is excluded or the feature is disabled) so agents fetch compact markdown instead of full HTML, reducing token usage and improving response speed.
+
+```ts [nuxt.config.ts]
+export default defineNuxtConfig({
+  modules: ['@nuxt/content', 'nuxt-llms'],
+  llms: {
+    contentRawMarkdown: {
+      // Optional: prevent specific page collections from being exposed
+      excludeCollections: ['blog'],
+    },
+  },
+})
+```
+
 ## Sections
 
 When generating content, you can create custom sections to process your content into LLM-friendly formats.

docs/nuxt.config.ts

@@ -53,7 +53,7 @@ export default defineNuxtConfig({
       title: 'Complete Documentation',
       description: 'The complete documentation including all content',
     },
-    contentRawMD: {
+    contentRawMarkdown: {
       excludeCollections: ['landing'],
     },
   },

src/features/llms/module.ts

@@ -10,21 +10,21 @@ export default defineNuxtModule({
     const { resolve } = createResolver(import.meta.url)
 
     addServerPlugin(resolve('runtime/server/content-llms.plugin'))
-    if ((nuxt.options as unknown as { llms: { contentRawMD: false | { excludeCollections: string[] } } })?.llms?.contentRawMD !== false) {
+    if ((nuxt.options as unknown as { llms: { contentRawMarkdown: false | { excludeCollections: string[] } } })?.llms?.contentRawMarkdown !== false) {
       addServerHandler({ route: '/raw/**:slug.md', handler: resolve('runtime/server/routes/raw/[...slug].md.get') })
     }
 
     nuxt.hook('modules:done', () => {
       // @ts-expect-error -- TODO: fix types
       nuxt.options.llms ||= {}
       // @ts-expect-error -- TODO: fix types
-      nuxt.options.llms.contentRawMD = defu(nuxt.options.llms.contentRawMD, {
+      nuxt.options.llms.contentRawMarkdown = defu(nuxt.options.llms.contentRawMarkdown, {
         excludeCollections: [],
       })
 
       nuxt.options.runtimeConfig.llms ||= {}
       // @ts-expect-error -- TODO: fix types
-      nuxt.options.runtimeConfig.llms.contentRawMD = defu(nuxt.options.llms.contentRawMD, {
+      nuxt.options.runtimeConfig.llms.contentRawMarkdown = defu(nuxt.options.llms.contentRawMarkdown, {
         excludeCollections: [],
       })
     })
@@ -36,7 +36,7 @@ export default defineNuxtModule({
 import type { SQLOperator, PageCollections, PageCollectionItemBase } from '@nuxt/content'
 declare module 'nuxt-llms' {
   interface ModuleOptions {
-    contentRawMD?: false | {
+    contentRawMarkdown?: false | {
       excludeCollections?: string[]
     }
   }

src/features/llms/runtime/server/content-llms.plugin.ts

@@ -91,8 +91,8 @@ export default defineNitroPlugin((nitroApp: NitroApp) => {
   }
 
   function getDocumentLink(link: string, collection: string, options: ModuleOptions) {
-    const contentRawMD = (options as unknown as { contentRawMD: false | { excludeCollections: string[] } })?.contentRawMD
-    if (contentRawMD === false || contentRawMD?.excludeCollections?.includes(collection)) {
+    const contentRawMarkdown = (options as unknown as { contentRawMarkdown: false | { excludeCollections: string[] } })?.contentRawMarkdown
+    if (contentRawMarkdown === false || contentRawMarkdown?.excludeCollections?.includes(collection)) {
       return withBase(link, options.domain)
     }
 

src/features/llms/runtime/server/routes/raw/[...slug].md.get.ts

@@ -8,9 +8,9 @@ import collections from '#content/manifest'
 
 export default eventHandler(async (event) => {
   const config = useRuntimeConfig(event)
-  const llmsConfig = config.llms as { contentRawMD: false | { excludeCollections: string[] } }
+  const llmsConfig = config.llms as { contentRawMarkdown: false | { excludeCollections: string[] } }
   const slug = getRouterParams(event)['slug.md']
-  if (!slug?.endsWith('.md') || llmsConfig?.contentRawMD === false) {
+  if (!slug?.endsWith('.md') || llmsConfig?.contentRawMarkdown === false) {
     throw createError({ statusCode: 404, statusMessage: 'Page not found', fatal: true })
   }
 
@@ -19,7 +19,7 @@ export default eventHandler(async (event) => {
     path = path.substring(0, path.length - 6)
   }
 
-  const excludeCollections = llmsConfig?.contentRawMD?.excludeCollections || []
+  const excludeCollections = llmsConfig?.contentRawMarkdown?.excludeCollections || []
   const _collections = Object.entries(collections as Record<string, ResolvedCollection>)
     .filter(([_key, value]) => value.type === 'page' && !excludeCollections.includes(_key))
     .map(([key]) => key) as string[]