Markdownแปลว่าอะไร?
วิธีใช้มาร์กอัปไวยากรณ์ / การจัดรูปแบบ Markdown
ภาพรวม
Markdown เป็นภาษามาร์กอัปน้ำหนักเบาที่สร้างโดย John Gruber
ช่วยให้ผู้คนสามารถ "เขียนเอกสารในรูปแบบข้อความธรรมดาที่อ่านและเขียนได้ง่าย จากนั้นแปลงเป็นเอกสาร XHTML (หรือ HTML) ที่ถูกต้อง"
ภาษานี้รวมเอาคุณลักษณะหลายอย่างของมาร์กอัปข้อความธรรมดาที่มีอยู่แล้วในอีเมล
John Gruber ได้สร้างภาษา Markdown ขึ้นในปี 2004 โดยร่วมมือกับ Aaron Swartz โดยส่วนใหญ่แล้วในด้านไวยากรณ์จุดประสงค์ของภาษาคือการใช้ "รูปแบบข้อความธรรมดาที่อ่านง่าย เขียนง่าย และเลือกที่จะแปลงเป็น XHTML (หรือ HTML) ที่ถูกต้อง"
วัตถุประสงค์
เป้าหมายของ Markdown คือ "ง่ายต่อการอ่านและเขียนง่าย"
อ่านง่าย ทำต่อไป网络营销ประสบการณ์ผู้ใช้เป็นสิ่งสำคัญมาก
เอกสารที่เขียนด้วย Markdown ควรจะสามารถเผยแพร่ได้โดยตรงในรูปแบบข้อความธรรมดา และไม่ควรดูเหมือนประกอบด้วยแท็กหรือคำสั่งการจัดรูปแบบจำนวนมาก
ไวยากรณ์ Markdown ได้รับอิทธิพลจากรูปแบบข้อความเป็น HTML ที่มีอยู่ รวมถึง Setext, atx, Textile, reStructuredText, Grutatext และ EtText แต่แหล่งที่มาที่ใหญ่ที่สุดของแรงบันดาลใจคือรูปแบบอีเมลข้อความธรรมดา
กล่าวโดยสรุป วากยสัมพันธ์ของ Markdown นั้นประกอบด้วยสัญลักษณ์ทั้งหมด ซึ่งได้รับการคัดเลือกมาอย่างดีและหน้าที่ของสัญลักษณ์นั้นชัดเจนในชั่วพริบตาตัวอย่างเช่น ใส่เครื่องหมายดอกจันรอบข้อความเพื่อให้ดูเหมือน *เน้น*
รายการใน Markdown ดูเหมือนรายการ Blockquotes ใน Markdown ดูเหมือนการอ้างอิงข้อความอย่างที่คุณเคยเห็นในอีเมล
เข้ากันได้กับ HTML
เป้าหมายของไวยากรณ์ Markdown คือการเป็นภาษาเขียนสำหรับเว็บ
Markdown ไม่ได้มีไว้เพื่อแทนที่ HTML หรือแม้แต่เข้าใกล้มัน แต่มีรูปแบบไวยากรณ์น้อยมากและสอดคล้องกับส่วนย่อยของมาร์กอัป HTML เพียงเล็กน้อย Markdown ไม่ได้ตั้งใจทำให้เอกสาร HTML เขียนง่ายขึ้น
ในความคิดของฉัน HTML เขียนง่ายอยู่แล้ว แนวคิดของ Markdown คือการทำให้เอกสารอ่าน เขียน และเปลี่ยนแปลงได้ง่ายขึ้น HTML เป็นรูปแบบการเผยแพร่ Markdown คือ aการเขียนคำโฆษณารูปแบบการเขียนด้วยเหตุนี้ ไวยากรณ์การจัดรูปแบบของ Markdown จึงครอบคลุมเฉพาะข้อความธรรมดาที่สามารถทำได้
แท็กที่ไม่ครอบคลุมโดย Markdown สามารถเขียนเป็น HTML ได้โดยตรงในเอกสารโปรโมชั่นเว็บสำเนา.ไม่จำเป็นต้องทำเครื่องหมายว่าเป็น HTML หรือ Markdown เพียงเพิ่มมาร์กอัปโดยตรง
องค์ประกอบบล็อก HTML บางส่วนเท่านั้นที่ต้องถูกจำกัด - เช่น <div>,<table>,<pre>,<p> และแท็กอื่นๆ ต้องแยกออกจากพื้นที่เนื้อหาอื่นที่มีบรรทัดว่างก่อนและหลัง และแท็กเปิดและปิดต้องไม่เยื้องด้วยแท็บหรือช่องว่าง ตัวสร้าง Markdown นั้นฉลาดพอที่จะไม่เพิ่มแท็กบล็อก HTML ที่ไม่จำเป็น <p> ฉลาก.
ตัวอย่างมีดังนี้ การเพิ่มตาราง HTML ลงในไฟล์ Markdown:
这是一个普通段落。
<table>
<tr>
<td>Foo</td>
</tr>
</table>
这是另一个普通段落。
โปรดทราบว่าไวยากรณ์การจัดรูปแบบ Markdown ระหว่างแท็กบล็อก HTML จะไม่ถูกประมวลผลตัวอย่างเช่น หากคุณใช้รูปแบบ Markdown ภายในบล็อค HTML*强调*จะไม่มีผล
ส่วน HTML (อินไลน์) แท็กเช่น <span>,<cite>,<del> สามารถใช้ได้อย่างอิสระในย่อหน้า รายการ หรือหัวเรื่อง Markdownตามนิสัยส่วนตัว คุณสามารถใช้แท็ก HTML เพื่อจัดรูปแบบได้โดยไม่ต้องใช้รูปแบบ Markdownตัวอย่าง: หากคุณต้องการ HTML <a> 或 <img> แท็ก ซึ่งสามารถใช้ได้โดยตรงโดยไม่ต้องมีลิงก์หรือรูปแบบแท็กรูปภาพที่ Markdown ให้มา
ไม่เหมือนกับแท็กบล็อก HTML ไวยากรณ์ Markdown ใช้ได้ระหว่างแท็กส่วน HTML
การแปลงอักขระพิเศษโดยอัตโนมัติ
ในไฟล์ HTML มีอักขระสองตัวที่ต้องการการจัดการพิเศษ: < และ & . < สัญลักษณ์ที่ใช้สำหรับแท็กเริ่มต้น& สัญลักษณ์ใช้เพื่อทำเครื่องหมายเอนทิตี HTML หากคุณต้องการแสดงต้นแบบของอักขระเหล่านี้ คุณต้องใช้แบบฟอร์มเอนทิตี เช่น < และ &.
& ตัวละครกำลังทรมานโดยเฉพาะสำหรับผู้เขียนเอกสารเว็บ หากคุณจะพิมพ์ "AT&T"คุณต้องเขียน"AT&T".ขณะอยู่ใน URL & ตัวละครจะถูกแปลงด้วยตัวอย่างเช่นคุณต้องการเชื่อมโยงไปยัง:
http://images.google.com/images?num=30&q=larry+bird
คุณต้องเขียนการแปลง URL เป็น:
http://images.google.com/images?num=30&q=larry+bird
ให้อยู่ในแท็กลิงค์ href ในคุณสมบัติไม่จำเป็นต้องพูด วิธีนี้มองข้ามได้ง่าย และอาจเป็นข้อผิดพลาดจำนวนมากที่สุดที่การตรวจสอบความถูกต้องของมาตรฐาน HTML ตรวจพบ
Markdown ช่วยให้คุณเขียนอักขระได้อย่างเป็นธรรมชาติ และดูแลสิ่งที่จำเป็นต้องแปลงถ้าคุณใช้ & อักขระเป็นส่วนหนึ่งของเอนทิตีอักขระ HTML ทิ้งไว้ตามที่เป็นอยู่ มิฉะนั้น จะถูกแปลงเป็น &;.
ดังนั้นหากต้องการแทรกสัญลักษณ์ลิขสิทธิ์ในเอกสาร ©, คุณสามารถเขียน:
©
Markdown จะปล่อยให้มันไม่มีใครแตะต้องและถ้าคุณเขียน:
AT&T
Markdown จะแปลงเป็น:
AT&T
สถานการณ์ที่คล้ายคลึงกันก็เกิดขึ้นใน < สัญกรณ์ เนื่องจาก Markdown อนุญาตความเข้ากันได้ของ HTML หากคุณใส่ < สัญลักษณ์ถูกใช้เป็นตัวคั่นสำหรับแท็ก HTML และ Markdown จะไม่ทำการแปลงใดๆ กับแท็กเหล่านี้ แต่ถ้าคุณเขียนว่า:
4 < 5
Markdown จะแปลงเป็น:
4 < 5
อย่างไรก็ตาม ควรสังเกตว่าภายในขอบเขตของโค้ด ไม่ว่าจะเป็นแบบอินไลน์หรือบล็อค < และ & ทั้งสองสัญลักษณ์บางถูกแปลงเป็นเอนทิตี HTML ซึ่งเป็นคุณลักษณะที่ช่วยให้คุณเขียนโค้ด HTML ใน Markdown ได้อย่างง่ายดาย (ซึ่งต่างจาก HTML ที่คุณใส่ทั้งหมด < และ & ทั้งหมดจะถูกแปลงเป็นเอนทิตี HTML เพื่อเขียนโค้ด HTML ในไฟล์ HTML )
องค์ประกอบบล็อก
ย่อหน้าและตัวแบ่งบรรทัด
ย่อหน้า Markdown ประกอบด้วยข้อความอย่างน้อยหนึ่งบรรทัดต่อเนื่องกัน นำหน้าและตามด้วยบรรทัดว่างมากกว่าหนึ่งบรรทัด (คำจำกัดความของบรรทัดว่างคือปรากฏว่าว่างเปล่าบนจอแสดงผลและถือเป็นบรรทัดว่าง ตัวอย่างเช่น หากบรรทัดหนึ่งมีเฉพาะช่องว่างและแท็บ บรรทัดนั้นจะถือเป็นบรรทัดว่างด้วย)ย่อหน้าปกติไม่ควรเยื้องด้วยช่องว่างหรือแท็บ
วลี "ประกอบด้วยข้อความต่อเนื่องกันหนึ่งบรรทัดขึ้นไป" จริง ๆ แล้วหมายความว่า Markdown อนุญาตให้มีการขึ้นบรรทัดใหม่แบบบังคับ (แทรกบรรทัดใหม่) ภายในย่อหน้า ซึ่งเป็นคุณลักษณะที่แตกต่างจากรูปแบบข้อความเป็น HTML อื่นๆ ส่วนใหญ่ (รวมถึงประเภทที่เคลื่อนย้ายได้ "แปลงตัวแบ่งบรรทัด" " ตัวเลือก) รูปแบบอื่นจะแปลงตัวแบ่งบรรทัดแต่ละบรรทัดเป็น <br /> ฉลาก.
ถ้าคุณแน่นอนต้องการพึ่งพา Markdown เพื่อแทรก <br /> สำหรับป้ายกำกับ ให้กดช่องว่างอย่างน้อยสองช่องที่ตำแหน่งแทรก จากนั้นกด Enter
อันที่จริง มันต้องใช้เวลาเพิ่มขึ้นเล็กน้อย (ช่องว่างเพิ่มเติม) เพื่อสร้าง <br /> แต่เพียงแค่ "แต่ละบรรทัดใหม่จะถูกแปลงเป็น <br />"วิธีนี้ไม่เหมาะกับ Markdown แต่อย่างใดใน Markdownaiเครื่องหมายคำพูดแบบบล็อกตัว L และรายการหลายย่อหน้าไม่เพียงแต่มีประโยชน์มากกว่า แต่ยังอ่านง่ายกว่าเมื่อเรียงพิมพ์ด้วยการขึ้นบรรทัดใหม่
พาดหัว
Markdown รองรับไวยากรณ์สองรูปแบบสำหรับส่วนหัว ได้แก่ Setext-like และ atx-like
แบบฟอร์มที่เหมือน Settext คือแบบฟอร์มที่มีบรรทัดล่างสุด โดยใช้ = (ชื่อสูงสุด) และ - (ส่วนหัวของลำดับที่สอง) ตัวอย่างเช่น:
This is an H1
=============
This is an H2
-------------
จำนวนเท่าใดก็ได้ = และ - สามารถมีประสิทธิภาพ
แบบฟอร์มคล้าย Atx แทรก 1 ถึง 6 ที่จุดเริ่มต้นของบรรทัด # สอดคล้องกับประเภทที่ 1 ถึง 6 ตัวอย่างเช่น
# 这是 H1
## 这是 H2
###### 这是 H6
คุณสามารถเลือก "ปิด" ส่วนหัวที่เหมือน atx ซึ่งมีไว้สำหรับความสวยงามเท่านั้น หากคุณรู้สึกสบายใจด้วยวิธีนี้ คุณสามารถเพิ่มที่ท้ายบรรทัดได้ #, ในขณะที่เส้นสิ้นสุด # ตัวเลขไม่จำเป็นต้องเหมือนกับจุดเริ่มต้น (จำนวนอักขระปอนด์ที่ต้นบรรทัดกำหนดลำดับของชื่อ):
# 这是 H1 #
## 这是 H2 ##
### 这是 H3 ######
Blockquotes Blockquotes
Markdown markup blockquotes ใช้คล้ายกับที่ใช้ในอีเมล > ของการอ้างอิงหากคุณคุ้นเคยกับเครื่องหมายคำพูดในจดหมายอีเมล คุณรู้วิธีสร้างใบเสนอราคาแบบบล็อกในไฟล์ Markdown ซึ่งดูเหมือนว่าคุณจะแยกบรรทัดเอง จากนั้นเพิ่ม > :
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
> consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
> Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
>
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
> id sem consectetuer libero luctus adipiscing.
Markdown ยังช่วยให้คุณขี้เกียจและเพิ่มเฉพาะบรรทัดแรกของทั้งย่อหน้า > :
> This is a blockquote with two paragraphs. Lorem ipsum dolor sit amet,
consectetuer adipiscing elit. Aliquam hendrerit mi posuere lectus.
Vestibulum enim wisi, viverra nec, fringilla in, laoreet vitae, risus.
> Donec sit amet nisl. Aliquam semper ipsum sit amet velit. Suspendisse
id sem consectetuer libero luctus adipiscing.
การอ้างอิงบล็อกสามารถซ้อนกันได้ (เช่น: ข้อมูลอ้างอิงภายในข้อมูลอ้างอิง) โดยการเพิ่มจำนวน . ที่แตกต่างกัน > :
> This is the first level of quoting.
>
> > This is nested blockquote.
>
> Back to the first level.
ไวยากรณ์ Markdown อื่นๆ ยังสามารถใช้ภายในบล็อกที่เสนอราคา รวมถึงส่วนหัว รายการ บล็อกโค้ด ฯลฯ:
> ## 这是一个标题。
>
> 1. 这是第一行列表项。
> 2. 这是第二行列表项。
>
> 给出一些例子代码：
>
> return shell_exec("echo $input | $markdown_script");
โปรแกรมแก้ไขข้อความที่ดีสามารถสร้างการอ้างอิงแบบอีเมลได้อย่างง่ายดายตัวอย่างเช่น ใน BBEdit คุณสามารถเลือกข้อความแล้วเลือกจากเมนูเพิ่มลำดับชั้นการอ้างอิง.
รายการ
Markdown 有序列表和无序列表。
รายการที่ไม่เรียงลำดับจะใช้เครื่องหมายดอกจัน เครื่องหมายบวก หรือเครื่องหมายลบเป็นเครื่องหมายรายการ:
* Red
* Green
* Blue
เทียบเท่ากับ:
+ Red
+ Green
+ Blue
ยังเทียบเท่ากับ:
- Red
- Green
- Blue
รายการสั่งซื้อใช้ตัวเลขตามด้วยจุด:
1. Bird
2. McHale
3. Parish
สิ่งสำคัญคือต้องสังเกตว่าตัวเลขที่คุณใช้ในแท็กรายการไม่ส่งผลต่อ HTML เอาต์พุต มาร์กอัป HTML ที่เป็นผลลัพธ์สำหรับรายการด้านบนจะเป็น:
<ol>
<li>Bird</li>
<li>McHale</li>
<li>Parish</li>
</ol>
หากมาร์กอัปรายการของคุณเขียนเป็น:
1. Bird
1. McHale
1. Parish
หรือแม้กระทั่ง:
3. Bird
1. McHale
8. Parish
คุณทั้งคู่จะได้รับเอาต์พุต HTML ที่เหมือนกันทุกประการประเด็นคือ คุณสามารถสร้างหมายเลขรายการในไฟล์ Markdown เหมือนกับผลลัพธ์ของผลลัพธ์ หรือถ้าคุณขี้เกียจ คุณไม่จำเป็นต้องสนใจความถูกต้องของตัวเลขเลย
หากคุณใช้การเขียนแบบสันหลังยาว ขอแนะนำให้เริ่มต้นด้วย 1 สำหรับรายการแรก เนื่องจาก Markdown อาจสนับสนุนแอตทริบิวต์ start ของรายการสั่งซื้อในอนาคต
โดยปกติแท็กรายการจะถูกวางไว้ที่ด้านซ้ายสุด แต่สามารถเยื้องได้ไม่เกิน 3 ช่องว่าง และแท็กรายการต้องตามด้วยช่องว่างหรือแท็บอย่างน้อยหนึ่งรายการ
ในการทำให้รายการดูดีขึ้น คุณสามารถจัดระเบียบเนื้อหาด้วยการเยื้องคงที่:
* Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,
viverra nec, fringilla in, laoreet vitae, risus.
* Donec sit amet nisl. Aliquam semper ipsum sit amet velit.
Suspendisse id sem consectetuer libero luctus adipiscing.
แต่ถ้าคุณขี้เกียจก็ไม่เป็นไร:
* Lorem ipsum dolor sit amet, consectetuer adipiscing elit.
Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,
viverra nec, fringilla in, laoreet vitae, risus.
* Donec sit amet nisl. Aliquam semper ipsum sit amet velit.
Suspendisse id sem consectetuer libero luctus adipiscing.
หากรายการถูกคั่นด้วยบรรทัดว่าง Markdown จะใช้เนื้อหาของรายการเมื่อแสดงผล HTML <p> ฉลากถูกห่อ เช่น
* Bird
* Magic
จะถูกแปลงเป็น:
<ul>
<li>Bird</li>
<li>Magic</li>
</ul>
แต่นี่:
* Bird
* Magic
จะถูกแปลงเป็น:
<ul>
<li><p>Bird</p></li>
<li><p>Magic</p></li>
</ul>
รายการสามารถมีหลายย่อหน้า และย่อหน้าภายใต้แต่ละรายการต้องเยื้องโดย 4 ช่องว่างหรือ 1 แท็บ:
1. This is a list item with two paragraphs. Lorem ipsum dolor
sit amet, consectetuer adipiscing elit. Aliquam hendrerit
mi posuere lectus.
Vestibulum enim wisi, viverra nec, fringilla in, laoreet
vitae, risus. Donec sit amet nisl. Aliquam semper ipsum
sit amet velit.
2. Suspendisse id sem consectetuer libero luctus adipiscing.
มันดูดีขึ้นมากถ้าคุณเยื้องแต่ละบรรทัด แน่นอน ถ้าคุณขี้เกียจ Markdown ยังอนุญาตให้:
* This is a list item with two paragraphs.
This is the second paragraph in the list item. You're
only required to indent the first line. Lorem ipsum dolor
sit amet, consectetuer adipiscing elit.
* Another item in the same list.
หากคุณต้องการใส่ข้อมูลอ้างอิงในรายการนั้น > จำเป็นต้องเยื้อง:
* A list item with a blockquote:
> This is a blockquote
> inside a list item.
ถ้าจะใส่บล็อคต้องเยื้องบล็อคสองครั้งซึ่งก็คือ 8 ช่องว่างหรือ 2 แท็บ:
* 一列表项包含一个列表区块：
<代码写在这>
แน่นอน อาจมีการสร้างรายการโดยไม่ได้ตั้งใจ บางสิ่งเช่นนี้:
1986. What a great season.
กล่าวอีกนัยหนึ่ง มันปรากฏขึ้นที่จุดเริ่มต้นของบรรทัดnumber-period-blankเพื่อหลีกเลี่ยงปัญหานี้ คุณสามารถเพิ่มแบ็กสแลชก่อนช่วงเวลา
1986\. What a great season.
บล็อกรหัส
ซอร์สโค้ดภาษาเขียนที่เกี่ยวข้องกับโปรแกรมหรือแท็กมักมีบล็อกโค้ดเรียงพิมพ์อยู่แล้ว โดยปกติ เราไม่ต้องการให้บล็อกเหล่านี้ถูกเรียงพิมพ์ในลักษณะของไฟล์ย่อหน้าทั่วไป แต่แสดงตามที่เป็นอยู่ Markdown จะใช้ <pre> และ <code> แท็กเพื่อห่อบล็อคโค้ด
การสร้างบล็อคของโค้ดใน Markdown นั้นง่ายพอๆ กับการเยื้อง 4 ช่องว่างหรือ 1 แท็บ ตัวอย่างเช่น ป้อนข้อมูลต่อไปนี้:
这是一个普通段落：
这是一个代码区块。
Markdown จะแปลงเป็น:
<p>这是一个普通段落：</p>
<pre><code>这是一个代码区块。
</code></pre>
การเยื้องลำดับแรกนี้ต่อบรรทัด (4 ช่องว่างหรือ 1 แท็บ) จะถูกลบออก ตัวอย่างเช่น:
Here is an example of AppleScript:
tell application "Foo"
beep
end tell
จะถูกแปลงเป็น:
<p>Here is an example of AppleScript:</p>
<pre><code>tell application "Foo"
beep
end tell
</code></pre>
บล็อกของรหัสจะดำเนินต่อไปจนถึงบรรทัดที่ไม่มีการเยื้อง (หรือจุดสิ้นสุดของไฟล์)
ภายในบล็อกรหัส & , < และ > มันจะถูกแปลงเป็นเอนทิตี HTML โดยอัตโนมัติ วิธีนี้ทำให้ง่ายมากสำหรับคุณที่จะใช้ Markdown เพื่อแทรกซอร์สโค้ด HTML สำหรับตัวอย่าง เพียงแค่คัดลอกและวาง เพิ่มการเยื้อง จากนั้น Markdown ที่เหลือจะจัดการให้คุณ ตัวอย่าง:
<div class="footer">
© 2004 Foo Corporation
</div>
จะถูกแปลงเป็น:
<pre><code><div class="footer">
© 2004 Foo Corporation
</div>
</code></pre>
ในบล็อกโค้ด ไวยากรณ์ Markdown ทั่วไปจะไม่ถูกแปลง เช่น ดอกจันเป็นเพียงดอกจัน ซึ่งหมายความว่าคุณสามารถเขียนไฟล์ที่เกี่ยวข้องกับไวยากรณ์ Markdown ในไวยากรณ์ Markdown ได้อย่างง่ายดาย
ตัวแบ่ง
你可以在一行中用三个三个的星号、 号、 底线来建立一个分隔线， 行内不能有东西东西。东西可以在在号号或是减号中间插入空格。空格每种写法都建立建立分隔线：
* * *
***
*****
- - -
---------------------------------------
องค์ประกอบส่วน
ลิงค์
Markdown รองรับไวยากรณ์ลิงก์สองรูปแบบ: อินไลน์และอ้างอิงสองรูปแบบ
ไม่ว่าจะด้วยวิธีใด ข้อความลิงก์จะถูกทำเครื่องหมายด้วย [วงเล็บเหลี่ยม]
เพื่อสร้างอินไลน์หากคุณต้องการเพิ่มข้อความชื่อเรื่องของลิงก์ ให้ตัดข้อความชื่อเรื่องด้วยเครื่องหมายอัญประกาศคู่หลัง URL ตัวอย่างเช่น
This is [an example](http://example.com/ "Title") inline link.
[This link](http://example.net/) has no title attribute.
จะผลิต:
<p>This is <a href="http://example.com/" title="Title">
an example</a> inline link.</p>
<p><a href="http://example.net/">This link</a> has no
title attribute.</p>
หากคุณกำลังเชื่อมโยงไปยังทรัพยากรบนโฮสต์เดียวกัน คุณสามารถใช้พาธสัมพัทธ์ได้:
See my [About](/about/) page for details.
อ้างอิงลิงก์จะตามด้วยวงเล็บเหลี่ยมอีกอันหลังวงเล็บของข้อความลิงก์ และเครื่องหมายที่ใช้ระบุลิงก์ควรเติมลงในวงเล็บเหลี่ยมที่สอง:
This is [an example][id] reference-style link.
คุณยังสามารถเลือกเว้นวรรคระหว่างวงเล็บเหลี่ยมทั้งสอง:
This is [an example] [id] reference-style link.
จากนั้น ที่ใดก็ได้ในไฟล์ คุณสามารถกำหนดเนื้อหาลิงก์ของแท็กนี้ได้:
[id]: http://example.com/ "Optional Title Here"
เนื้อหาลิงก์ถูกกำหนดในรูปแบบ:
- วงเล็บเหลี่ยม (เว้นวรรคก่อนเว้นวรรคสามช่อง) ที่ใส่ข้อความลิงก์
- ตามด้วยโคลอน
- ตามด้วยช่องว่างหรือแท็บอย่างน้อยหนึ่งช่อง
- URL ของลิงค์ถัดไป
- เลือกติดตามเนื้อหาของชื่อเรื่อง ซึ่งสามารถอยู่ในเครื่องหมายคำพูดเดี่ยว เครื่องหมายคำพูดคู่ หรือวงเล็บ
คำจำกัดความของสามลิงก์ต่อไปนี้เหมือนกัน:
[foo]: http://example.com/ "Optional Title Here"
[foo]: http://example.com/ 'Optional Title Here'
[foo]: http://example.com/ (Optional Title Here)
ข้อควรระวัง:มีปัญหาที่ทราบแล้วว่า Markdown.pl 1.0.1 ละเว้นชื่อลิงก์ที่อยู่ในเครื่องหมายคำพูดเดี่ยว
URL ของลิงก์สามารถอยู่ในวงเล็บเหลี่ยมได้:
[id]: <http://example.com/> "Optional Title Here"
คุณยังสามารถใส่แอตทริบิวต์ชื่อในบรรทัดถัดไป หรือเพิ่มการเยื้อง ซึ่งจะดูดีขึ้นหาก URL ยาวเกินไป:
[id]: http://example.com/longish/path/to/resource/here
"Optional Title Here"
คำจำกัดความของ URL จะใช้เมื่อสร้างลิงก์เท่านั้น และไม่ปรากฏในไฟล์โดยตรง
แท็กระบุลิงก์อาจมีตัวอักษร ตัวเลข ช่องว่าง และเครื่องหมายวรรคตอน แต่ห้าม不โดยคำนึงถึงขนาดตัวพิมพ์ ดังนั้นสองลิงก์ต่อไปนี้จึงเหมือนกัน:
[link text][a]
[link text][A]
แท็กลิงก์โดยนัยอนุญาตให้คุณละเว้นการระบุแท็กลิงก์ ในกรณีนี้ แท็กลิงก์จะถือว่าเทียบเท่ากับข้อความลิงก์ หากต้องการใช้แท็กลิงก์โดยปริยาย เพียงเพิ่มวงเล็บเหลี่ยมว่างหลังข้อความลิงก์ ถ้าคุณต้องการ "Google " การเชื่อมโยงไปยัง google.com คุณสามารถทำให้ง่ายขึ้น:
[Google][]
จากนั้นกำหนดเนื้อหาลิงก์:
[Google]: http://google.com/
เนื่องจากข้อความลิงก์อาจมีช่องว่าง มาร์กอัปแบบง่ายนี้อาจมีหลายคำ:
Visit [Daring Fireball][] for more information.
จากนั้นไปกำหนดลิงค์:
[Daring Fireball]: http://daringfireball.net/
คำจำกัดความของลิงก์สามารถวางไว้ที่ใดก็ได้ในไฟล์ ฉันชอบที่จะวางไว้หลังย่อหน้าที่ลิงก์ปรากฏโดยตรง คุณยังสามารถวางไว้ที่ส่วนท้ายของไฟล์ได้เช่นเดียวกับความคิดเห็น
นี่คือตัวอย่างลิงค์อ้างอิง:
I get 10 times more traffic from [Google] [1] than from
[Yahoo] [2] or [MSN] [3].
[1]: http://google.com/ "Google"
[2]: http://search.yahoo.com/ "Yahoo Search"
[3]: http://search.msn.com/ "MSN Search"
หากคุณเปลี่ยนมาใช้ชื่อลิงก์ในการเขียน:
I get 10 times more traffic from [Google][] than from
[Yahoo][] or [MSN][].
[google]: http://google.com/ "Google"
[yahoo]: http://search.yahoo.com/ "Yahoo Search"
[msn]: http://search.msn.com/ "MSN Search"
วิธีเขียนสองวิธีข้างต้นจะสร้าง HTML ต่อไปนี้
<p>I get 10 times more traffic from <a href="http://google.com/"
title="Google">Google</a> than from
<a href="http://search.yahoo.com/" title="Yahoo Search">Yahoo</a>
or <a href="http://search.msn.com/" title="MSN Search">MSN</a>.</p>
ด้านล่างนี้คือไฟล์ Markdown ของเนื้อหาเดียวกันที่เขียนแบบอินไลน์ ซึ่งมีไว้สำหรับการเปรียบเทียบ:
I get 10 times more traffic from [Google](http://google.com/ "Google")
than from [Yahoo](http://search.yahoo.com/ "Yahoo Search") or
[MSN](http://search.msn.com/ "MSN Search").
อันที่จริงจุดเชื่อมโยงแบบอ้างอิงไม่ใช่ว่าเขียนง่ายกว่า แต่อ่านง่ายกว่า เปรียบเทียบตัวอย่างข้างต้น บทความสไตล์อ้างอิงนั้นมีความยาวเพียง 81 อักขระ แต่รูปแบบอินไลน์จะเพิ่มขึ้นเป็น 176 ตัวอักษร หากเขียนในรูปแบบ HTML ล้วนจะมีอักขระ 234 ตัว ในรูปแบบ HTML มีแท็กมากกว่าข้อความ
เมื่อใช้ลิงก์รูปแบบการอ้างอิงของ Markdown คุณสามารถทำให้เอกสารเหมือนกับผลลัพธ์สุดท้ายของเบราว์เซอร์ ช่วยให้คุณสามารถย้ายข้อมูลเมตาที่เกี่ยวข้องกับมาร์กอัปภายนอกข้อความในย่อหน้าได้ .
强调
Markdown ใช้เครื่องหมายดอกจัน (*) และบรรทัดล่างสุด (_) เป็นสัญลักษณ์สำหรับทำเครื่องหมายคำที่ขีดเส้นใต้ is * 或 _ คำที่ล้อมรอบจะถูกแปลงเป็น <em> ล้อมรอบด้วยฉลากด้วยสอง * 或 _ถ้าห่อก็จะแปลงเป็น <strong>,เช่น:
*single asterisks*
_single underscores_
**double asterisks**
__double underscores__
จะกลายเป็น:
<em>single asterisks</em>
<em>single underscores</em>
<strong>double asterisks</strong>
<strong>double underscores</strong>
คุณสามารถใช้สไตล์ใดก็ได้ตามต้องการ ข้อจำกัดเพียงอย่างเดียวคือคุณสามารถใช้สัญลักษณ์เพื่อเปิดแท็กและใช้สัญลักษณ์เพื่อปิดท้ายได้
สามารถแทรกการเน้นได้โดยตรงตรงกลางข้อความ:
un*frigging*believable
แต่ถ้าคุณ * และ _ หากมีช่องว่างทั้งสองด้าน จะถือว่าเป็นสัญลักษณ์ปกติ.
ในการแทรกเครื่องหมายดอกจันปกติหรือขีดล่างโดยตรงก่อนและหลังข้อความ คุณสามารถใช้แบ็กสแลช:
\*this text is surrounded by literal asterisks\*
รหัส
หากคุณต้องการทำเครื่องหมายโค้ดอินไลน์ชิ้นเล็ก ๆ คุณสามารถห่อด้วยเครื่องหมายย้อนกลับ (`),เช่น:
Use the `printf()` function.
จะผลิต:
<p>Use the <code>printf()</code> function.</p>
หากคุณต้องการแทรก backticks ในส่วนโค้ด คุณสามารถเริ่มต้นและสิ้นสุดส่วนโค้ดด้วย backticks หลายอัน:
``There is a literal backtick (`) here.``
ไวยากรณ์นี้สร้าง:
<p><code>There is a literal backtick (`) here.</code></p>
คุณสามารถใส่ช่องว่างที่จุดเริ่มต้นและจุดสิ้นสุดของส่วนรหัส หนึ่งช่องต่อจากจุดเริ่มต้นและอีกช่องหนึ่งก่อนสิ้นสุด เพื่อให้คุณสามารถแทรก backticks ที่จุดเริ่มต้นของส่วน:
A single backtick in a code span: `` ` ``
A backtick-delimited string in a code span: `` `foo` ``
จะผลิต:
<p>A single backtick in a code span: <code>`</code></p>
<p>A backtick-delimited string in a code span: <code>`foo`</code></p>
ภายในส่วนรหัส& และวงเล็บเหลี่ยม都จะถูกแปลงเป็นเอนทิตี HTML โดยอัตโนมัติ ซึ่งทำให้ง่ายต่อการแทรกซอร์สโค้ด HTML Markdown จะใส่ย่อหน้าต่อไปนี้:
Please don't use any `<blink>` tags.
ถึง:
<p>Please don't use any <code><blink></code> tags.</p>
คุณยังสามารถเขียนสิ่งนี้:
`—` is the decimal-encoded equivalent of `—`.
ผลิต:
<p><code>—</code> is the decimal-encoded
equivalent of <code>—</code>.</p>
图片
เห็นได้ชัดว่าเป็นการยากที่จะออกแบบรูปแบบ "ธรรมชาติ" สำหรับการแทรกรูปภาพในแอปพลิเคชันแบบข้อความเท่านั้น
Markdown ใช้ไวยากรณ์ที่คล้ายกับลิงก์เพื่อทำเครื่องหมายรูปภาพ และยังอนุญาตให้ใช้สองสไตล์: อินไลน์และอ้างอิง.
ไวยากรณ์รูปภาพแบบอินไลน์มีลักษณะดังนี้:
รายละเอียดมีดังนี้:
- เครื่องหมายอัศเจรีย์
! - 接着一个方括号，里面放上片的替代文字 . ภาพถ่าย
- จากนั้นใส่วงเล็บปกติ ใส่ URL ของรูปภาพข้างใน และปิดท้ายด้วยเครื่องหมายคำพูด และเพิ่มข้อความ 'ชื่อเรื่อง'
ไวยากรณ์รูปภาพอ้างอิงมีลักษณะดังนี้:
![Alt text][id]
"id" คือชื่อของการอ้างอิงรูปภาพ ซึ่งกำหนดในลักษณะเดียวกับการอ้างอิงลิงก์:
[id]: url/to/image "Optional title attribute"
จนถึงตอนนี้ Markdown ยังไม่มีวิธีระบุความกว้างและความสูงของรูปภาพ หากต้องการ คุณสามารถใช้ค่าปกติได้ <img> ฉลาก.
其它
ลิงค์อัตโนมัติ
Markdown รองรับการประมวลผล URL และกล่องจดหมายอีเมลในรูปแบบของลิงก์อัตโนมัติแบบสั้น ๆ ตราบเท่าที่อยู่ในวงเล็บเหลี่ยม Markdown จะแปลงเป็นลิงก์โดยอัตโนมัติข้อความลิงก์ของ URL ทั่วไปจะเหมือนกับที่อยู่ลิงก์ เช่น
<http://example.com/>
Markdown จะถูกแปลงเป็น:
<a href="http://example.com/">http://example.com/</a>
การเชื่อมโยงที่อยู่อีเมลโดยอัตโนมัติก็คล้ายกัน ยกเว้น Markdown จะทำขั้นตอนการแปลงการเข้ารหัสก่อน โดยแปลงอักขระข้อความเป็นเอนทิตี HTML เลขฐานสิบหก รูปแบบนี้สามารถหลอกโรบ็อตรวบรวมที่อยู่อีเมลที่ไม่ดีได้ เช่น:
<[email protected]>
Markdown จะกลายเป็น:
<a href="mailto:addre
[email protected]
m">address@exa
mple.com</a>
ในเบราว์เซอร์ สตริงนี้ (อันที่จริง <a href="mailto:[email protected]">[email protected]</a>) กลายเป็นลิงก์ "[email protected]" ที่คลิกได้
(ถึงแม้วิธีนี้จะหลอกหุ่นยนต์ได้มากมาย แต่ก็ไม่สามารถหยุดพวกมันได้ทั้งหมด แต่ก็ดีกว่าไม่ทำอะไรเลย ไม่ว่าในกรณีใด การเปิดกล่องจดหมายของคุณจะดึงดูดจดหมายโฆษณาในที่สุด)
แบ็กสแลช
Markdown สามารถใช้แบ็กสแลชเพื่อแทรกสัญลักษณ์บางอย่างที่มีความหมายอื่นในไวยากรณ์ ตัวอย่างเช่น หากคุณต้องการเพิ่มเครื่องหมายดอกจันถัดจากข้อความเพื่อเน้น (แต่ไม่ใช่ <em> ) คุณสามารถนำหน้าเครื่องหมายดอกจันด้วยแบ็กสแลช:
\*literal asterisks\*
Markdown 面加上反斜杠来帮助插入普通的符号：
\ 反斜线
` 反引号
* 星号
_ 底线
{} 花括号
[] 方括号
() 括弧
# 井字号
+ 加号
- 减号
. 英文句点
! 惊叹号Markdown โปรแกรมแก้ไขฟรี
แพลตฟอร์ม Windows
แพลตฟอร์ม Mac
บรรณาธิการออนไลน์
ปลั๊กอินเบราว์เซอร์
*** หากมีตัวแก้ไข Markdown ที่ดีกว่าที่จะแนะนำ โปรดใส่ใจกับข้อเสนอแนะเฉิน เว่ยเหลียง,ขอขอบคุณ!
หวัง Chen Weiliang บล็อก ( https://www.chenweiliang.com/ ) แชร์ "Markdown หมายถึงอะไร? วิธีใช้มาร์กอัปไวยากรณ์ / การจัดรูปแบบ Markdown , ช่วยคุณ.
ยินดีต้อนรับสู่การแบ่งปันลิงค์ของบทความนี้:https://www.chenweiliang.com/cwl-482.html
ยินดีต้อนรับสู่ช่อง Telegram ของบล็อกของ Chen Weiliang เพื่อรับข่าวสารล่าสุด!
📚 คู่มือนี้มีคุณค่ามหาศาล 🌟 นี่เป็นโอกาสที่หายาก อย่าพลาด! ⏰⌛💨
แชร์และชอบถ้าคุณชอบ!
การแบ่งปันและไลค์ของคุณเป็นแรงจูงใจอย่างต่อเนื่องของเรา!