Writing in Bloggrify: Beyond Basic Markdown

Feb 10, 2024

3 min read

Avatar of Hugo
Hugo

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

Youtube and Twitter embed

You can embed youtube videos and tweets in your markdown files

Links to a channel won't be transformed :

https://youtube.com/@eventuallycoding

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.

---
id: "2"
title: "Use markdown power"
description: "Use markdown at its full potential."
date: "2024-02-09"
tags:
  - markdown
  - documentation
cover: "doc/markdown.png"
---
  • id is mandatory if you want to use the comment system. It is used to identify the article.
  • 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