How to use hooks to augment md content in v3?

[AloisSeckar]

In Nuxt Content v2 I had Nitro plugin like this:

export default defineNitroPlugin((nitroApp) => {
  nitroApp.hooks.hook('content:file:beforeParse', (file) => {
    if (file._id.endsWith('.md')) {
      file.body = // do stuff
    }
  })
})

How can I use this in v3?

IDE says: "Argument of type '"content:file:beforeParse"' is not assignable to parameter of type 'HookKeys'." and the augmentation is not happening.

Based on (very brief) documentation page I tried to add following into defineNuxtConfig but it doesnt seem to work the way I am trying it:

hooks: {
  'content:file:beforeParse'(ctx: { file: { path: string, body: string } }) {
    const file = ctx.file
    if (file.path.endsWith('.md')) {
      file.body = // do stuff
    }
  },
},

Did I figured out the ctx object structure incorrectly or is there something else I am doing wrong?

[yudin-s]

In v3 this hook should be registered on the Nuxt/content side, not as a Nitro runtime hook. The TypeScript error is the clue: content:file:beforeParse is not a NitroRuntimeHooks key, so a Nitro plugin will not see it.

The shape you tried in nuxt.config.ts is the right direction:

export default defineNuxtConfig({
  hooks: {
    'content:file:beforeParse'(ctx) {
      if (ctx.file.path.endsWith('.md')) {
        ctx.file.body = transformMarkdown(ctx.file.body)
      }
    },
  },
})

Things I would check:

• restart the dev server after adding/changing the hook
• confirm the file path condition matches v3 paths (console.log(ctx.file.path) once)
• make sure transformMarkdown() returns a string, not a parsed object
• register the hook in the project/module Nuxt config layer, not inside server/plugins

For a reusable Nuxt module, register it with nuxt.hook('content:file:beforeParse', ...) from the module setup rather than a Nitro plugin. The hook belongs to content indexing, not request-time Nitro execution.

[AloisSeckar]

Yup. I am now registering the hook in the module setup and it works perfectly. Thanks