diff --git a/website/docs/creating-pages.md b/website/docs/creating-pages.md
index b2d632030cb2..9b1bef9c8929 100644
--- a/website/docs/creating-pages.md
+++ b/website/docs/creating-pages.md
@@ -66,7 +66,7 @@ How are you?
In the same way, a page will be created at `http://localhost:3000/helloMarkdown`.
-Markdown pages are a bit less flexible that React pages, because the default layout is applied.
+Markdown pages are less flexible than React pages, because it always uses the theme layout.
Here's an [example markdown page](/examples/markdownPageExample).
diff --git a/website/src/pages/examples/markdownPageExample.md b/website/src/pages/examples/markdownPageExample.md
index 0caf719a22c7..9cbb1bf1aa84 100644
--- a/website/src/pages/examples/markdownPageExample.md
+++ b/website/src/pages/examples/markdownPageExample.md
@@ -9,7 +9,11 @@ This is a page generated from markdown to illustrate the markdown page feature.
It supports all the regular MDX features, as you can see:
-:::info Useful information. :::
+:::info
+
+Useful information.
+
+:::
```jsx live
function Button() {
@@ -23,6 +27,8 @@ function Button() {
![](../../../static/img/docusaurus.png)
-import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem';
+import Tabs from '@theme/Tabs';
+
+import TabItem from '@theme/TabItem';
- This is an apple 🍎 This is an orange 🍊 This is a banana 🍌
+This is an apple 🍎This is an orange 🍊This is a banana 🍌