เครื่องมือสร้างลิงก์ Markdown

ลิงก์สี่รูปแบบ

แบบฝังในบรรทัด ไม่มีชื่อเรื่อง:

[อ่านเอกสาร](https://example.com/docs)

แบบฝังในบรรทัดพร้อมชื่อเรื่อง (คำแนะนำเมื่อเลื่อนเมาส์ไปวาง):

[อ่านเอกสาร](https://example.com/docs "เอกสารฉบับเต็ม")

แบบอ้างอิง (กำหนด URL ไว้ด้านล่าง):

เปิด [เอกสาร][docs] หรือ [บันทึกการเปลี่ยนแปลง][cl]

[docs]: https://example.com/docs
[cl]:   https://example.com/changelog

ลิงก์อัตโนมัติ (URL เป็นทั้งข้อความและปลายทาง):

<https://example.com>

ควรเลือกแบบใดเมื่อใด

• แบบฝังในบรรทัด เหมาะกับลิงก์ที่ใช้เป็นครั้งคราว เมื่อ URL สั้นและย่อหน้ายังคงอ่านได้ดี
• แบบอ้างอิง เมื่อคุณอ้างถึง URL เดียวกันหลายครั้ง หรือเมื่อ URL เป็นสายอักขระติดตามที่ยาวถึง 200 ตัวอักษร ซึ่งมิฉะนั้นจะทำให้ลำดับย่อหน้าขาดตอน
• ลิงก์อัตโนมัติ สำหรับกรณีอย่าง “นี่คือหน้าเอกสารของเรา” ที่คุณต้องการให้ URL ปรากฏทั้งเป็นข้อความและเป็นปลายทางตรง ๆ

การจัดการอักขระพิเศษ

• ช่องว่าง ใน URL ต้องใช้ %20 มิฉะนั้นลิงก์จะขาดตรงช่องว่าง
• วงเล็บใน URL ต้องเข้ารหัส URL เป็น %28 และ %29 มิฉะนั้นตัวแยกวิเคราะห์ Markdown จะกลืนมันไป
• วงเล็บเหลี่ยมในข้อความลิงก์ ต้องเอสเคปเป็น \[ และ \] เพื่อป้องกันไม่ให้ตัวแยกวิเคราะห์ตีความว่าเป็นไวยากรณ์ลิงก์ซ้อนกัน

เคล็ดลับด้านการเข้าถึง

• หลีกเลี่ยงคำว่า “คลิกที่นี่” ข้อความลิงก์อย่าง คลิกที่นี่ หรือ อ่านเพิ่มเติม ไม่มีประโยชน์เมื่อผู้ใช้โปรแกรมอ่านหน้าจอกดแท็บไล่ผ่านลิงก์ ให้ใช้ข้อความที่สื่อความหมาย เช่น [คู่มือการติดตั้ง](...)
• อย่าใช้ตัว URL เองเป็นข้อความลิงก์สำหรับ URL ยาว ๆ เพราะไม่เป็นมิตรกับเทคโนโลยีช่วยเหลือและดูไม่สวยเมื่อพิมพ์ออกมา
• “เปิดในแท็บใหม่” เป็น HTML ดิบ (target="_blank") ไม่ใช่ Markdown โปรแกรมแสดงผลส่วนใหญ่ที่รับ HTML ดิบจะทำตามได้ แต่ CommonMark ล้วน ๆ จะไม่รองรับ

ทางลัดบรรทัดเดียว

ในความคิดเห็นบน GitHub การวาง URL ไว้ข้างข้อความที่เลือกจะแปลงเป็นลิงก์ Markdown ให้โดยอัตโนมัติ สะดวกมากเมื่อคุณอยู่ในตัวแก้ไขอยู่แล้ว