Маркдовн је формат писања; ХТМЛ је формат за објављивање. Дакле, Маркдовн синтакса није замишљена да понуди пуну свестраност ХТМЛ-а, већ само најчешће елементе за писани текст. Када треба да урадите нешто компликованије, можете да користите било коју уметнуту ХТМЛ ознаку и ознаке на нивоу блока које подржава ДевСите у Маркдовн датотеци. Нема потребе да означавате да прелазите са Маркдовн на ХТМЛ, само користите ХТМЛ ознаку као у примеру испод.
This sentence is in Markdown with a <b>bold inline HTML tag</b>.
Инлине ХТМЛ
Уграђене ХТМЛ ознаке се могу користити у оквиру Маркдовн пасуса, ставке листе или заглавља, а такође могу да садрже Маркдовн синтаксу (нпр. **strong**
, *emphasis*
, итд.) Ово је корисно када желите да скренете пажњу на мало кода, као у примеру испод.
This is a Markdown paragraph about Java:
<code>System.out.format("The square of *%d* is *%f*.*%n*", i, r);</code>
ХТМЛ на нивоу блока
ХТМЛ ознаке на нивоу блока које подржава ДевСите морају бити одвојене од околног садржаја празним редом. И за разлику од уграђених ХТМЛ ознака, Маркдовн синтакса (нпр. **strong**
, *emphasis*
, итд.) у ХТМЛ ознакама на нивоу блока се не приказују као у примеру испод.
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.
Најбоље праксе
Препоручујемо да форматирате ХТМЛ у Маркдовн датотекама на следеће начине да бисте спречили грешке при приказивању на ДевСите-у.
Немојте користити неподржане ХТМЛ ознаке на нивоу блока ДевСите подржава многе ХТМЛ ознаке на нивоу блока; али укључивање неподржаног ће или приказати ваш ХТМЛ као текст или ће разбити код.
Немојте додавати додатне табове или размаке када увлачите почетне и завршне ознаке на нивоу блока не би требало да буду увучене табулаторима или размацима. Неки уредници аутоматски додају додатне табове или размаке — пазите!
This is a regular paragraph in Markdown.
<p>
This is an HTML paragraph with proper indentation!
</p>
This is a regular paragraph in 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
Немојте додавати празан ред између почетне и завршне ознаке
Ово је лако урадити када прелазите између Маркдовн-а и ХТМЛ-а, али једноставан празан ред може лако да прикаже страницу погрешно.
This is a regular paragraph in Markdown.
<section>
<p>
hello
</p>
<p>
hello
</p>
</section>
This is a regular paragraph in Markdown.