gitwtfhub

wtf is bloog?

jongacnik/bloog — explained in plain English

Analysis updated 2026-08-10 · repo last pushed 2017-03-26

8JavaScriptAudience · developerComplexity · 2/5DormantSetup · moderate

TL;DR

Bloog turns markdown text files into a simple blog website with no database or complex setup. Write posts as plain text and get a live blog with pagination and individual post pages.

Mindmap

mindmap
  root((repo))
    What it does
      Converts markdown to blog
      Pagination built in
      Individual post pages
    How it works
      Posts sorted by filename
      Date naming keeps order
      No database needed
    Tech stack
      JavaScript
      Choo framework
      Surge for deploy
    Use cases
      Personal blog
      Technical writing
      Minimal website
    Audience
      Developers
      Writers
      Technical founders

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Create a personal blog by dropping markdown files into a posts folder and deploying with a single command.

REASON 2

Set up a lightweight writing site where posts are sorted chronologically by filename without any database.

REASON 3

Publish technical notes or articles written in markdown as a public website with minimal configuration.

What's in the stack?

JavaScriptchoosurge.shMarkdown

How it stacks up

jongacnik/bloog17nbist/jobapplieradguardteam/recovery
Stars888
LanguageJavaScriptJavaScriptJavaScript
Last pushed2017-03-262018-03-16
MaintenanceDormantDormant
Setup difficultymoderatemoderateeasy
Complexity2/52/52/5
Audiencedevelopergeneralgeneral

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires installing Node.js dependencies and a surge.sh account for deployment.

The license is not specified in the project documentation, so check the repository files for license details.

Wtf does this do

Bloog is a lightweight blogging tool that turns simple markdown text files into a working blog website. Instead of dealing with a full content management system or database, you just write posts as plain text files and the app assembles them into a blog with working pagination and individual post links. The way it works is straightforward: you put your markdown posts in a designated folder, and the app inlines them into a website. Posts are sorted by filename, so naming your files with dates keeps everything in chronological order. The project is built using choo, a minimal JavaScript framework, and comes with a few simple commands to handle common tasks like starting a local preview, creating a new post, building the final site for production, and deploying it to the web via surge.sh. This would appeal to someone who wants a no-fuss personal blog and is comfortable writing in markdown. A developer, writer, or technical founder who already drafts notes or articles in markdown could drop those files into the posts folder and have a live blog without configuring a database or wrestling with a heavier platform like WordPress. The built-in deployment to surge.sh also means you can go from a folder of text files to a public website with minimal friction. The project's defining trait is its intentional simplicity. The creator acknowledges it is very simple, but suggests that might be all you need. It trades away features like a rich visual editor, comment systems, or user management in exchange for a setup you can understand in a few minutes. For someone who values a minimal footprint and already works in plain text, that tradeoff might be exactly the point.

Yoink these prompts

Prompt 1
Help me set up Bloog for my personal blog. I have a folder of markdown posts with date-prefixed filenames. Walk me through installing dependencies, starting the local preview, and creating my first new post.
Prompt 2
I want to deploy my Bloog blog to surge.sh. Guide me through the build step and deployment process so my markdown posts go live as a public website.
Prompt 3
Show me how to organize markdown posts in Bloog so they appear in the correct chronological order using filename sorting. What naming convention should I use?

Frequently asked questions

wtf is bloog?

Bloog turns markdown text files into a simple blog website with no database or complex setup. Write posts as plain text and get a live blog with pagination and individual post pages.

What language is bloog written in?

Mainly JavaScript. The stack also includes JavaScript, choo, surge.sh.

Is bloog actively maintained?

Dormant — no commits in 2+ years (last push 2017-03-26).

What license does bloog use?

The license is not specified in the project documentation, so check the repository files for license details.

How hard is bloog to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is bloog for?

Mainly developer.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.