DEV Community

Casualwriter
Casualwriter

Posted on • Edited on

Build blog site by markdown files by single index.html

casual-markdown-blog is a handy solution to build blog site by markdown files and single index.html

What we need is config home page at index.md, then start write post in markdown!

Image description

It is very handy to build simple blog-site from markdown files, and host on static web hosting. For example,

Usage Guide

simply copy index.html to web server, or fork this repo.

  • config site at index.md (title, subtitle, header-color, navigation, etc..)
  • start to write blog post using markdown
  • to publish, just add the post in index.md by syntax

below is sample setup from Sample Blog: index.md

------------------------------------------------------------------title      : Casual-Markdown's Blog 
subtitle   : Simple is the best
nav-group  : featured, new-3, tags, months
nav-width  : 320px
css-header : background:linear-gradient(to bottom right, #06c, #fc0); color:white
menu       : 
   Home    : ?
   Github  : https://github.com/casualwriter/casual-markdown-blog
   Dark    : javascript:darkmode()
   About   : ?page=about.md
------------------------------------------------------------------
<style comment="additional style">
......
</style>

<div id="md-post">

home page in markdown syntax...

## Archive

* yyyy/mm/dd: [Post Title](md file)  { #tag1, #tag2 }
* yyyy/mm/dd: [Post Title](md file)  { #tag1, #tag2 }
...
* yyyy/mm/dd: [Post Title](md file)  { #tag1, #tag2 }

</div>

Enter fullscreen mode Exit fullscreen mode

looking forward to your advice to help it getting better,

thanks

Top comments (0)