diff --git a/README.md b/README.md
new file mode 100644
index 0000000..0e2c21a
--- /dev/null
+++ b/README.md
@@ -0,0 +1,51 @@
+# panblog
+
+panblog is a simple, minimal bash and pandoc-based static site generator. It takes a flat file directory of markdown files and can build a website inside a folder, or you can add just a new post to an existing panblog.
+
+panblog makes use of Pandoc, and specifically the template feature which allows the creation of html templates that include custom header and footer.
+
+## Installing
+
+Git clone or download this directory to your computer.
+
+## Usage
+
+Two ways to use:
+
+### Build entire site
+
+```
+./build.sh
+```
+
+Looks for all markdown files in the directory, then builds a folder site/ (or change name in template/build.sh) with each post by default in its own sub-folder so you can have a clean URLs.
+
+e.g.
+
+```
+site/
+- index.md
+- index.html
+-----/post1/
+-------index.html
+-----/post2/
+-------index.html
+```
+
+### Create a single post and add to site
+
+```
+./post.sh postname.md
+```
+
+Takes a single specified file and adds it to the site/ folder (or change in template/post.sh) with each post by default in its own sub-folder.
+
+## Themes
+
+panblog comes with several theme options. A theme should be specified in your templates files.
+
+## License
+
+cc0 Public Domain
+
+Issues / pull requests considered.
diff --git a/build.sh b/build.sh
new file mode 100755
index 0000000..e660c43
--- /dev/null
+++ b/build.sh
@@ -0,0 +1,35 @@
+#!/bin/bash
+
+# change if you'd like a different destination directory
+site_folder=site
+
+# templates folder location
+templates=templates
+
+# make site folder if doesn't exist
+mkdir -p $site_folder
+
+# copy over themes
+mkdir -p "$site_folder"/css
+cp -r themes/*.css "$site_folder"/css
+
+
+for file in *.md
+do
+ post_name=$file
+
+ # uncomment this section if you prefer flat hierarchy postname.md -> postname.html in single folder
+ # pandoc --standalone --template templates/template.html $1 -o $site_folder/"${file.md}.html"
+
+ # uncomment this section if you prefer posts to be in their own subfolder so permalinks are website.com/postname/
+ mkdir -p $site_folder/$post_name
+ pandoc --standalone --template $templates/post_template.html $file -o $site_folder/$post_name/index.html
+
+ # build site index
+ touch $site_folder/index.md
+ echo "[$post_name]($post_name/)">>$site_folder/index.md
+ echo ""
+
+done
+
+pandoc --standalone --template $templates/site_template.html $site_folder/index.md -o $site_folder/index.html
diff --git a/post.sh b/post.sh
new file mode 100755
index 0000000..06f72db
--- /dev/null
+++ b/post.sh
@@ -0,0 +1,28 @@
+#!/bin/bash
+
+# change if you'd like a different destination directory
+site_folder=site
+
+# templates folder location
+templates=templates
+
+# make site folder if doesn't exist
+mkdir -p $site_folder
+
+# copy over themes
+mkdir -p "$site_folder"/css
+cp -r themes/*.css "$site_folder"/css
+
+# uncomment this section if you prefer flat hierarchy postname.md -> postname.html in single folder
+# pandoc --standalone --template template.html $1 -o $site_folder/"${1%.md}.html"
+
+# uncomment this section if you prefer posts to be in their own subfolder so permalinks are website.com/postname/
+post_name="${1%.md}"
+mkdir -p $site_folder/$post_name
+pandoc --standalone --template $templates/post_template.html $1 -o $site_folder/$post_name/index.html
+
+# build site index
+touch $site_folder/index.md
+echo "[$post_name]($post_name/)">>$site_folder/index.md
+echo ""
+pandoc --standalone --template $templates/site_template.html $site_folder/index.md -o $site_folder/index.html
diff --git a/templates/post_template.html b/templates/post_template.html
new file mode 100644
index 0000000..7f93156
--- /dev/null
+++ b/templates/post_template.html
@@ -0,0 +1,15 @@
+
+
+