update readme and docs

Readme.md

@@ -40,7 +40,9 @@ It can do this because all of its logic is implemented with a series of plugins,
 _**Slate is currently in beta**. It's useable now, but you might need to pull request a fix or two for advanced use cases._
 
 
-## Why?
+<br/>
+
+### Why?
 
 Why create Slate? Well... _(Beware: this section has a few of [my](https://github.com/ianstormtaylor) opinions!)_
 
@@ -67,7 +69,9 @@ If that sounds familiar, you might like Slate.
 Which brings me to how Slate solves all of that...
 
 
-## Principles
+<br/>
+
+### Principles
 
 Slate tries to solve the question of "[Why?](#why)" with a few principles:
 
@@ -88,12 +92,16 @@ Slate tries to solve the question of "[Why?](#why)" with a few principles:
 7. **Clear "core" boundaries.** With a plugin-first architecture, and a schema-less core, it becomes a lot clearer where the boundary is between "core" and "custom", which means that the core experience doesn't get bogged down in edge cases.
 
 
-## Demo
+<br/>
+
+### Demo
 
 Check out the [**live demo**](http://slatejs.org) of all of the examples!
 
 
-## Examples
+<br/>
+
+### Examples
 
 To get a sense for how you might use Slate, check out a few of the examples:
 
@@ -111,7 +119,9 @@ To get a sense for how you might use Slate, check out a few of the examples:
 If you have an idea for an example that shows a common use case, pull request it!
 
 
-## Plugins
+<br/>
+
+### Plugins
 
 Slate encourages you to write small, reusable modules. Check out the public ones you can use in your project!
 
@@ -127,7 +137,9 @@ Slate encourages you to write small, reusable modules. Check out the public ones
 - [**See all the plugins...**](https://yarnpkg.com/en/packages?q=slate)
 
 
-## Documentation
+<br/>
+
+### Documentation
 
 If you're using Slate for the first time, check out the [Getting Started](http://docs.slatejs.org/walkthroughs/installing-slate) walkthroughs and the [Guides](http://docs.slatejs.org/guides) to familiarize yourself with Slate's architecture and mental models. Once you've gotten familiar with those, you'll probably want to check out the full [API Reference](http://docs.slatejs.org/slate-core).
 
@@ -140,7 +152,9 @@ If you're using Slate for the first time, check out the [Getting Started](http:/
 If even that's not enough, you can always [read the source itself](./src), which is heavily commented.
 
 
-## Translations
+<br/>
+
+### Translations
 
 There are also translations of the documentation into other languages:
 
@@ -149,7 +163,9 @@ There are also translations of the documentation into other languages:
 If you're maintaining a translation, feel free to pull request it here!
 
 
-## Contributing!
+<br/>
+
+### Contributing!
 
 All contributions are super welcome! Check out the [Contributing instructions](./Contributing.md) for more info!