Markdown — це формат запису; HTML — це формат публікації. Таким чином, синтаксис Markdown не призначений для забезпечення повної універсальності HTML, а лише для найпоширеніших елементів для письмового тексту. Якщо вам потрібно зробити щось складніше, ви можете використовувати будь-який вбудований тег HTML і теги рівня блоку, які підтримуються DevSite у файлі Markdown. Немає необхідності вказувати, що ви переходите з Markdown на HTML, просто використовуйте тег HTML, як у прикладі нижче.
This sentence is in Markdown with a <b>bold inline HTML tag</b>.
Вбудований HTML
Вбудовані теги HTML можна використовувати в абзаці Markdown, елементі списку або заголовку, і вони також можуть містити синтаксис Markdown (наприклад, **strong** , *emphasis* тощо). Це корисно, коли ви хочете привернути увагу до трохи коду, як у прикладі нижче.
This is a Markdown paragraph about Java:
<code>System.out.format("The square of *%d* is *%f*.*%n*", i, r);</code>
HTML на рівні блоку
Теги HTML на рівні блоку, які підтримуються DevSite, мають бути відокремлені від навколишнього вмісту порожнім рядком. На відміну від вбудованих тегів HTML, синтаксис Markdown (наприклад, **strong** , *emphasis* тощо) у тегах HTML на рівні блоку не відображається, як у прикладі нижче.
This is a Markdown paragraph that explains Java format strings:
// required blank line
<pre>
System.out.format("The square of *%d* is *%f*.*%n*", i, r);
</pre>
// required blank line
This is another Markdown paragraph.
Кращі практики
Ми рекомендуємо форматувати HTML у файлах Markdown наступними способами, щоб запобігти помилкам відтворення на DevSite.
Не використовуйте непідтримувані теги HTML на рівні блоків. DevSite підтримує багато тегів HTML на рівні блоків; але включення непідтримуваного коду або відтворить ваш HTML як текст, або порушить код.
Не додавайте додаткових табуляцій або пробілів під час відступів. Початкові та кінцеві теги на рівні блоку не повинні мати відступи табуляції чи пробілів. Деякі редактори автоматично додають додаткові табуляції або пробіли — увага!
This is a regular paragraph in Markdown.
<p>
This is an HTML paragraph with proper indentation!
</p>
This is a regular paragraph in Markdown.
Не забувайте, що код без відступів є відносним
Наприклад, вам не потрібно відступати початкові та кінцеві теги на рівні блоку під час створення списків у Markdown.
* This is a list item in Markdown
<p>This is an HTML paragraph with proper indentation!</p>
* This is a list item in Markdown
Не додавайте порожній рядок між початковим і кінцевим тегами
Це легко зробити, коли ви перемикаєтеся між Markdown і HTML, але простий порожній рядок може легко відобразити сторінку неправильно.
This is a regular paragraph in Markdown.
<section>
<p>
hello
</p>
<p>
hello
</p>
</section>
This is a regular paragraph in Markdown.