מהו Markdown בטעם GitHub?

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

סי

סימון ל-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)

Category:docs

Mode:Offline

Version:1.0.0

Access:Free

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

Markdown to HTML interface on Toolz.dev - Convert Markdown to clean, semantic HTML with GitHub Flavored Markdown support - tables, task lists, fenced code, heading anchors, live preview and a full HTML document export.

ה-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 מוטבע גולמי, מה שהופך את שאלת הבטיחות לאמיתית ולא תיאורטית: מסמך המכיל תג סקריפט תקף Markdown, וממיר שמעביר אותו מייצר HTML שיפעל בעת עיבוד. הפלט כאן נמלט כברירת מחדל מסיבה זו, כך שקובץ Markdown ממקור לא מהימן אינו יכול להבריח סימון לדף שלך. אם אתה ממיר תוכן משלך ורוצה לשמור HTML גולמי, זו בחירה מכוונת ולא ברירת המחדל. הדבר השני שצריך לדעת הוא של-Markdown אין מפרט אחד. GitHub Flavored Markdown מיושם כאן, המכסה טבלאות, רשימות משימות, קוד מחשוף ומגודר, ואלה הרחבות ולא חלק מהתחביר המקורי, כך שמעבד CommonMark קפדני לא יראה אותם.

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

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

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

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

הפעל את Markdown בטעם GitHub עבור טבלאות, רשימות משימות, קישורים סטרייק דרך ו-bare-url. הוסף מזהי כותרת עבור קישורים עמוקים, הפעל מעברי שורות אם שורה חדשה בודדת אמורה להפוך ל-<br />, ואפשר HTML גולמי אם ה-Markdown שלך כבר מכיל תגים.

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

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

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

העתק את ה-HTML ללוח, הורד אותו כקובץ .html עצמאי, או העתק את תוכן העניינים של Markdown שנוצר אוטומטית שנבנה מ-Heading Anchors.

תכונות מפתח

GitHub בטעם Markdown

טבלאות עם יישור עמודות, תיבות סימון של רשימת משימות, ~~strikethrough~~ וקישור אוטומטי של כתובות URL חשופות - ההרחבות שה-README שלך כבר מסתמך עליהן

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

בלוקים מגודרים הופכים ל-<pre><code class="language-js">, שם המחלקה prism, highlight.js ו-shiki מצפים, כך שהדגשת תחביר פועלת ברגע שאתה מדביק את הפלט באתר שלך

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

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

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

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. 100% 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 htmlmarkdown 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

למידע נוסף