diff --git a/website/docs/styleguide.mdx b/website/docs/styleguide.mdx
index b1d0c738f..1385b517e 100644
--- a/website/docs/styleguide.mdx
+++ b/website/docs/styleguide.mdx
@@ -63,9 +63,11 @@ project is using spaCy, you can grab one of our
 
 > #### Markdown
 >
-> ```markdown_
+> ```markdown
 > ## Headline 2
+>
 > ## Headline 2 {id="some_id"}
+>
 > ## Headline 2 {id="some_id" tag="method"}
 > ```
 >
@@ -207,7 +209,7 @@ the buttons are implemented as styled links instead of native button elements.
 
 > #### Markdown
 >
-> ```markdown_
+> ```markdown
 > | Header 1 | Header 2 |
 > | -------- | -------- |
 > | Column 1 | Column 2 |
@@ -241,7 +243,7 @@ be italicized:
 
 > #### Markdown
 >
-> ```markdown_
+> ```markdown
 > | Header 1 | Header 2 | Header 3 |
 > | -------- | -------- | -------- |
 > | Column 1 | Column 2 | Column 3 |
@@ -259,7 +261,7 @@ be italicized:
 
 > #### Markdown
 >
-> ```markdown_
+> ```markdown
 > ~~Model[List[Doc], Floats2d]~~
 > ```
 >
@@ -288,9 +290,9 @@ always be the **last element** in the row.
 
 > #### Markdown
 >
-> ```markdown_
-> | Header 1 | Header 2                |
-> | -------- | ----------------------- |
+> ```markdown
+> | Header 1 | Header 2               |
+> | -------- | ---------------------- |
 > | Column 1 | Column 2 ~~List[Doc]~~ |
 > ```
 
@@ -304,7 +306,7 @@ always be the **last element** in the row.
 
 > #### Markdown
 >
-> ```markdown_
+> ```markdown
 > 1. One
 > 2. Two
 > ```
@@ -335,8 +337,9 @@ automatically.
 
 > #### Markdown
 >
-> ```markdown_
+> ```markdown
 > > #### Aside title
+> >
 > > This is aside text.
 > ```
 >
@@ -360,7 +363,7 @@ become aside titles.
 
 > #### Markdown
 >
-> ````markdown_
+> ````markdown
 > ```python
 > ### This is a title
 > import spacy
@@ -396,7 +399,7 @@ adding `{highlight="..."}` to the headline. Acceptable ranges are spans like
 
 > #### Markdown
 >
-> ````markdown_
+> ````markdown
 > ```python
 > ### This is a title {highlight="1-2"}
 > import spacy
@@ -424,7 +427,7 @@ interactive widget defaults to a regular code block.
 
 > #### Markdown
 >
-> ````markdown_
+> ````markdown
 > ```python
 > ### {executable="true"}
 > import spacy
@@ -447,7 +450,7 @@ original file is shown at the top of the widget.
 
 > #### Markdown
 >
-> ````markdown_
+> ````markdown
 > ```python
 > https://github.com/...
 > ```