HTML ל-Markdown

איך זה עובד

Markdown הוא מה שקובצי README, מערכות מעקב אחר תקלות, ויקי ואתרים סטטיים רוצים. HTML הוא מה שמתקבל בהעתקה מדף אינטרנט או בייצוא ממערכת ניהול תוכן. המרה ביניהם ידנית היא מייגעת, והתוצאה בדרך כלל מלאה בשאריות של קוד סימון.

מה מומר בצורה נקייה

כותרות, פסקאות, הדגשה ונטייה, קישורים, תמונות, קוד בתוך שורה, בלוקי קוד, ציטוטים, קווים אופקיים ושני סוגי הרשימות, כולל רשימות מקוננות. לאלה יש מקבילות מדויקות ב-Markdown והן יוצאות כפי שהייתם כותבים אותן ביד.

מה לא שורד

ב-Markdown אין דרך לבטא עיצוב, מחלקות, תגי div של פריסה, span, או כל דבר חזותי. התגים האלה נפרשים — הטקסט שלהם נשמר והתג עצמו נזרק — והמספר מדווח כדי שתדעו שמשהו פושט. סקריפטים ובלוקי סגנון מוסרים לגמרי.

טבלאות

טקסט הטבלה נשמר אך אינו מוצג כטבלת Markdown, משום שטבלאות HTML משתמשות לעיתים קרובות בתאים ממוזגים ובקינון שתחביר הטבלאות של Markdown באמת אינו יכול לייצג. קל יותר לסמן מחדש ביד טבלאות פשוטות מאשר לקבל אותן משובשות.

מנותח, לא מותאם בתבנית

ה-HTML מנותח על ידי המנתח של הדפדפן עצמו ולא מעובד בביטויים רגולריים, ולכן קוד סימון פגום או מקונן עמוק מטופל כפי שדפדפן היה מטפל בו.