HTML בקובצי Markdown

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.

שיטות מומלצות

כדי למנוע שגיאות רינדור ב-DevSite, מומלץ לעצב את ה-HTML בקובצי Markdown בדרכים הבאות.

אסור להשתמש בתגי 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.