experimenting with the markup

Author: elucash

factory.md

@@ -8,6 +8,7 @@ layout: page
 
 Overview
 --------
+
 Do not repeat yourself writing builders for your APIs, with all that overhead of fluent structure and checking.
 Generate builders for static factory methods as easily as you would generate builders for [immutable values](/immutable.html).
 A factory builder can be seen as a form of partial function application - Supply named parameters one by one and evaluate the function at the end.

immutable.md

@@ -8,6 +8,7 @@ layout: page
 
 Overview
 --------
+
 To reap the benefits of immutability in Java, we created an annotation processor
 to easily create simple and consistent value objects. You can think of it as
 [Guava's Immutable Collections](https://code.google.com/p/guava-libraries/wiki/ImmutableCollectionsExplained) but for regular objects.
@@ -30,12 +31,13 @@ services, and of good design in general. We feel proud to fill a gap in the area
 See [sample generated code](/generated.html) for an example of the code generated by the processor,
 or jump straight to the [features](/immutable.html#features)!
 
---------
 Concepts
 --------
 
 <a name="abstract-value"></a>
+
 ### Abstract value type
+
 An Abstract value type is a manually-written non-final (usually abstract) class or
 interface (or even annotation type) that defines the value type and is annotated with the
 `org.immutable.value.Value.Immutable` annotation.
@@ -44,7 +46,9 @@ It is strongly recommended that abstract value types not introduce visible mutab
 Abstract value types are used as the source model for generated code. [Get started!](/getstarted.html).
 
 <a name="attributes"></a>
+
 ### Attributes
+
 An attribute holds a value that cannot be changed after the owning object is created.
 The name "attribute" is used to intentionally distinguish the concept from "fields" or JavaBean "properties", and to imply a similarity with Java annotation attributes.
 It is defined by an accessor method: A zero argument, non-`void`-returning Java method.
@@ -54,6 +58,7 @@ are non-`abstract` methods that have bodies that compute values.
 Such accessors therefore require special annotations to distinguish them from regular methods.
 
 ### Immutable implementation class
+
 A [Generated](/generated.html) `final` class that extends a manually-written [abstract value type](#abstract-value)
 and implements all declared accessor methods as well as supporting fields, methods, constructors, and a builder class.
 An immutable implementation class implements abstract attribute accessors
@@ -65,11 +70,12 @@ Immutable implementation classes are the primary (but not the only) source code
 generated by the _Immutables_ annotation processor.
 
 <a name="features"></a>
---------
+
 Features
 --------
 
 ### Value
+
 The annotation processor works by using annotated abstract value types as a model to generate immutable implementations.
 A generated implementation extends or implements an abstract value type. Classes don't have to be abstract if they don't define abstract accessor methods.