All posts
·3 min read

Writing in Bloggrify: Beyond Basic Markdown

Discover how Bloggrify enhances your writing experience with MDC syntax, Vue components in Markdown, and advanced formatting features

Bloggrify is built on standard Markdown. If you're new to Markdown, it's a lightweight markup language with plain text formatting syntax. It's easy to read and write, and it's widely used in documentation, README files, and blogs.

While Bloggrify is built on standard Markdown, it offers much more powerful writing capabilities. Let's explore how you can enhance your content using advanced features.

MDC: Markdown Components

MDC (Markdown Components) allows you to seamlessly integrate Vue components within your Markdown:

tip

This is an info alert box

npm run dev

Built-in Components

Bloggrify comes with several pre-built components to enhance your content:

warning

Remember to configure your environment variables

Nuxt-content provide code highlighting with shiki. You can specify the language of the code block to enable syntax highlighting: This is a paragraph with a code block:

var foo = function (bar) {
  return bar++;
};

console.log(foo(5));

It's also possible to display a code block with a specific file name:

file.js
  export default () => {
    console.log('Code block')
  }

Tables

OptionDescription
datapath to data files to supply the data that will be passed into templates.
engineengine to be used for processing templates. Handlebars is the default.
extextension to be used for dest files.

Right aligned columns

OptionDescription
datapath to data files to supply the data that will be passed into templates.
engineengine to be used for processing templates. Handlebars is the default.
extextension to be used for dest files.

link text

link with title

Autoconverted link https://www.google.com

Shortcodes

You can embed external content using shortcodes:

YouTube

X

Vimeo

Instagram

Images

This is a paragraph with an image

the image is automatically centered on the page and the alt text is displayed below as a caption
the image is automatically centered on the page and the alt text is displayed below as a caption
.

Emojies

Classic markup: 😉 😢 😆 😋

Footnotes

Footnote 1 link1.

Footnote 2 link2.

Duplicated footnote reference2.

Frontmatter

It also supports frontmatter to add metadata to your markdown files.

---
pageid: "2"
title: "Use markdown power"
description: "Use markdown at its full potential."
date: "2024-02-09"
tags:
  - markdown
  - documentation
cover: "doc/markdown.png"
---
  • pageid is mandatory if you want to use the comment system. It is used to identify the article, so it must be unique across your blog.
  • title and description are used for SEO and social sharing. It's also used on the index page. Don't forget to fill them.
  • date is used to sort the articles. Date in the future will not be displayed.
  • tags are only used to display the tags on the article page. It's optional.
  • cover is used to display an image on the index page. It's also used when you share your article on social media. It's optional (it's however better to have one).

Conclusion

With these features, you can create rich, interactive blog posts while keeping the simplicity of Markdown. Remember, all these features work out of the box - no additional configuration needed!

Footnotes

  1. Footnote can have markup
    and multiple paragraphs.
  2. Footnote text. 2
Share
H

Written by

Hugo

Author and maintainer of Bloggrify

Enjoyed this article?

Subscribe to get new posts delivered to your inbox.