mdbl0g

A simple, file-based, markdown-driven blog engine with web interface.

Features

  • light-weight
  • beautiful, minimalistic, HTML5 responsive default layout
  • file based, no data base needed
  • create, edit and delete in the web interface or upload files manually
  • web interface with live preview
  • no comments, no categories, no tags - just text*
  • markdown formatting
  • full text search
  • RSS feed
  • opt-out prettified URLs
  • English and German localization
  • simple and quick installer

*Customize with Plugins

You can easily add features to your mdbl0g by installing plugins. Just download one and drop it into the plugins/ directory. There are already some available at the mdbl0g Plugin Directory.

If you want to develop your own plugins, have a look at the Plugin API.

Installation

Requirements

You need at least PHP version 5.1.0, Apache mod_auth_basic for HTTP Basic Auth (Admin Interface) and optionally Apache mod_rewrite for Pretty URLs. Or any other web server that uses Apache configuration files and implements mod_auth_basic and mod_rewrite. You don't need any sort of database, because mdbl0g is a file based blog engine.

If you have no clue what all this means -- it will probably work ;) Just give it a shot!

Installation process

Download the mdbl0g files from GitHub and upload them to your server. You can also check out the repository with git which makes updating easier:

git clone git://github.com/Ps0ke/mdbl0g.git

Now point your browser to http://YOURDOMAIN.com/mdbl0g/install/ or where ever you uploaded the files. The installer will guide you through the simple installation process. When told to do so, delete the install/ directory and you are ready to go.

Import

Since the file format is very simple, you can easily export your existing blog to use the posts with mdbl0g. Here is a small script to import from Wordpress.

FAQ

Q: Isn't a file based blog really slow?

A: No. Network latency is a way bigger problem for performance as disc I/O. At least if you deal with a (for a blog) reasonable amount of data. I even tested the limits of mdbl0g, you can read about it at my (mdbl0g-driven) blog.

License

The MIT License:

Copyright (c) 2012 Philipp Stephan

Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the "Software"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

Powered by


Try It!

Posting

Later you will be able to try the Admin Interface without logging in and the posts will be deleted 24 hours later to get rid of too many "asdf", "test" and "PENIS" posts (and to save my ass if you write uncool stuff.)

You cannot delete the four main posts as these are automatically fetched from GitHub and are no "real" posts. Your posts will show up on page 2.

Markdown

mdbl0g uses markdown to format the posts. Markdown was invented by John Gruber to easily mark up text. The syntax is easy, it almost feels like writing a normal text file. Go read about it at it's home page. Some examples:

# Heading 1
## Heading 2 ...

**bold**, *italic*, [Link Text](http://example.com)

Sites that use mdbl0g: