diff --git a/metron-analytics/metron-maas-service/README.md b/metron-analytics/metron-maas-service/README.md
index 6b1663b..65f1a01 100644
--- a/metron-analytics/metron-maas-service/README.md
+++ b/metron-analytics/metron-maas-service/README.md
@@ -1,6 +1,6 @@
 # Model Management Infrastructure
 
-##Introduction
+## Introduction
 
 One of the main features envisioned and requested is the ability to augment the threat intelligence and enrichment processes with insights derived from machine learning or statistical models.  The challenges with this sort of infrastructure are
 * Applying the model may be sufficiently computationally/resource intensive that we need to support scaling via load balancing, which will require service discovery and management.
@@ -12,7 +12,7 @@
 * Deployment should happen using Yarn to manage resources
 * Clients should have new model endpoints pushed to them
 
-##Architecture
+## Architecture
 
 ![Architecture](maas_arch.png)
 
@@ -95,7 +95,7 @@
  -zr,--zk_root <arg>             Zookeeper Root
 ```
 
-##Stellar Integration
+## Stellar Integration
 
 Two Stellar functions have been added to provide the ability to call out to models deployed via Model as a Service.
 One aimed at recovering a load balanced endpoint of a deployed model given the name and, optionally, the version.
diff --git a/metron-platform/metron-indexing/README.md b/metron-platform/metron-indexing/README.md
index a536d87..0cf3a66 100644
--- a/metron-platform/metron-indexing/README.md
+++ b/metron-platform/metron-indexing/README.md
@@ -1,4 +1,4 @@
-#Indexing
+# Indexing
 
 ## Introduction
 
@@ -26,7 +26,7 @@
 
 By default, errors during indexing are sent back into the `indexing` kafka queue so that they can be indexed and archived.
 
-##Sensor Indexing Configuration
+## Sensor Indexing Configuration
 The sensor specific configuration is intended to configure the
 indexing used for a given sensor type (e.g. `snort`).  
 
diff --git a/metron-platform/metron-management/README.md b/metron-platform/metron-management/README.md
index 0cfcac5..b920460 100644
--- a/metron-platform/metron-management/README.md
+++ b/metron-platform/metron-management/README.md
@@ -1,4 +1,4 @@
-#Stellar REPL Management Utilities
+# Stellar REPL Management Utilities
 
 In order to augment the functionality of the Stellar REPL, a few
 management functions surrounding the management of the configurations
diff --git a/metron-platform/metron-parsers/README.md b/metron-platform/metron-parsers/README.md
index cc45834..97e8e5f 100644
--- a/metron-platform/metron-parsers/README.md
+++ b/metron-platform/metron-parsers/README.md
@@ -1,4 +1,4 @@
-#Parsers
+# Parsers
 
 ## Introduction
 
@@ -32,7 +32,7 @@
 `error` queue.  Invalid messages as determined by global validation
 functions are also treated as errors and sent to an `error` queue. 
  
-##Message Format
+## Message Format
 
 All Metron messages follow a specific format in order to ingest a message.  If a message does not conform to this format it will be dropped and put onto an error queue for further examination.  The message must be of a JSON format and must have a JSON tag message like so:
 
@@ -70,11 +70,11 @@
 }
 ```
 
-##Global Configuration 
+## Global Configuration 
 
 See the "[Global Configuration](../metron-common)" section.
 
-##Parser Configuration
+## Parser Configuration
 
 The configuration for the various parser topologies is defined by JSON
 documents stored in zookeeper.
@@ -103,7 +103,7 @@
 * Add new fields given the values of existing fields of a message
 * Remove existing fields of a message
 
-###`fieldTransformation` configuration
+### `fieldTransformation` configuration
 
 The format of a `fieldTransformation` is as follows:
 * `input` : An array of fields or a single field representing the input.  This is optional; if unspecified, then the whole message is passed as input.
@@ -201,7 +201,7 @@
 Note that the `dc2tz` map is in the parser config, so it is accessible
 in the functions.
 
-###An Example Configuration for a Sensor
+### An Example Configuration for a Sensor
 Consider the following example configuration for the `yaf` sensor:
 
 ```
@@ -225,12 +225,12 @@
 }
 ```
 
-##Parser Adapters
+## Parser Adapters
 
 Parser adapters are loaded dynamically in each Metron topology.  They
 are defined in the Parser Config (defined above) JSON file in Zookeeper.
 
-###Java Parser Adapters
+### Java Parser Adapters
 Java parser adapters are indended for higher-velocity topologies and are not easily changed or extended.  As the adoption of Metron continues we plan on extending our library of Java adapters to process more log formats.  As of this moment the Java adapters included with Metron are:
 
 * org.apache.metron.parsers.ise.BasicIseParser : Parse ISE messages
@@ -238,7 +238,7 @@
 * org.apache.metron.parsers.sourcefire.BasicSourcefireParser : Parse Sourcefire messages
 * org.apache.metron.parsers.lancope.BasicLancopeParser : Parse Lancope messages
 
-###Grok Parser Adapters
+### Grok Parser Adapters
 Grok parser adapters are designed primarly for someone who is not a Java coder for quickly standing up a parser adapter for lower velocity topologies.  Grok relies on Regex for message parsing, which is much slower than purpose-built Java parsers, but is more extensible.  Grok parsers are defined via a config file and the topplogy does not need to be recombiled in order to make changes to them.  An example of a Grok perser is:
 
 * org.apache.metron.parsers.GrokParser
@@ -247,7 +247,7 @@
 
 https://github.com/thekrakken/java-grok
 
-#Starting the Parser Topology
+# Starting the Parser Topology
 
 Starting a particular parser topology on a running Metron deployment is
 as easy as running the `start_parser_topology.sh` script located in
diff --git a/site-book/README.md b/site-book/README.md
index 6c6b7bd..bf579de 100644
--- a/site-book/README.md
+++ b/site-book/README.md
@@ -32,22 +32,22 @@
 ```
 
 
-##Key Components:
+## Key Components:
 
-###bin/generate-md.sh
+### bin/generate-md.sh
 
 - Copies all .md files from the code directory tree into the site tree
 - Performs some transformations on them
 - Generates the nav tree structure and labels
 - Happens during the site:pre-site phase of Maven.
 
-###bin/fix-md-dialect.py
+### bin/fix-md-dialect.py
 
 - Called by 'generate-md.sh'
 - Does transforms within the text of each file
     - Converts the Github-MD dialect of markdown into the doxia-markdown dialect
 
-###pom.xml and src/site/site.xml
+### pom.xml and src/site/site.xml
 
 - [Doxia](https://maven.apache.org/doxia/) boilerplate, tweaked for our specific needs