{"repo":"depado/smallblog","free":true,"listed":false,"github":"https://github.com/depado/smallblog","clone":"git clone https://github.com/depado/smallblog.git","description":"Flat file markdown blogging system with filesystem watch and extended markdown support","language":"Go","stars":44,"topics":["blog","blog-engine","blogging","markdown"],"license":"MIT","category":"docs-static-sites","readme_excerpt":"Smallblog A simple self-hosted markdown flat files blog What is Smallblog The main goal of this project is to show how easily you can develop a flat file blog with markdown as the primary writing language. It's not perfect, it will never be, some people are already doing great things based on that idea, like Hugo for instance. Disclaimer Smallblog is a quick project. The goal is to take some markdown files with front matter headers (written in yaml), parse them, render them and store the resulting HTML in memory. Which means, the more markdown files you have, the more memory smallblog will consume. It can also generate a static website, but that's not as fun. Features - Filesystem monitoring: Create, modify or delete a file and your blog is updated - Automatic syntax highlighting using bfchroma (which uses chroma under the hood) - Supports admonitions using bfadmonition - No CGO dependencies - Tag system - Simple and customizable template and CSS for easy reading - Comments using gitalk - Supports global assets for all your articles - Can generate a static site: - Tags won't work - Raw markdown won't work Tutorial First of all you'll need a pages directory where you'll store all your articles, so let's create that. Without configuration, smallblog will try to find a pages/ directory in your current working directory. So let's create your very first article, and for that we'll be using the new command : This commands takes a single argument : The name of the file this command ","default_branch":null,"files":null,"tree":[],"storefront":"/r/depado","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/depado/smallblog/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}