Clean up tutorial content formatting

Author: RealOrangeOne

docs/tutorials/basic-movement.md

@@ -1,16 +1,13 @@
----
-title: Basic Movement
----
+# Basic movement
 
 The example program we'll write will do a number of things with the motor: forwards and backwards, and different power settings, for example. Let's begin. To start off, we'll just make a motor move forwards, then backwards, and then repeat.
 
-### Forwards & backwards
+## Forwards & backwards
 
 Doing this is actually very easy; the only thing you need to realise is that a positive number is forwards and a negative number is backwards.
 
-{{% notice warning %}}
-The actual direction of travel of a motor, when mounted on a robot, will depend on its orientation and the way in which the wires are connected to the motor board. If the motor appears to be going in the wrong direction, just swap the motor's positive and negative wires over.
-{{% /notice %}}
+!!! tip
+    The actual direction of travel of a motor, when mounted on a robot, will depend on its orientation and the way in which the wires are connected to the motor board. If the motor appears to be going in the wrong direction, just swap the motor's positive and negative wires over.
 
 Here's the code:
 
@@ -37,19 +34,18 @@ while True:
     r.sleep(4)
 ```
 
-You're familiar with the first few lines; in fact, the only lines you may not be familiar with are the `r.motor_boards...` lines. For a comprehensive reference to the `motor` object, see [`motor` API](/api/motor-board) page.
+You're familiar with the first few lines; in fact, the only lines you may not be familiar with are the `r.motor_boards...` lines. For a comprehensive reference to the `motor` object, see [`motor` API](../api/motor-board.md) page.
 But, to summarise:
 
-`r.motor_boards.m0.power = 0.5` sets the target power of the motor connected to output 0 on the first [motor board](/kit/motor-board) to half speed forwards (i.e. a duty-cycle of 0.5 forwards). As you would expect, then, `-0.5` will put the this motor into reverse at half power.
+`r.motor_boards.m0.power = 0.5` sets the target power of the motor connected to output 0 on the first [motor board](../kit/motor-board.md) to half speed forwards (i.e. a duty-cycle of 0.5 forwards). As you would expect, then, `-0.5` will put the this motor into reverse at half power.
 `r.motor_boards.m0.power = 0` will brake the motor and stop it.
 
 So, if you put the above code on your robot, you should be able to see a motor spin forwards, stop, spin backwards, stop, and then repeat...
 
-{{% notice note %}}
-If you find that the motor doesn't turn when you run the above code, check that you've got all the cables connected to the right places, in particular note that the motor board has _two_ outputs.
-{{% /notice %}}
+!!! info
+    If you find that the motor doesn't turn when you run the above code, check that you've got all the cables connected to the right places, in particular note that the motor board has _two_ outputs.
 
-### Changing the speed
+## Changing the speed
 
 Now we're going to modify the program to vary the speed of the motor. Our aim is to do the forwards and backwards bit (as above), but, before we loop round again, ramp the power up to 70%, then down to -70%, and then back to 0 (all in steps of 10%). Here's the code:
 

docs/tutorials/index.md

@@ -3,6 +3,3 @@ title: Tutorials
 ---
 
 This part of the docs contains some practical guides for getting starting with both Python and the simulator.
-
-* [Basic Movement](basic-movement) - explains how to use the kit to operate a motor
-* [Python: A Whirlwind Tour](python-whirlwind-tour) - a guide to using Python, aimed towards those who haven't used it before

docs/tutorials/python-whirlwind-tour.md

@@ -1,10 +1,8 @@
----
-title: "Python: A Whirlwind Tour"
----
+# Python: A Whirlwind Tour
 
-# The Basics
+## Installation
 
-## Installing Python on Windows
+### Installing Python on Windows
 
 Below are step-by-step instructions for installing Python 3.9.6 (which is required for the competition):
 
@@ -22,7 +20,7 @@ Below are step-by-step instructions for installing Python 3.9.6 (which is requir
 
    ![A window with the heading "Setup was successful" and a 'close' button in the bottom right.](/img/tutorials/whrl-win-2.png)
 
-## Installing Python on Mac
+### Installing Python on Mac
 
 Below are step-by-step instruction for installing Python 3.9.6 (which is required for the competition):