HTML Markdown failos

Markdown ir rakstīšanas formāts; HTML ir publicēšanas formāts. Tādējādi Markdown sintakse nav paredzēta, lai piedāvātu pilnu HTML daudzpusību, tikai visbiežāk sastopamos rakstītā teksta elementus. Ja jums ir jādara kaut kas sarežģītāks, Markdown failā varat izmantot jebkuru iekļauto HTML tagu un bloka līmeņa tagus, ko atbalsta DevSite. Nav nepieciešams norādīt, ka pārejat no Markdown uz HTML, vienkārši izmantojiet HTML tagu, kā parādīts tālāk esošajā piemērā.

This sentence is in Markdown with a <b>bold inline HTML tag</b>.

Iekļauts HTML

Iekļautos HTML tagus var izmantot Markdown rindkopā, saraksta vienumā vai galvenē, un tajos var būt arī Markdown sintaksi (piemēram, **strong** , *emphasis* u.c.). Tas ir noderīgi, ja vēlaties pievērst uzmanību mazliet koda, kā parādīts zemāk esošajā piemērā.

This is a Markdown paragraph about Java:
<code>System.out.format("The square of *%d* is *%f*.*%n*", i, r);</code>

Bloka līmeņa HTML

Bloka līmeņa HTML tagi, kurus atbalsta DevSite, ir jāatdala no apkārtējā satura ar tukšu rindiņu. Un atšķirībā no iekļautajiem HTML tagiem Markdown sintakse (piem., **strong** , *emphasis* utt.) bloka līmeņa HTML tagos netiek renderēta, kā parādīts tālāk esošajā piemērā.

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.

Labākā prakse

Mēs iesakām formatēt HTML Markdown failos tālāk norādītajos veidos, lai novērstu renderēšanas kļūdas vietnē DevSite.

Neizmantojiet neatbalstītus bloka līmeņa HTML tagus. DevSite atbalsta daudzus bloka līmeņa HTML tagus; bet, iekļaujot neatbalstītu, jūsu HTML tiks atveidots kā teksts vai arī tiks bojāts kods.

Atkāpjoties, nepievienojiet papildu tabulēšanas zīmes vai atstarpes. Bloka līmeņa sākuma un beigu tagus nedrīkst ievilkt ar tabulēšanas zīmēm vai atstarpēm. Daži redaktori automātiski pievieno papildu cilnes vai atstarpes — uzmanieties!

This is a regular paragraph in Markdown.

<p>
    This is an HTML paragraph with proper indentation!
</p>

This is a regular paragraph in Markdown.

Neaizmirstiet, ka kods bez atkāpes ir relatīvs

Piemēram, jums nav jāievieto bloka līmeņa sākuma un beigu atzīmes, veidojot sarakstus pakalpojumā 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

Nepievienojiet tukšu rindiņu starp sākuma un beigu tagu

To ir viegli izdarīt, pārslēdzoties starp Markdown un HTML, taču vienkārša tukša rindiņa var viegli atveidot lapu nepareizi.

This is a regular paragraph in Markdown.

<section>
  <p>
    hello
   </p>
  <p>
    hello
  </p>
</section>

This is a regular paragraph in Markdown.