diff --git a/doc/development/documentation/styleguide.md b/doc/development/documentation/styleguide.md index 721e26f2de9..15363b4750c 100644 --- a/doc/development/documentation/styleguide.md +++ b/doc/development/documentation/styleguide.md @@ -272,19 +272,19 @@ Inside the document: - For regular code blocks, always use a highlighting class corresponding to the language for better readability. Examples: - ```md - ```ruby - Ruby code - ``` + ````md + ```ruby + Ruby code + ``` - ```js - JavaScript code - ``` + ```js + JavaScript code + ``` - ```md - Markdown code - ``` - ``` + ```md + Markdown code + ``` + ```` - For a complete reference on code blocks, check the [Kramdown guide](https://about.gitlab.com/handbook/product/technical-writing/markdown-guide/#code-blocks).