9 files changed, 13 insertions, 22 deletions
diff --git a/docs/Model-Notes/AireOS.md b/docs/Model-Notes/AireOS.md
index 5674ae2..bf20ebb 100644
--- a/docs/Model-Notes/AireOS.md
+++ b/docs/Model-Notes/AireOS.md
@@ -1,5 +1,4 @@
-Cisco WLC Configuration
-=======================
+# Cisco WLC Configuration
 
 Create a user with read-write privilege:
 
diff --git a/docs/Model-Notes/ArbOS.md b/docs/Model-Notes/ArbOS.md
index ebac997..c0b0376 100644
--- a/docs/Model-Notes/ArbOS.md
+++ b/docs/Model-Notes/ArbOS.md
@@ -1,5 +1,4 @@
-Arbor Networks ArbOS notes
-==========================
+# Arbor Networks ArbOS notes
 
 If you are running ArbOS version 7 or lower then you may need to update the model to remove `exec true`:
 
diff --git a/docs/Model-Notes/Comware.md b/docs/Model-Notes/Comware.md
index 048f312..9acae5a 100644
--- a/docs/Model-Notes/Comware.md
+++ b/docs/Model-Notes/Comware.md
@@ -1,5 +1,4 @@
-Comware Configuration
-=====================
+# Comware Configuration
 
 If you find 3Com Comware devices aren't being backed up this may be due to prompt detection not matching because a previous login message is disabled after the first prompt.
 
diff --git a/docs/Model-Notes/EOS.md b/docs/Model-Notes/EOS.md
index 199fe46..d6992d7 100644
--- a/docs/Model-Notes/EOS.md
+++ b/docs/Model-Notes/EOS.md
@@ -1,5 +1,4 @@
-Arista EOS Configuration
-========================
+# Arista EOS Configuration
 
 By default, EOS requires the `keyboard-interactive` SSH authentication method for a successful SSH login. To add support for this method to your Oxidized configuration, see the [SSH Auth Methods](../Configuration.md#ssh-auth-methods) directive.
 
diff --git a/docs/Model-Notes/JunOS.md b/docs/Model-Notes/JunOS.md
index 8093df0..3dd4d44 100644
--- a/docs/Model-Notes/JunOS.md
+++ b/docs/Model-Notes/JunOS.md
@@ -1,5 +1,4 @@
-JunOS Configuration
-===================
+# JunOS Configuration
 
 Create login class cfg-view
 
diff --git a/docs/Model-Notes/Netgear.md b/docs/Model-Notes/Netgear.md
index 97ea613..150e117 100644
--- a/docs/Model-Notes/Netgear.md
+++ b/docs/Model-Notes/Netgear.md
@@ -1,9 +1,8 @@
-Netgear Configuration
-=====================
+# Netgear Configuration
 
 There are several models available with CLI management via telnet (port 60000), but they all behave like one of the following:
 
-### Older models:
+## Older models
 
 ```text
 Connected to 192.168.3.201.
@@ -19,7 +18,7 @@ Password:
 (GS748Tv4) #show running-config
 ```
 
-### Newer models:
+## Newer models
 
 ```text
 Connected to 172.0.3.203.
@@ -47,7 +46,7 @@ Configuration for older/newer models: make sure you have defined variable 'enabl
 
 One possible configuration:
 
-### oxidized config
+## oxidized config
 
 ```yaml
 source:
@@ -65,7 +64,7 @@ source:
       telnet_port: 5
 ```
 
-### router.db
+## router.db
 
 ```text
 switchOldFW:netgear:admin:adminpw::60000
diff --git a/docs/Model-Notes/README.md b/docs/Model-Notes/README.md
index aa0c25e..bf3c5f6 100644
--- a/docs/Model-Notes/README.md
+++ b/docs/Model-Notes/README.md
@@ -1,5 +1,4 @@
-Model Notes
-===========
+# Model Notes
 
 This directory contains implementation notes and caveats to assist you in your oxidized deployment.
 
diff --git a/docs/Model-Notes/VRP-Huawei.md b/docs/Model-Notes/VRP-Huawei.md
index ff5426e..604f002 100644
--- a/docs/Model-Notes/VRP-Huawei.md
+++ b/docs/Model-Notes/VRP-Huawei.md
@@ -1,5 +1,4 @@
-Huawei VRP Configuration
-========================
+# Huawei VRP Configuration
 
 Create a user with no privileges
 
diff --git a/docs/Model-Notes/XGS4600-Zyxel.md b/docs/Model-Notes/XGS4600-Zyxel.md
index aee47ef..769c422 100644
--- a/docs/Model-Notes/XGS4600-Zyxel.md
+++ b/docs/Model-Notes/XGS4600-Zyxel.md
@@ -1,5 +1,4 @@
-ZynOS Configuration
-===================
+# ZynOS Configuration
 
 ## FTP