Setting layout in Front Matter

It’s possible to set the layout inside the front matter of markdown files? Like this:

content/blog/hello-world.md

---
layout: 'layout-1'
title: Hello World
---

content/blog/featured-article.md

---
layout: 'featured-layout'
title: Article with special layout
---

[NozomuIkuta]

I also dug into this issue and here are what I found.

Firstly, as @mrhubbs pointed out, layout option must be either a string or a synchronous function that returns a string. Fetching the document is asynchronous, so modifying layout option can not be an option to achieve the goal.

Another way is, as described in this issue, to modify context in middleware function which is called before layout function.

I tried this approach and it seems working.

export default {
  layout ({ store, documentLayout }) {
    return documentLayout || store.state.settings.layout || 'default'
  },
  async middleware (context) {
    const { app, params, redirect, error, $content } = context
    const path = `/${app.i18n.locale}/${params.pathMatch || 'index'}`
    const [document] = await $content({ deep: true }).where({ path }).fetch()
    if (!document) {
      return error({ statusCode: 404, message: 'Page not found' })
    }

    context.document = document
    context.documentLayout = document.layout

    if (params.pathMatch === 'index') {
      redirect(app.localePath('/'))
    }
  },
  async asyncData ({ $content, document, app }) {
    const [prev, next] = await $content(app.i18n.locale, { deep: true })
      .only(['title', 'slug', 'to'])
      .sortBy('position', 'asc')
      .surround(document.slug, { before: 1, after: 1 })
      .fetch()

    return {
      document,
      prev,
      next
    }
  },
  // ...
}

I set document as well as documentLayout just because I thought fetching document twice in middleware and asyncData would be at higher cost.

Note that I just did a quick testing in my local:

1. Run yarn create nuxt-content-docs test-layout.
2. Run yarn link to replace installed content-theme-docs package with that in my local.
3. Set layout: single in the front matter of setup.md file.
4. Run yarn run dev, and check whether layout is changed dynamically when I move between index and setup pages.
5. Run yarn run generate, yarn run start, and check whether layout is changed dynamically when I move between the 2 pages.

[farnabaz]

Using document-driven mode in nuxt/content@v2 you can set layout name in front-matter.

I’m closing this because nuxt/content@v1 will not receive any update for this.