ไวยากรณ์ลิงก์
ลิงก์เป็นองค์ประกอบสำคัญในการเชื่อมเนื้อหาใน Markdown การเข้าใจไวยากรณ์ลิงก์ประเภทต่างๆ สามารถทำให้เอกสารของคุณเชื่อมต่อและใช้งานได้มากขึ้น
ไวยากรณ์ลิงก์พื้นฐาน
ลิงก์อินไลน์
ใช้รูปแบบ [ข้อความลิงก์](URL) สร้างลิงก์:
นี่คือลิงก์ไปยัง [Google](https://www.google.com)
เยี่ยมชม [GitHub](https://github.com) เพื่อดูโปรเจ็กต์โอเพ่นซอร์สผลการแสดง:
นี่คือลิงก์ไปยัง Google เยี่ยมชม GitHub เพื่อดูโปรเจ็กต์โอเพ่นซอร์ส
ลิงก์พร้อมชื่อเรื่อง
เพิ่มข้อมูลชื่อเรื่องหลัง URL จะแสดงเมื่อวางเมาส์:
นี่คือ [ลิงก์พร้อมชื่อเรื่อง](https://www.example.com "นี่คือชื่อเรื่องลิงก์")ผลการแสดง:
นี่คือ ลิงก์พร้อมชื่อเรื่อง
ลิงก์อ้างอิง
ลิงก์อ้างอิงพื้นฐาน
แยกคำนิยามลิงก์จากการใช้งาน:
นี่คือ [ลิงก์อ้างอิง][1]
นี่คือ [ลิงก์อ้างอิงอีกอัน][link-name]
[1]: https://www.example.com
[link-name]: https://www.google.com "Google ค้นหา"ผลการแสดง:
นี่คือ ลิงก์อ้างอิง นี่คือ ลิงก์อ้างอิงอีกอัน
ป้ายกำกับลิงก์แบบโดยนัย
ข้อความลิงก์เองเป็นป้ายกำกับ:
เยี่ยมชม [Google][] เพื่อค้นหา
ดูโปรเจ็กต์บน [GitHub][]
[Google]: https://www.google.com
[GitHub]: https://github.comผลการแสดง:
เยี่ยมชม Google เพื่อค้นหา ดูโปรเจ็กต์บน GitHub
ลิงก์อัตโนมัติ
URL อัตโนมัติ
ป้อน URL โดยตรง ครอบด้วยเครื่องหมายวงเล็บเหลี่ยม:
<https://www.example.com>
<https://github.com/user/repo>ผลการแสดง:
https://www.example.comhttps://github.com/user/repo
ลิงก์อีเมลอัตโนมัติ
ติดต่อฉัน: <user@example.com>
สนับสนุนทางเทคนิค: <support@company.com>ผลการแสดง:
ติดต่อฉัน: user@example.com สนับสนุนทางเทคนิค: support@company.com
ลิงก์ภายใน
ลิงก์จุดยึด
ลิงก์ไปยังหัวข้อในหน้าเดียวกัน:
ข้ามไปยัง [ไวยากรณ์ลิงก์พื้นฐาน](#ไวยากรณ์ลิงก์พื้นฐาน)
ดู [แนวทางปฏิบัติที่ดีที่สุด](#แนวทางปฏิบัติที่ดีที่สุด)ผลการแสดง:
ข้ามไปยัง ไวยากรณ์ลิงก์พื้นฐาน ดู แนวทางปฏิบัติที่ดีที่สุด
ลิงก์เส้นทางสัมพัทธ์
ลิงก์ไปยังไฟล์อื่น:
ดู [ไวยากรณ์หัวข้อ](headings.md)
กลับ [หน้าแรก](../index.md)ลิงก์พิเศษ
ลิงก์รูปภาพ
ห่อหุ้มรูปภาพในลิงก์:
[](https://www.example.com)ลิงก์ดาวน์โหลด
ลิงก์ไปยังการดาวน์โหลดไฟล์:
ดาวน์โหลด [คู่มือผู้ใช้](files/manual.pdf)
รับ [โค้ดตัวอย่าง](examples/demo.zip)การจัดรูปแบบข้อความลิงก์
ข้อความลิงก์พร้อมรูปแบบ
นี่คือ [**ลิงก์ตัวหนา**](https://www.example.com)
นี่คือ [*ลิงก์ตัวเอียง*](https://www.example.com)
นี่คือ [`ลิงก์สไตล์โค้ด`](https://www.example.com)ผลการแสดง:
นี่คือ ลิงก์ตัวหนา นี่คือ ลิงก์ตัวเอียง นี่คือ ลิงก์สไตล์โค้ด
ข้อความลิงก์หลายบรรทัด
นี่คือ [ข้อความลิงก์ยาวมาก
อาจต้องแสดงหลายบรรทัด](https://www.example.com)ข้อผิดพลาดทั่วไปและวิธีแก้ไข
1. วงเล็บไม่ตรงกัน
❌ ผิด:
[ข้อความลิงก์(https://www.example.com) ← ขาดวงเล็บปิด
✅ ถูกต้อง:
[ข้อความลิงก์](https://www.example.com)2. ปัญหาช่องว่าง
❌ ผิด:
[ ข้อความลิงก์ ]( https://www.example.com ) ← ช่องว่างที่ไม่จำเป็น
✅ ถูกต้อง:
[ข้อความลิงก์](https://www.example.com)3. การเข้ารหัส URL
สำหรับ URL ที่มีอักขระพิเศษ:
❌ อาจมีปัญหา:
[ค้นหา](https://www.google.com/search?q=markdown)
✅ ปลอดภัยกว่า:
[ค้นหา](https://www.google.com/search?q=markdown)
หรือใช้การอ้างอิง:
[ค้นหา][google-search]
[google-search]: https://www.google.com/search?q=markdownแนวทางปฏิบัติที่ดีที่สุด
1. ใช้ข้อความลิงก์แบบอธิบาย
✅ แนะนำ: ข้อความอธิบาย
ดู [เอกสารไวยากรณ์ Markdown อย่างเป็นทางการ](https://daringfireball.net/projects/markdown/syntax)
❌ ไม่แนะนำ: ข้อความทั่วไป
คลิก [ที่นี่](https://daringfireball.net/projects/markdown/syntax) เพื่อดูเอกสาร2. ใช้ลิงก์อ้างอิงสำหรับเอกสารยาว
✅ แนะนำ: เอกสารยาวใช้ลิงก์อ้างอิง
ในการวิจัยของเรา เราได้อ้างอิงงานของ [Smith และคณะ][smith2020],
[ทฤษฎีของ Jones][jones2019] และ [รายงานอุตสาหกรรมล่าสุด][industry2021]
[smith2020]: https://www.markdownlang.com/smith-2020-paper
[jones2019]: https://www.markdownlang.com/jones-theory
[industry2021]: https://www.markdownlang.com/industry-report-20213. รักษา URL ให้สั้น
✅ แนะนำ: ใช้ URL สั้นหรือโดเมนกำหนดเอง
[หน้าแรกโปรเจ็กต์](https://myproject.com)
✅ ยอมรับได้: URL ยาวใช้ลิงก์อ้างอิง
ดู [รายงานวิเคราะห์รายละเอียด][detailed-report]
[detailed-report]: https://company.com/reports/2023/detailed-analysis-q4-performance-metricsการตรวจสอบลิงก์
ตรวจสอบความถูกต้องของลิงก์
ตรวจสอบลิงก์ในเอกสารเป็นประจำ:
<!-- แนะนำให้เพิ่มความคิดเห็นเพื่อทำเครื่องหมายสถานะลิงก์ -->
[ลิงก์ใช้งาน](https://www.google.com) <!-- ✓ 2023-01-15 -->
[ลิงก์เลิกใช้](https://old-site.com) <!-- ⚠️ อาจไม่ทำงาน -->ใช้เครื่องมือตรวจสอบ
- linkchecker - เครื่องมือตรวจสอบลิงก์บรรทัดคำสั่ง
- markdown-link-check - การตรวจสอบลิงก์ Node.js
- ปลั๊กอิน VS Code - การตรวจสอบลิงก์แบบเรียลไทม์
HTML เอาต์พุต
ลิงก์ Markdown แปลงเป็น HTML:
[ข้อความลิงก์](https://www.example.com "ชื่อเรื่อง")แปลงเป็น:
<a href="https://www.example.com" title="ชื่อเรื่อง">ข้อความลิงก์</a>เทคนิคขั้นสูง
1. ลิงก์แบบเงื่อนไข
ตัดสินใจเพิ่มลิงก์อย่างไดนามิกตามบริบท:
ในสภาพแวดล้อมการพัฒนา เข้าถึง [เซิร์ฟเวอร์ท้องถิ่น](http://localhost:3000)
ในสภาพแวดล้อมการผลิต เข้าถึง [เซิร์ฟเวอร์ออนไลน์](https://production.example.com)2. การจัดกลุ่มลิงก์
จัดการลิงก์ที่เกี่ยวข้องแบบจัดกลุ่ม:
<!-- ทรัพยากรอย่างเป็นทางการ -->
[เว็บไซต์อย่างเป็นทางการ][official]
[เอกสารอย่างเป็นทางการ][docs]
[บล็อกอย่างเป็นทางการ][blog]
<!-- ทรัพยากรชุมชน -->
[ที่เก็บ GitHub][github]
[การอภิปรายฟอรั่ม][forum]
[บล็อกชุมชน][community]
[official]: https://www.markdownlang.com
[docs]: https://docs.example.com
[blog]: https://blog.example.com
[github]: https://github.com/example/project
[forum]: https://forum.example.com
[community]: https://community.example.com3. ลิงก์หลายภาษา
ดูเอกสาร: [English](README.md) | [中文](README-zh.md) | [日本語](README-ja.md)ตัวอย่างการใช้งานจริง
เมนูนำทาง
## การนำทางด่วน
**คู่มือเริ่มต้น**
- [Markdown คืออะไร](what-is-markdown.md)
- [ติดตั้งตัวแก้ไข](install-editor.md)
- [เอกสารแรก](first-document.md)
**การอ้างอิงไวยากรณ์**
- [ไวยากรณ์พื้นฐาน](basic-syntax.md)
- [ไวยากรณ์ขยาย](extended-syntax.md)
- [แนวทางปฏิบัติที่ดีที่สุด](best-practices.md)
**ลิงก์ทรัพยากร**
- [เว็บไซต์อย่างเป็นทางการ](https://daringfireball.net/projects/markdown/)
- [ตัวแก้ไขออนไลน์](https://dillinger.io/)
- [เครื่องมือตรวจสอบไวยากรณ์](https://markdownlint.github.io/)บรรณานุกรม
## บรรณานุกรม
เอกสารนี้เขียนบนพื้นฐานของทรัพยากรต่อไปนี้:
1. [ไวยากรณ์ Markdown อย่างเป็นทางการ][markdown-syntax] - John Gruber
2. [ข้อกำหนด CommonMark][commonmark] - การทำให้ Markdown เป็นมาตรฐาน
3. [GitHub Flavored Markdown][gfm] - ไวยากรณ์ขยายของ GitHub
4. [คู่มือ Markdown][markdown-guide] - ทรัพยากรการเรียนรู้ที่ครอบคลุม
[markdown-syntax]: https://daringfireball.net/projects/markdown/syntax
[commonmark]: https://commonmark.org/
[gfm]: https://github.github.com/gfm/
[markdown-guide]: https://www.markdownguide.org/เครื่องมือแนะนำ
## เครื่องมือแนะนำ
### ตัวแก้ไข
- [Typora](https://typora.io/) - ตัวแก้ไขแบบเห็นผลจริง
- [Mark Text](https://marktext.app/) - ตัวแก้ไขโอเพ่นซอร์สฟรี
- [VS Code](https://code.visualstudio.com/) + ปลั๊กอิน Markdown
### เครื่องมือออนไลน์
- [Dillinger](https://dillinger.io/) - ตัวแก้ไขออนไลน์
- [StackEdit](https://stackedit.io/) - ตัวแก้ไขออนไลน์ที่เต็มไปด้วยฟังก์ชัน
- [Markdown to HTML](https://markdowntohtml.com/) - การแปลงรูปแบบ
### เครื่องมือสร้างไซต์แบบคงที่
- [VitePress](https://vitepress.dev/) - ระบบนิเวศ Vue
- [Docusaurus](https://docusaurus.io/) - ระบบนิเวศ React
- [GitBook](https://gitbook.com/) - แพลตฟอร์มเอกสารไวยากรณ์ที่เกี่ยวข้อง
- ไวยากรณ์รูปภาพ - แทรกรูปภาพ
- ไวยากรณ์อ้างอิง - อ้างอิงข้อความ
- ไวยากรณ์โค้ด - การจัดรูปแบบโค้ด
- ลิงก์อัตโนมัติ - ฟังก์ชันลิงก์ขยาย
แบบฝึกหัด
ลองสร้างลิงก์ประเภทต่อไปนี้:
- รายการทรัพยากรที่รวมหลายลิงก์ภายนอก
- เอกสารเทคนิคที่ใช้ลิงก์อ้างอิง
- เอกสารยาวที่มีการนำทางภายใน
- หน้าติดต่อที่มีลิงก์อีเมลและเว็บไซต์