Skip to content


Subversion checkout URL

You can clone with
Download ZIP
A way to retrieve blog posts that are being served in this stupid-simple format
JavaScript HTML
Branch: master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.

Build Status

Noddity Retrieval

This module provides an API to a Noddity data store full of posts and a list of said posts.

You give it an http(s) root, and that's all it needs to provide

  • an async getter function to download parsed post objects
  • an async getter function to download an array of post objects based on the index.json file from the root directory

So I have this idea, right? Where your blog posts could just be a directory with an index file and a bunch of markdown files, just being served out onto the internet.

The idea is that your root directory of posts contains:

  • An index.json file, containing a JSON array of strings representing the file names that are your "official" blog posts, in order.
  • Whatever markdown files you want to be accessible, with metadata stored in a format amenable to text-metadata-parser.


var retrieve = new Retrieve('')

retrieve.getIndex(function(err, index) {
    if (!err && index.length > 0) {
        // Get the most recent post
        retrieve.getPost(index.pop(), function(err, post) {
            console.log("Found post named " + post.metadata.title)
            console.log("The words inside it are:\n" + post.content)

This is the core module of the Noddity cms.



Something went wrong with that request. Please try again.