skills/mechanics/throw.md

-Mechanic: Throw
 ===============
 
+## Description:
+
 Throws all targets away from the mob (or origin).
 
-Attributes
-----------
+## Attributes:
 
 | Attribute | Aliases | Description                                           | Default Value |
 |-----------|---------|-------------------------------------------------------|---------------|
 | velocity  | v       | The horizontal velocity at which the entity is throw. | 1             |
 | velocityY | vy      | The vertical velocity at which the entity is thrown   | 1             |
 
+## Examples:
 
-
-Examples
---------
+In this example the mob will create an explosion effect around them that
+inflicts 10 damage (5 hearts) to players within a radius of 5 blocks and
+will knock them back. Giving the illusion of a powerful explosion.
 ```yaml
 GroundSlam:
   Skills:
@@ -22,12 +23,13 @@ GroundSlam:
   - damage{amount=10} @PlayersInRadius{r=5}
   - throw{velocity=15;velocityY=5} @PlayersInRadius{r=5}
 ```
-In this example the mob will create an explosion effect around them that
-inflicts 10 damage (5 hearts) to players within a radius of 5 blocks and
-will knock them back. Giving the illusion of a powerful explosion.
 
-Complex Examples
-----------------
+This complex example shows how the throw mechanic can be used in
+conjunction with other mechanics to make quite amazing effects. The
+caster unleashes a powerful shockwave that deals 50 damage (25 hearts)
+to all players within 10 blocks and using the **throw** mechanic causes
+them to be flung a small bit into the air. There is also extra effects
+added to make the attack more appealing to look at and intimidating.
 ```yaml
 SuperShockslam:
   Skills:
@@ -48,9 +50,3 @@ SuperShockslam:
   - delay 2
   - effect:particlering{p=largeexplode;a=40;vs=0.5;hs=0.5;s=0;y=0.3;points=20;radius=11} @Self
 ```
\ No newline at end of file
-This complex example shows how the throw mechanic can be used in
-conjunction with other mechanics to make quite amazing effects. The
-caster unleashes a powerful shockwave that deals 50 damage (25 hearts)
-to all players within 10 blocks and using the **throw** mechanic causes
-them to be flung a small bit into the air. There is also extra effects
-added to make the attack more appealing to look at and intimidating.
\ No newline at end of file