reformat more docs with anchors for options

Author: bosh

docs/hardware/spike/config.md

@@ -39,40 +39,40 @@ spike:
 
 Some notes on the settings:
 
-port:
+### port:
 
-:   Use the port of your USB-serial adapter or of the internal serial on
-    your computer. On Windows, this will have a name like "COM5".
+Use the port of your USB-serial adapter or of the internal serial on
+your computer. On Windows, this will have a name like "COM5".
 
-baud:
+### baud:
 
-:   This needs to match the value from Step 3 in the
-    [MPF SPIKE bridge instructions](mpf-spike-bridge.md). It is used to initialize the connection to SPIKE only.
-    Afterwards, the bridge will switch to `runtime_baud`.
+This needs to match the value from Step 3 in the
+[MPF SPIKE bridge instructions](mpf-spike-bridge.md). It is used to initialize the connection to SPIKE only.
+Afterwards, the bridge will switch to `runtime_baud`.
 
-flow_control:
+### flow_control:
 
-:   If your hardware supports flow control and you connected "RTS" and
-    "CTS" in the previous steps set this to True. It will make the
-    connection much more stable at higher speeds. It can be `False` for
-    a first test.
+If your hardware supports flow control and you connected "RTS" and
+"CTS" in the previous steps set this to True. It will make the
+connection much more stable at higher speeds. It can be `False` for
+a first test.
 
-runtime_baud:
+### runtime_baud:
 
-:   Note that since only control and switch information is sent across
-    this bus, 115k baud is plenty fast enough if you choose not to use a
-    DMD. However, if you want to use a DMD you need more speed (see
-    below for details).
+Note that since only control and switch information is sent across
+this bus, 115k baud is plenty fast enough if you choose not to use a
+DMD. However, if you want to use a DMD you need more speed (see
+below for details).
 
-debug:
+### debug:
 
-:   Set this to true for print more details in the log.
+Set this to true for print more details in the log.
 
-nodes:
+### nodes:
 
-:   This is a list of the node board addresses that your system has. You
-    can get this from the manual. Here's an example from Wrestlemania
-    Pro:
+This is a list of the node board addresses that your system has. You
+can get this from the manual. Here's an example from Wrestlemania
+Pro:
 
   ![image](../images/spike_node_table.png)
 

docs/hardware/spike/leds.md

