Merge pull request #291 from X4vi3/blank-lines-requirement

Document the required blank lines around YFM block constructions

Author: bloodmike

en/_includes/blank-lines-note.md

@@ -0,0 +1,5 @@
+{% note warning %}
+
+A construction works only when it is separated by empty lines — outside (before the opening tag and after the closing one) and inside (between the tags and the content). Otherwise it won't render and will stay as plain text.
+
+{% endnote %}

en/syntax/cuts-tabs.md

@@ -8,6 +8,8 @@ The content of cuts and tabs can include any YFM markup.
 
 {% endnote %}
 
+{% include [blank-lines](../_includes/blank-lines-note.md) %}
+
 ## Cuts {#cuts}
 
 Use cuts to hide content. For example, additional information or long blocks of code.

en/syntax/notes.md

@@ -12,6 +12,8 @@ Depending on the content, notes with different titles and formatting are used:
 
 Notes can include any YFM markup, but we don't recommend overloading them with elements. Choose a simple design and don't overuse notes because this will distract the user from the main content.
 
+{% include [blank-lines](../_includes/blank-lines-note.md) %}
+
 ## Comment
 
 ```markdown

ru/_includes/blank-lines-note.md

@@ -0,0 +1,5 @@
+{% note warning %}
+
+Конструкция работает, только если отделена пустыми строками — снаружи (до открывающего и после закрывающего тега) и внутри (между тегами и содержимым). Иначе она не обработается и останется обычным текстом.
+
+{% endnote %}

ru/syntax/interactive-elements/accordion.md

@@ -2,6 +2,8 @@
 
 Аккордеон позволяет свернуть или раскрыть содержимое по вашему выбору, подходит для организации больших объемов информации.
 
+{% include [blank-lines](../../_includes/blank-lines-note.md) %}
+
 ```markdown
 {% list tabs accordion %}
 

ru/syntax/interactive-elements/cuts.md

@@ -2,6 +2,8 @@
 
 Используйте каты, чтобы скрыть часть контента. Например, дополнительную информацию или длинные блоки кода.
 
+{% include [blank-lines](../../_includes/blank-lines-note.md) %}
+
 ```markdown
 {% cut "Заголовок ката" %}
 

ru/syntax/interactive-elements/dropdown.md

@@ -2,6 +2,8 @@
 
 Дропдаун — выпадающий список. Используйте его для группировки элементов со скрытым контентом.
 
+{% include [blank-lines](../../_includes/blank-lines-note.md) %}
+
 ```markdown
 {% list tabs dropdown %}
 

ru/syntax/interactive-elements/index.md

@@ -12,4 +12,6 @@
 
 Содержимое интерактивных элементов разметки может включать любую разметку YFM.
 
-{% endnote %}
+{% endnote %}
+
+{% include [blank-lines](../../_includes/blank-lines-note.md) %}

ru/syntax/interactive-elements/tabs.md

@@ -2,6 +2,8 @@
 
 Используйте табы для взаимоисключающих разделов. Например, чтобы разделить инструкции для разных ОС.
 
+{% include [blank-lines](../../_includes/blank-lines-note.md) %}
+
 ```markdown
 {% list tabs %}
 

ru/syntax/notes.md

@@ -11,6 +11,8 @@
 
 Заметки могут включать любую разметку YFM, но не рекомендуется перегружать их элементами. Выбирайте простое оформление и не используйте заметки слишком часто, так как это будет отвлекать пользователя от основного содержимого.
 
+{% include [blank-lines](../_includes/blank-lines-note.md) %}
+
 ## Примечание {#info}
 
 ```markdown