מהו Markdown בטעם GitHub?

GitHub בטעם Markdown (GFM) הוא ערכת-על של סימנים נפוצים שמוסיפים טבלאות, תיבות סימון של רשימת משימות, סטרימינג עם טילים כפולים וקישור אוטומטי של כתובות אתרים חשופות. זהו הניב ש-GitHub משתמש בעיבוד קבצי README, והוא מופעל כברירת מחדל בממיר זה.

האם הממיר שומר על בלוקי הקוד שלי מודגשים?

הוא פולט את הצורך בהדגשות הסימון: בלוק מגודר כגון ``s becomes . הממיר עצמו אינו צובע את הקוד - אתה מוסיף הדגשה כמו Prism, highlight.js או Shiki בדף שלך, והוא קולט את מחלקת השפה באופן אוטומטי.

האם HTML גולמי בתוך ה-Markdown שלי נשמר?

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

למה הפסקת השורה הבודדת שלי נעלמה?

Markdown סטנדרטי מצטרף שורות עוקבות לפסקה אחת; הפסקת שורה שורדת רק אם אתה מסיים את השורה עם שני רווחים או משאיר שורה ריקה. אם אתה רוצה שכל שורה חדשה תהפוך ל- , אפשר את האפשרות "הפסקות שורה" - כלומר ההתנהגות שבה משתמשים הערות GitHub ואפליקציות צ'אט רבות.

האם אוכל ליצור תוכן עניינים מהכותרות שלי?

כן, עבור כותרות H2 ו-H3. עם מזהי כותרת מופעלים, כל כותרת מקבלת עוגן מוחלף וחלונית תוכן העניינים מפרטת כל H2 ו-H3 כקישור Markdown, ומכניסה H3s מתחת ל-H2 שלהם. ה-H1 וה-H4 עד H6 נותרו בחוץ. העתק אותו בחזרה לחלק העליון של המסמך שלך והקישורים ייפתרו מול המזהים שנוצרו.

האם זה בטוח להדביק סימון שלא כתבתי?

לרוב, אבל בדוק קישורים לפני פרסום. HTML גולמי נמלט כברירת מחדל, וחלונית התצוגה המקדימה גם מפשיטה סקריפט, סגנון ותגי iframe, מטפלי אירועים מוטבעים ו-javascript: כתובות URL. ה-HTML שהועתק או הורד אינו מופעל דרך המסנן הזה, ולכן `[לחץ] (javascript: alert (1))` עדיין מייצר קישור ` ` בפלט. שום דבר שאתה מדביק לא מועבר: המנתח מריץ את צד הלקוח.

האם הכלי תומך בדיוק ב-CommonMark?

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

כיצד אוכל להמיר קובץ readme.md ל-HTML?

פתח את README בכל עורך טקסט, העתק את הקובץ כולו והדבק אותו בעורך כאן עם GitHub Flavored מופעל, הניב GitHub מציג READMEs עם, כך שטבלאות, רשימות משימות ותגי תמונה יוצאים כ-HTML. לאחר מכן סמן את המסמך המלא ולחץ על .html, העוטף את הפלט בדוקטיפ ולוקח את כותרת העמוד מהכותרת הראשונה שלך ב-H1. קישורים בסגנון הפניה כגון `[docs][1]` נשארים כטקסט מילולי, אז כתוב אותם מחדש כקישורים מוטבעים תחילה.

האם דפדפנים יכולים להציג את Markdown מבלי להמיר אותו?

מס 'דפדפנים רק render HTML, כך קובץ.md מוגש על HTTP מציג כטקסט רגיל משהו צריך להרכיב אותו ראשון - בזמן בנייה עם מחולל אתר סטטי, בזמן בקשה בשרת, בדפדפן עם מנתח JavaScript, או פעם ביד עם ממיר כמו זה.

כיצד אוכל להמיר את Markdown ל-HTML ב-Node או Python?

ב-Node הספריות הנפוצות מסומנות ומסמנות-זה; ב-Python, markdown או markdown-it-py. חבר כל אחד מהם עם חומר חיטוי - DOMPurify או sanitize-html ב-JS, אקונומיקה ב-Python - אם ה-Markdown מגיע ממשתמשים, כי אף אחד מהנתחים האלה לא מפשיט HTML מסוכן בעצמו.

האם זה ממיר Markdown ל-HTML בחינם ללא הרשמה?

כן, זה בחינם, אין הרשמה, וההמרה פועלת בצד הלקוח תוך כדי הקלדה. הקלדה והתצוגה המקדימה לעולם לא נספרות. העתק ו-.html בצע בדיקת שימוש ורשום רשומה שמחזיקה רק את גודל ה-HTML, ופעולות אלו נחשבות למגבלה היומית של הכלי: 10 ביום כאורח ו-50 עם חשבון בחינם.

מדוע נשבר קישור עם סוגריים בכתובת האתר?

