howto/raid.md

 [[_TOC_]]
 
-Software RAID
-=============
+# Software RAID
 
-Replacing a drive
------------------
+## Replacing a drive
 
 If a drive fails in a server, the procedure is essentially to open a
 ticket, wait for the drive change, partition and re-add it to the RAID
@@ -35,8 +33,7 @@ drive models.
 Note that Hetzner also has [pretty good documentation on how to deal
 with SMART output](https://wiki.hetzner.de/index.php/Seriennummern_von_Festplatten_und_Hinweise_zu_defekten_Festplatten/en).
 
-Hardware RAID
-=============
+# Hardware RAID
 
 Some TPO machines have hardware RAID with `megaraid`
 controllers. Those are controlled with the `MegaCLI` command that is
@@ -95,8 +92,7 @@ This will make the drive blink (slot number 0 in enclosure 252):
 
     megacli -PdLocate -start -physdrv[252:0] -aALL
 
-SMART monitoring
-----------------
+## SMART monitoring
 
 Some servers will fail to properly detect disk drives in their SMART
 configuration. In particular, `smartd` does not support:
@@ -127,8 +123,7 @@ Other hardware RAID controllers are better supported. For example, the
 `megaraid` controller on `moly` was correctly detected by `smartd`
 which accurately found a broken hard drive.
 
-References
-----------
+## References
 
 Here are some external documentation links: