reformat mech docs and add anchors

Author: bosh

docs/mechs/accelerometers.md

@@ -32,17 +32,17 @@ For
 [conditional events](../events/overview/conditional.md), the prefix for accelerometers is
 `device.accelerometers.(name)`.
 
-*value*
+### *value*:
 
-:   A three-item tuple (x, y, z) of the current accelerometer values.
+A three-item tuple (x, y, z) of the current accelerometer values.
 
 ## Related How To guides
 
 [Help us to write it](../about/help.md)
 
 ## Related Events
 
-*None*
+### *None*:
 
-:   Varies based on the configured (you can configure events to be
-    emitted when certain G-force thresholds are exceeded).
+Varies based on the configured (you can configure events to be
+emitted when certain G-force thresholds are exceeded).

docs/mechs/autofire_coils.md

@@ -207,10 +207,9 @@ For
 [dynamic values](../config/instructions/dynamic_values.md) and
 [conditional events](../events/overview/conditional.md), the prefix for autofire coils is `device.autofires.(name)`.
 
-*enabled*
+### *enabled*:
 
-:   Boolean (true/false) which shows whether this autofire coil is
-    enabled.
+Boolean (true/false) which shows whether this autofire coil is enabled.
 
 ## Fully working basic example
 
@@ -306,7 +305,6 @@ A few comments on the above example:
 
 ## Related Events
 
-*None*
+### *None*:
 
-:   The autofire coils can be configured to enable or disable based on
-    other events.
+The autofire coils can be configured to enable or disable based on other events.

docs/mechs/ball_devices/index.md

@@ -119,19 +119,19 @@ For
 [conditional events](../../events/overview/conditional.md), the prefix for ball devices is
 `device.ball_devices.(name)`.
 
-*available_balls*
+### *available_balls*:
 
-:   Number of balls that are available to be ejected. This differs from
-    *balls* since it's possible that this device could have balls that
-    are being used for some other eject, and thus not available.
+Number of balls that are available to be ejected. This differs from
+*balls* since it's possible that this device could have balls that
+are being used for some other eject, and thus not available.
 
-*state*
+### *state*:
 
-:   What state this device is in.
+What state this device is in.
 
-*balls*
+### *balls*:
 
-:   How many balls this device is currently holding.
+How many balls this device is currently holding.
 
 ## Related How To guides
 

docs/mechs/diverters/index.md

@@ -176,20 +176,20 @@ For
 [dynamic values](../../config/instructions/dynamic_values.md) and
 [conditional events](../../events/overview/conditional.md), the prefix for diverters is `device.diverters.(name)`.
 
-*active*
+### *active*:
 
-:   Boolean (true/false) as to whether this diverter is actively on and
-    in the powered state.
+Boolean (true/false) as to whether this diverter is actively on and
+in the powered state.
 
-*enabled*
+### *enabled*:
 
-:   Boolean (true/false) as to whether this diverter is enabled (meaning
-    it will be activated when a ball approaches it).
+Boolean (true/false) as to whether this diverter is enabled (meaning
+it will be activated when a ball approaches it).
 
-*eject_state*
+### *eject_state*:
 
-:   Boolean (true/false) which shows whether this diverter will be
-    activating to route a ball eject from an upstream ball device.
+Boolean (true/false) which shows whether this diverter will be
+activating to route a ball eject from an upstream ball device.
 
 ## Related How To guides
 

docs/mechs/flippers/index.md

@@ -97,9 +97,9 @@ For
 [dynamic values](../../config/instructions/dynamic_values.md) and
 [conditional events](../../events/overview/conditional.md), the prefix for flippers is `device.flippers.(name)`.
 
-*enabled*
+### *enabled*:
 
-:   Boolean (true/false) which shows whether this ball hold is enabled.
+Boolean (true/false) which shows whether this ball hold is enabled.
 
 ## Related How To guides
 

docs/mechs/kickbacks.md

@@ -46,9 +46,9 @@ For
 [dynamic values](../config/instructions/dynamic_values.md) and
 [conditional events](../events/overview/conditional.md), the prefix for kickbacks is `device.kickbacks.(name)`.
 
-*enabled*
+### *enabled*:
 
-:   Boolean (true/false) which shows whether this kickback is enabled.
+Boolean (true/false) which shows whether this kickback is enabled.
 
 ## Related Events
 

docs/mechs/lights/gis.md

@@ -104,11 +104,11 @@ For
 [dynamic values](../../config/instructions/dynamic_values.md) and
 [conditional events](../../events/overview/conditional.md), the prefix for lights is `device.lights.(name)`.
 
-*color*
+### *color*:
 
-:   The color of this string. If you set it to brightness values all
-    color channels will have the same value. Brightness 100 (of 255)
-    will be hex 64 and color 646464.
+The color of this string. If you set it to brightness values all
+color channels will have the same value. Brightness 100 (of 255)
+will be hex 64 and color 646464.
 
 ## Related How To guides
 

docs/mechs/magnets/index.md

@@ -95,14 +95,13 @@ For
 [dynamic values](../../config/instructions/dynamic_values.md) and
 [conditional events](../../events/overview/conditional.md), the prefix for magnets is `device.magnets.(name)`.
 
-*active*
+### *active*:
 
-:   Boolean (true/false) as to whether this magnet is actively on and in
-    the powered state.
+Boolean (true/false) as to whether this magnet is actively on and in the powered state.
 
-*enabled*
+### *enabled*:
 
-:   Boolean (true/false) which shows whether this ball hold is enabled.
+Boolean (true/false) which shows whether this ball hold is enabled.
 
 ## Related How To guides
 

docs/mechs/servos/index.md

@@ -49,10 +49,9 @@ For
 [dynamic values](../../config/instructions/dynamic_values.md) and
 [conditional events](../../events/overview/conditional.md), the prefix for servos is `device.servos.(name)`.
 
-*position*
+### *position*:
 
-:   Value, stored in memory of what servo position should be, on a scale
-    from 0.0 to 1.0.
+Value, stored in memory of what servo position should be, on a scale from 0.0 to 1.0.
 
 Related How To guides:
 

docs/mechs/targets/drop_targets/drop_target_bank.md

@@ -51,18 +51,17 @@ For
 [conditional events](../../../events/overview/conditional.md), the prefix for drop target banks is
 `device.drop_target_banks.(name)`.
 
-*complete*
+### *complete*:
 
-:   Boolean (true/false) which shows whether every target in this bank
-    is complete (down).
+Boolean (true/false) which shows whether every target in this bank is complete (down).
 
-*down*
+### *down*:
 
-:   Number of drop targets in the bank that are in the down state.
+Number of drop targets in the bank that are in the down state.
 
-*up*
+### *up*:
 
-:   Number of drop targets in the bank that are in the up state.
+Number of drop targets in the bank that are in the up state.
 
 ## Related How To guides