מנתח הקישורים מסיים את כתובת האתר בסוגריים הסגירה הראשונה, כך שכתובת URL המכילה סוגריים מתקצרת. `[Page] (https://example.com/a_(b))` הופך לקישור ל-https://example.com/a_(b עם תועה ) אחריו. לעטוף את כתובת האתר בסוגריים זווית לא עוזר כאן. אחוז-מקודד את הסוגריים כ-% 28 ו-% 29 לפני ההמרה: `https://example.com/a_% 28b% 29` קישורים כהלכה.

סי

סימון ל-HTML

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

Markdown

<h1 id="release-notes-v24">Release Notes - v2.4</h1>
<p>Ship notes for the <strong>June</strong> release. See the <a href="https://example.com/changelog">changelog</a> for the full diff.</p>
<blockquote>
<p>Heads up: the <code>/v1/export</code> endpoint is deprecated and will be removed in v3.</p>
</blockquote>
<h2 id="whats-new">What's new</h2>
<ul>
<li>Faster CSV export (~4x on 100k rows)</li>
<li>New <code>--dry-run</code> flag</li>
<li>Fixed a <em>nasty</em> race in the queue worker</li>
</ul>
<h3 id="upgrade-steps">Upgrade steps</h3>
<ol>
<li>Bump the package</li>
<li>Run the migration</li>
<li>Restart the workers</li>
</ol>
<pre><code class="language-bash">npm install toolz@2.4.0
npx toolz migrate --dry-run
</code></pre>
<table>
<thead>
<tr><th>Endpoint</th><th style="text-align:center">Status</th><th>Notes</th></tr>
</thead>
<tbody>
<tr><td>/v2/export</td><td style="text-align:center">stable</td><td>Use this</td></tr>
<tr><td>/v1/export</td><td style="text-align:center"><del>deprecated</del></td><td>Removed in v3</td></tr>
</tbody>
</table>
<ul class="task-list">
<li><input type="checkbox" disabled checked /> Docs updated</li>
<li><input type="checkbox" disabled /> Blog post scheduled</li>
</ul>
<hr />
<p>Questions? Reach us at <a href="mailto:support@example.com">support@example.com</a>.</p>

127

Words

Headings

Links

Images

Code blocks

1320

HTML bytes

1 min

Read time

Table of Contents

