Post

How to Blog Using Markdown Only

Posted
By Aaryan Poudel 1 min read

How to Blog Using Markdown Only

Consider: a documentation subdomain docs.aaryanpoudel.com.np , a personal finance blog finance.aaryanpoudel.com.np and a today i learned subdomain til.aaryanpoudel.com.np

Upon research, I can have different folders (obsidian vaults) to separate it into three folders and use different stack for their deployments.

Best SSG seems to be:

  1. mkdocs docs with search
  2. quartz as a digital garden
  3. jekyll used previously for documenting, maybe can be used for til?

Others:

  1. docusaurus seems to need react and maybe uses mdx rather than standard md. Developed by facebook
  2. vuepress seems to use md & uses vuejs but need to research more
  3. hugo seemed barebones and was used on the first blog

From what I’ve assessed, the best way for me is:

  1. Tech Blog can have this workflow: tech-mkdocs → built with MkDocs → deployed to tech.aaryanpoudel.com.np
  2. Finance can be: finance-quartz → built with Quartz pipeline → deployed to finance.aaryanpoudel.com.np
  3. TIL can have the workflow: til -> built with jekyll? deployed to til.aaryanpoudel.com.np which can be the master folder containing the two folders above .. maybe?
Blogs
blog
This post is licensed under CC BY 4.0 by the author.