@@ -67,26 +67,26 @@ lights:
     number: 8-47
 ```
 
-The backbox backlight
+### The backbox backlight
 
-:   Stern SPIKE systems have controllable brightness for the white
-    lights in the backbox that illuminate the translight. All of those
-    LEDs are tied together and controlled as one with the address `0-0`.
+Stern SPIKE systems have controllable brightness for the white
+lights in the backbox that illuminate the translight. All of those
+LEDs are tied together and controlled as one with the address `0-0`.
 
-GI (General Illumination)
+### GI (General Illumination)
 
-:   GI in Stern SPIKE systems are just regular LEDs. You can tag them
-    with the tag `gi` and then turn them on in the attract mode and/or
-    use them in shows for special effects. Really there's nothing
-    special about them. They're just lights. (Just remember they're
-    controlled and defined as "lights", not as "GIs".)
+GI in Stern SPIKE systems are just regular LEDs. You can tag them
+with the tag `gi` and then turn them on in the attract mode and/or
+use them in shows for special effects. Really there's nothing
+special about them. They're just lights. (Just remember they're
+controlled and defined as "lights", not as "GIs".)
 
-Flashers
+### Flashers
 
-:   Flashers in Stern SPIKE systems are also controlled just like normal
-    lights. They just happen to be super bright, but other than that,
-    use them like any other LED. (Just remember they're controlled and
-    defined as "lights", not as "flashers".)
+Flashers in Stern SPIKE systems are also controlled just like normal
+lights. They just happen to be super bright, but other than that,
+use them like any other LED. (Just remember they're controlled and
+defined as "lights", not as "flashers".)
 
 ## RGB LEDs
 

docs/mc/sound/tips_tricks.md

@@ -14,59 +14,59 @@ working with the sound & audio features in MPF.
 
 ## Common Digital Audio Terms
 
-Bit Depth
+### Bit Depth
 
-:   The number of bits used to represent and store a single sample. Bit
-    depth (also commonly referred to as sample resolution) determines
-    the number of possible levels that can be captured during
-    digitalization. 16-bit represents 65,536 (2 to the 16th power)
-    possible values. The MPF-MC audio library only supports 16-bit audio
-    files.
+The number of bits used to represent and store a single sample. Bit
+depth (also commonly referred to as sample resolution) determines
+the number of possible levels that can be captured during
+digitalization. 16-bit represents 65,536 (2 to the 16th power)
+possible values. The MPF-MC audio library only supports 16-bit audio
+files.
 
-Brickwall limiter
+### Brickwall limiter
 
-:   A brickwall limiter is used to ensure an audio signal does not
-    exceed a certain threshold. Any input value exceeding the threshold
-    is set to the threshold value. This is used in the mixing engine to
-    ensure 16-bit integers do not exceed their maximum value and wrap
-    around (which adds ugly sounding distortion). It is important to set
-    sound and track volume levels properly in order to avoid the
-    clipping that brickwall limiting adds when mixing signals that are
-    too loud.
+A brickwall limiter is used to ensure an audio signal does not
+exceed a certain threshold. Any input value exceeding the threshold
+is set to the threshold value. This is used in the mixing engine to
+ensure 16-bit integers do not exceed their maximum value and wrap
+around (which adds ugly sounding distortion). It is important to set
+sound and track volume levels properly in order to avoid the
+clipping that brickwall limiting adds when mixing signals that are
+too loud.
 
-[Ducking](ducking.md)
+### [Ducking](ducking.md)
 
-:   Ducking is an audio effect that lowers the level of one audio signal
-    based upon the level of another audio signal (one sound "ducks"
-    out of the way of another).
+Ducking is an audio effect that lowers the level of one audio signal
+based upon the level of another audio signal (one sound "ducks"
+out of the way of another).
 
-FLAC
+### FLAC
 
-:   Free Lossless Audio Codec (FLAC) is an audio file format which
-    allows digital audio to be losslessly compressed such that file size
-    is reduced without any information being lost.
+Free Lossless Audio Codec (FLAC) is an audio file format which
+allows digital audio to be losslessly compressed such that file size
+is reduced without any information being lost.
 
-Normalization
+### Normalization
 
-:   Normalization is the process of changing an audio recording's
-    overall volume by a fixed amount to reach a target level.
+Normalization is the process of changing an audio recording's
+overall volume by a fixed amount to reach a target level.
 
-Ogg Vorbis (OGG)
+### Ogg Vorbis (OGG)
 
-:   A free and open-source audio coding format. Ogg Vorbis is a lossy
-    compressed audio file format.
+A free and open-source audio coding format. Ogg Vorbis is a lossy
+compressed audio file format.
 
-Sample Rate
+### Sample Rate
 
-:   The number of samples per second taken from a continuous signal to
-    make a discrete signal. A common example of sample rate is CD audio
-    which is recorded at 44,100 Hz (44,100 samples per second).
+The number of samples per second taken from a continuous signal to
+make a discrete signal. A common example of sample rate is CD audio
+which is recorded at 44,100 Hz (44,100 samples per second).
 
-WAV
+### WAV
 
-:   Waveform Audio File Format is a Microsoft and IBM audio file format
-    standard for storing an audio bitstream on computers. WAV is a
-    lossless uncompressed audio file format.
+Waveform Audio File Format is a Microsoft and IBM audio file format
+standard for storing an audio bitstream on computers. WAV is a
+lossless uncompressed audio file format.
 
 ## Preparing your sound files for use in MPF
 

docs/mc/widgets/segment_display_emulator/index.md

@@ -117,23 +117,21 @@ you don't want an initial text value, use "".
 
 The current display flash mode. Options include:
 
-`off`
+#### `off`:
 
-:   The segment display does not flash (flashing is off). This is the
-    default.
+The segment display does not flash (flashing is off). This is the default.
 
-`all`
+#### `all`:
 
-:   All characters in the display will flash.
+All characters in the display will flash.
 
-`match`
+#### `match`:
 
-:   Only the last two characters in the display will flash.
+Only the last two characters in the display will flash.
 
-`mask`
+#### `mask`:
 
-:   The `flash_mask` parameter determines which characters in the
-    display will flash.
+The `flash_mask` parameter determines which characters in the display will flash.
 
 ### flash_frequency:
 
@@ -156,14 +154,13 @@ wish for the non-flashing character positions.
 
 The type of display (7 segment, 14 segment). Options include:
 
-`7seg`
+#### `7seg`:
 
-:   The segment display emulates a 7-segment display.
+The segment display emulates a 7-segment display.
 
-`14seg`
+#### `14seg`:
 
-:   The segment display emulates a 14-segment display. This is the
-    default value.
+The segment display emulates a 14-segment display. This is the default value.
 
 ### character_count:
 

docs/mc/widgets/video.md

@@ -91,57 +91,58 @@ start playing automatically. Default is `True`.
 
 Sets what happens when the video ends. Options include:
 
-`loop`
+#### `loop`:
 
-:   The video loops and starts playing again
+The video loops and starts playing again
 
-`pause`
+#### `pause`:
 
-:   The video stops and stays at the end (so it continues showing the
-    final frame)
+The video stops and stays at the end (so it continues showing the final frame)
 
-`stop`
+#### `stop`:
 
-:   The video stops and the position is reset back to the beginning.
-    This is the default.
+The video stops and the position is reset back to the beginning.
+This is the default.
 
 ### control_events:
 
 Control the playback of this video with MPF events. Options include:
 
-`play`
+#### `play`:
 
-:   Starts playing the video from its current position.
+Starts playing the video from its current position.
 
-`pause`
+#### `pause`:
 
-:   Pauses the video at its current position.
+Pauses the video at its current position.
 
-`stop`
+#### `stop`:
 
-:   Stops the video and resets the position back to the beginning.
+Stops the video and resets the position back to the beginning.
 
-`seek`
+#### `seek`:
 
-:   Moves the video to a certain position based on a percentage. `0` is
-    the beginning of the video, `1` is the end, `0.5` is 50% through,
-    etc. (This is similar to `position:`, except it's based on percent
-    instead of position.
+Moves the video to a certain position based on a percentage. `0` is
+the beginning of the video, `1` is the end, `0.5` is 50% through,
+etc. (This is similar to `position:`, except it's based on percent
+instead of position.
 
-    This setting does not change the play/stop state.
+This setting does not change the play/stop state.
 
-`position`
+#### `position`:
 
-:   Moves the video to a certain position based on the time, (in
-    seconds). In other words `value: 4.2` here would move the video to
-    the 4.2 second mark. (This is similar to `seek:` except it's based
-    on seconds instead of percent.)
+Moves the video to a certain position based on the time, (in
+seconds). In other words `value: 4.2` here would move the video to
+the 4.2 second mark. (This is similar to `seek:` except it's based
+on seconds instead of percent.)
 
-`volume`
+#### `volume`:
 
-:   Sets the volume of the video on a scale from `0` to `1`.
+Sets the volume of the video on a scale from `0` to `1`.
 
-    This setting does not change the play/stop state.
+This setting does not change the play/stop state.
+
+### Control Events:
 
 To use control events, add a `control_events:` section to the video
 widget, then create a list (with dashes) of `event:`, `action:` and