- [What's new](#whats-new)
  - [Upgrade steps](#upgrade-steps)

מהו ממיר הסימון ל-HTML?

ה-Markdown to HTML Converter הופך מקור Markdown - README, יומן שינויים, טיוטת בלוג, קבוצה של הערות שחרור - ל-HTML שדפדפן או CMS מעבד. הדבק או הקלד Markdown משמאל, ותקבל HTML סמנטי מימין: כותרות הופכות ל-h1–h6, קוד מגודר הופך ל-pre וקוד עם מחלקת שפה, רשימות הופכות ל-ul ו-ol, והרחבות GitHub כגון טבלאות, רשימות משימות ו-strikethrough מטופלות באופן שבו GitHub מעבד אותן.

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

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

דוגמה קצרה שעובדת מראה מה אתה מקבל כשאתה ממיר כאן Markdown ל-HTML. הדבק כאן `# My Project`, then `## Install`, then a two-row task list `- [x] Done` and `- [ ] Todo`. הפלט הוא `<h1 id="my-project">My Project</h1>`, `<h2 id="install">Install</h2>` and a`<ul class="task-list">` שהפריטים שלו מתחילים עם כניסות תיבת סימון מושבתות. סמן מסמך מלא ואותו גוף עטוף בדוקטיפ עם `<title>My Project</title>`. זהו ממיר Markdown ל-HTML בחינם, ללא הרשמה, והוא ממיר תוך כדי הקלדה.

Markdown מאפשר HTML מוטבע גולמי, מה שהופך את שאלת הבטיחות לאמיתית ולא תיאורטית: מסמך המכיל תג סקריפט תקף Markdown, וממיר שמעביר אותו מייצר HTML שיפעל בעת עיבוד. הפלט כאן נמלט כברירת מחדל מסיבה זו, כך שקובץ Markdown ממקור לא מהימן לא יכול להבריח תגיות לדף שלך. קישורים הם מקרה נפרד: קישור `javascript:` ב-Markdown שומר את ה-href הזה ב-HTML המועתק, ורק חלונית התצוגה המקדימה משכתבת אותו, אז חיטא את הפלט לפני פרסום Markdown לא כתבת. אם אתה ממיר תוכן משלך ורוצה לשמור HTML גולמי, זו בחירה מכוונת ולא ברירת המחדל. הדבר השני שצריך לדעת הוא של-Markdown אין מפרט אחד. GitHub Flavored Markdown מיושם כאן, המכסה טבלאות, רשימות משימות, קוד מחשוף ומגודר, ואלה הרחבות ולא חלק מהתחביר המקורי, כך שמעבד CommonMark קפדני לא יראה אותם.

כיצד להשתמש בממיר Markdown ל-HTML?

הדבק את הסימון שלך
הקלד או הדבק Markdown לתוך העורך - README, יומן שינויים, הערות מהעורך שלך, כל דבר. הפלט מתעדכן תוך כדי הקלדה; טען את המדגם אם אתה רוצה לראות מה נתמך.
בחר את האפשרויות שלך
הפעל את Markdown בטעם GitHub עבור טבלאות, רשימות משימות, קישורים סטרייק דרך ו-bare-url. הוסף מזהי כותרת עבור קישורים עמוקים, הפעל מעברי שורות אם שורה חדשה בודדת אמורה להפוך ל-<br />, ואפשר HTML גולמי אם ה-Markdown שלך כבר מכיל תגים.
בדוק את התצוגה המקדימה
עבור בין מקור ה-HTML לתצוגה מקדימה מעובדת כדי לאשר שהמבנה הוא מה שציפית, וקרא את הנתונים הסטטיסטיים של המסמך - מילים, כותרות, קישורים, בלוקי קוד וזמן קריאה.
העתק, הורד או קח את ה-TOC
העתק את ה-HTML ללוח, או הקש .html כדי להוריד אותו כ-document.html (סמן תחילה את המסמך המלא אם אתה רוצה דף עצמאי). אתה יכול גם להעתיק את תוכן העניינים Markdown שנוצר אוטומטית שנבנה מעוגני הכותרות H2 ו-H3.

תכונות מפתח

GitHub בטעם Markdown
טבלאות עם יישור עמודות, תיבות סימון של רשימת משימות, ~~strikethrough~~ וקישור אוטומטי של כתובות URL חשופות - ההרחבות שה-README שלך כבר מסתמך עליהן
קוד מגודר עם שיעורי שפה
בלוקים מגודרים הופכים ל-<pre><code class="language-js">, שם המחלקה prism, highlight.js ו-shiki מצפים, כך שהדגשת תחביר פועלת ברגע שאתה מדביק את הפלט באתר שלך
כותרת עוגנים ו-TOC
כל כותרת מקבלת מזהה מוצנח, לא משוכפל, והכלי יוצר תוכן עניינים Markdown עבור כותרות H2 ו-H3 שלך שתוכל להדביק בחזרה בראש המסמך שלך
בטוח כברירת מחדל
HTML גולמי במקור נמלט אלא אם כן אתה מצטרף, והתצוגה המקדימה החיה מפשיטה סקריפט, סגנון ומטפלי אירועים מוטבעים - כך שהדבקת Markdown של מישהו אחר לא יכולה להריץ את הקוד שלו

Frequently Asked Questions

הדבק את ה - Markdown שלך בעורך וה - HTML מופיע מיד - אין כפתור המרה ללחיצה ואין קובץ להעלאה החלף את GitHub Flavored Markdown אם המקור שלך משתמש בטבלאות או ברשימות משימות, ולאחר מכן העתק את ה - HTML או הורד אותו כקובץ.html.

Related Tools

docs

HTML Formatter

Format, beautify, and minify HTML online. Re-indents messy or minified markup, keeps script, style, and pre content verbatim, and runs entirely in your browser.

HTM

docs

HTML to Markdown

Convert HTML to clean Markdown instantly. Turns headings, lists, links, images, blockquotes, code blocks and tables into portable GitHub Flavored Markdown. Tolerant of messy CMS markup. Runs client-side.

MTG

docs

Markdown Table Generator

Build Markdown tables in a spreadsheet-style editor - import CSV, Excel, or an existing table, set alignment, copy clean GFM

MTG

docs

Markdown TOC Generator

Generate a linked table of contents from Markdown headings

Comments

0 comments

No comments yet. Be the first to share your thoughts!

markdown to htmlconvert markdown to htmlmarkdown to html converteronline markdown to html converterfree markdown to html convertermarkdown convertermd to htmlmarkdown compilermarkdown previewgithub flavored markdownmarkdown rendererconvert readme to htmlmarkdown parser

למידע נוסף

קרא את המדריך המלא סימון ל-HTML

Command Palette

סימון ל-HTML

מהו ממיר הסימון ל-HTML?

כיצד להשתמש בממיר Markdown ל-HTML?

הדבק את הסימון שלך

בחר את האפשרויות שלך

בדוק את התצוגה המקדימה

העתק, הורד או קח את ה-TOC

תכונות מפתח

GitHub בטעם Markdown

קוד מגודר עם שיעורי שפה

כותרת עוגנים ו-TOC

בטוח כברירת מחדל

Frequently Asked Questions

Related Tools

HTML Formatter

HTML to Markdown

Markdown Table Generator

Markdown TOC Generator

Comments

למידע נוסף