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.