---json
{
    "description": "How to create a code block with indentation",
    "page_id": "sn155ly18463a077jbfkq",
    "title": "Preformatted (indented code block) - ComboStrap"
}
---

====== ComboStrap UI - Preformatted (Indented code block) ======


===== About =====
''Preformatted '' is a syntax that considers any successive lines that starts with two spaces as a ''block of code''.

This is also known as ''indented code block'' and is a minimal syntax to create a [[code|block of code]] with no syntax highlighting.

<badge>[[release:archive:1.11|since 1.11]]</badge>

===== Syntax =====
A line that starts with a couple of spaces is seen as a [[code|code of block]] with no syntax highlighting. If you want to add a language, you need to use the [[code|code component]]
<code dw class="no-whitespace-normalization">
  Two spaces starts a block of code
</code>


<note>
Without any content, the ''indented code block'' is not printed. You can disable this feature with the [[#preformattedEmptyContentNotPrintedEnable|preformattedEmptyContentNotPrintedEnable configuration]]
</note>

===== Demo =====

==== Default ====

<webcode name="Default" frameborder="0">
  * Input: A line that starts with two space
<code dw class="no-whitespace-normalization">
  A line that starts with a couple of spaces is seen as a code of block
  The next one with two spaces will also be part of the same block
</code>
  * Output: A block of code without any syntax highlighting
</webcode>


==== No content ====
Without any content, the ''indented code block'' is not printed.

You can disable this feature with the [[#preformattedEmptyContentNotPrintedEnable|preformattedEmptyContentNotPrintedEnable configuration]]


<webcode name="Default" frameborder="0">
  * There is two spaces below (You don't see them)
<code dw class="no-whitespace-normalization">
  
</code>
  * And there is no code block created as output. (ie below)
</webcode>


===== Configuration =====

==== preformattedEnable ====

The [[docs:app:configuration|configuration]] ''preformattedEnable'' permits to enable or disable this feature.

==== preformattedEmptyContentNotPrintedEnable ====

If this [[docs:app:configuration|configuration]] is not check, a block of code will be printed even if there is no content.