Markdown este un format de scriere; HTML este un format de publicare. Astfel, sintaxa Markdown nu este menită să ofere toată versatilitatea HTML, ci doar cele mai comune elemente pentru textul scris. Când trebuie să faceți ceva mai complicat, puteți utiliza orice etichetă HTML inline și etichete la nivel de bloc care sunt acceptate de DevSite într-un fișier Markdown. Nu este nevoie să indicați că treceți de la Markdown la HTML, trebuie doar să utilizați eticheta HTML ca în exemplul de mai jos.
This sentence is in Markdown with a <b>bold inline HTML tag</b>.
HTML inline
Etichetele HTML inline pot fi folosite într-un paragraf Markdown, un articol de listă sau un antet și pot conține, de asemenea, sintaxă Markdown (de exemplu, **strong** , *emphasis* etc.) Acest lucru este util atunci când doriți să atrageți atenția asupra un pic de cod, ca în exemplul de mai jos.
This is a Markdown paragraph about Java:
<code>System.out.format("The square of *%d* is *%f*.*%n*", i, r);</code>
HTML la nivel de bloc
Etichetele HTML la nivel de bloc care sunt acceptate de DevSite trebuie separate de conținutul din jur printr-o linie goală. Și, spre deosebire de etichetele HTML inline, sintaxa Markdown (de exemplu, **strong** , *emphasis* etc.) în etichetele HTML la nivel de bloc nu sunt redate ca în exemplul de mai jos.
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.
Cele mai bune practici
Vă recomandăm să formatați HTML în fișierele Markdown în următoarele moduri pentru a preveni erorile de redare pe DevSite.
Nu utilizați etichete HTML la nivel de bloc neacceptate DevSite acceptă multe etichete HTML la nivel de bloc; dar includerea unuia neacceptat fie va reda HTML-ul ca text, fie va rupe codul.
Nu adăugați file sau spații suplimentare atunci când indentați Etichetele de început și de sfârșit la nivel de bloc nu ar trebui să fie indentate cu file sau spații. Unii editori adaugă automat file sau spații suplimentare – ai grijă!
This is a regular paragraph in Markdown.
<p>
This is an HTML paragraph with proper indentation!
</p>
This is a regular paragraph in Markdown.
Nu uitați că codul neindentat este relativ
De exemplu, nu trebuie să indentați etichetele de început și de sfârșit la nivel de bloc atunci când creați liste în 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
Nu adăugați o linie goală între o etichetă de început și de sfârșit
Acest lucru este ușor de făcut atunci când comutați între Markdown și HTML, dar o simplă linie goală poate reda cu ușurință o pagină incorect.
This is a regular paragraph in Markdown.
<section>
<p>
hello
</p>
<p>
hello
</p>
</section>
This is a regular paragraph in Markdown.