diff --git a/docs/en/userguide/about-translatable.md b/docs/en/userguide/about-translatable.md
index 600357c..934447e 100644
--- a/docs/en/userguide/about-translatable.md
+++ b/docs/en/userguide/about-translatable.md
@@ -2,11 +2,11 @@
 
 The SilverStripe Translatable module allows you to create and edit multiple pages in various languages. This module also adds the ability for your users to select which language of a page they wish to view.
 
-<div class="note" markdown="1">
+[note]
 Notes:
 
 The SilverStripe Translatable module does not translate content automatically, content authors will need to enter the translated content manually for each translated page.
-</div>
+[/note]
 
 To begin translating content select a page in your site tree from the "Pages" admin. You can see in the below image:
 
diff --git a/docs/en/userguide/index.md b/docs/en/userguide/index.md
index 6bccd84..df848db 100644
--- a/docs/en/userguide/index.md
+++ b/docs/en/userguide/index.md
@@ -1,5 +1,7 @@
+---
 title: Working with translations
 summary: Adding translated content to your website.
+---
 
 # Working with translations