ממיר חינם
סימון ל ממיר HTML
הפוך טקסט Markdown לקוד HTML מוכן לייצור עם תמיכה בתצוגה מקדימה חיה.
הפוך טקסט Markdown לקוד HTML מוכן לייצור עם תמיכה בתצוגה מקדימה חיה.
Markdown היא שפת סימון קלת משקל שנוצרה על ידי ג'ון גרובר ב-2004 כדי לאפשר לכותבים לייצר HTML מובנה תוך שימוש במוסכמות של טקסט רגיל: תווי גיבוב לכותרות, כוכביות להדגשה, מקפים לרשימות, בלוקים מוזחים לקוד. הפורמט הפך לברירת המחדל עבור קובצי README, תיעוד טכני, טיוטות בלוגים, מחוללי אתרים סטטיים, וכל הקשר שבו הכתיבה צריכה להיות ניתנת לקריאה כטקסט רגיל וכפלט מעובד. המרת Markdown ל-HTML היא שלב העיבוד שהופך את המקור לדף אינטרנט.
ממיר זה משתמש בספרייה המסומנת, המעבד Markdown הנפוץ ביותר ב-JavaScript. Marked תומך ב-CommonMark ו-GitHub Flavored Markdown (GFM), כלומר טבלאות, בלוקי קוד מגודרים, רשימות משימות, קו חוצה וקישור אוטומטי, כולם פועלים כהלכה בנוסף לתכונות Markdown הסטנדרטיות.
הפלט הוא HTML רגיל - תגיות סמנטיות לכותרות, פסקאות, רשימות, קישורים ותמונות, בנוסף ל-class hooks עבור בלוקי קוד שבהם מצפים להם כלי הדגשת תחביר. הפלט מדביק בצורה נקייה בכל CMS, מוטמע במחוללי אתרים סטטיים, או משמש כ-.html עצמאי. לא נוספו CSS או JavaScript; עיצוב התוצאה נשאר להקשר שלך במורד הזרם.
Markdown הוא הפורמט שכותבים ומפתחים מעדיפים; HTML הוא הפורמט שדפדפנים מעבדים. רוב מחוללי האתרים הסטטיים ופלטפורמות ה-CMS ממירים את Markdown ל-HTML מאחורי הקלעים, אבל לפעמים אתה צריך את ההמרה כשלב עצמאי - הדבקה ב-CMS שאין לו תמיכה ב-Markdown, יצירת HTML עבור מיילים, הפקת תצוגה מקדימה מהירה או חילוץ הפלט המעובד להמשך עיבוד.
HTML הוא גם הפורמט הקנוני לכל תוכן שיוצג בסופו של דבר בדפדפן. עלוני דוא"ל שנבנו מטיוטות Markdown, דפי תיעוד המוטמעים ביישומי HTML גדולים יותר ופוסטים בבלוג שהודבקו בעורכים שמצפים ל-HTML, כולם נהנים מהמרה נקייה.
הדבק Markdown, קבל HTML.
Marked משתמש בארכיטקטורה של שני מעברים. ה-lexer מסמל את הקלט לאסימונים ברמת הבלוק (כותרות, פסקאות, רשימות, בלוקי קוד) ואסימונים מוטבעים (הדגשות, קישורים, תמונות). המנתח מעביר את זרם האסימון ופולט HTML, ומחיל ווים של renderer עבור כל סוג אסימון.
הרחבות GitHub Flavored Markdown מופעלות כברירת מחדל: טבלאות (באמצעות תחביר צינורות), בלוקי קוד מגודרים (התאמות משולשות עם רמזי שפה), רשימות משימות (- [ ] ו- [x]), קו חוצה (באמצעות טילדות כפולות), וקישור אוטומטי של כתובת URL. בלוקי קוד פולטים קוד עטוף מראש עם מחלקת שפה אופציונלית להדגשת תחביר במורד הזרם.
חיטוי הפלט נותר לצרכנים במורד הזרם. Marked פולט כל מה שהקלט מייצר, כולל HTML גולמי שמוטמע ב-Markdown. אם אתה מקבל קלט לא מהימן, הפעל את הפלט דרך DOMPurify או חומר ניקוי HTML דומה לפני רינדור בדפדפן.