setup

Configuring a post

here are all options you can use in the frontmatter of a blog post:

title: string (required)

  • title of the blog post, don’t repeat this in the markdown part
title: "My first blog post"

description: string (required)

  • will be shown in the blog post list
description: "This is my first blog post"

date published (required)

  • date when the post was published, will be shown in the blog post list, posts will be sorted by this date
pubDate: "Oct 24 2024"

published (optional)

  • whether the post is published, default: true, if set to false the post will not be shown in the blog list nor be accessible by url
published: true

hidden (optional)

  • whether the post is hidden, default: false, if set to true the post will not be shown in the blog list but will still be accessible by url
hidden: false

short description (optional)

  • will be used for open-graph image generation (will fallback to description)
shortDescription: "This is my first blog post"

updated date (optional)

  • date when the post was last updated
updatedDate: "Oct 24 2024"

hero image (optional)

  • path to the hero image, image has to be in /src/assets folder and has to start with /src/assets/ or ../../assets/
heroImage: "../../assets/backgrounds/blog-placeholder-4.jpg"

tags (optional)

  • array of tags
tags: ["first", "blog"]

hide hero (optional)

  • whether to hide the hero image, default: false (will show hero image on top of the post)
hideHero: false

custom open-graph image (optional)

  • path to a custom open-graph image, will also hide title and description in the open-graph image, image has to be in /src/assets folder and has to start with /src/assets/
customOGImage: "/src/assets/backgrounds/blog-placeholder-4.jpg"

disable comments (optional)

  • whether to disable comments, default: false
disableComments: false

disable likes (optional)

  • whether to disable likes, default: false
disableLikes: false