เชี่ยวชาญการจัดรูปแบบรูปภาพ Markdown: ไวยากรณ์ การจัดวาง ขนาด และแนวทางปฏิบัติที่ดีที่สุด
Markdown ได้กลายเป็นมาตรฐานสากลสำหรับการเขียนเอกสารทางเทคนิค เอกสารนักพัฒนา ข้อมูลใน GitHub และบล็อกคงที่ เช่น Hugo, Jekyll, Gatsby และ Next.js แม้จะเรียบง่ายแต่หนึ่งในปัญหาที่พบบ่อยคือการจัดการรูปภาพอย่างมีประสิทธิภาพ
ไวยากรณ์รูปภาพ Markdown มาตรฐาน
การแทรกรูปภาพใช้ไวยากรณ์ง่ายๆ ประกอบด้วยเครื่องหมายอัศเจรีย์ วงเล็บเหลี่ยมสำหรับข้อความทดแทน (alt text) และวงเล็บเล็บเปิดปิดสำหรับ URL รูปภาพ:

- เครื่องหมายอัศเจรีย์ (
!): แจ้งให้ตัวแยกวิเคราะห์ Markdown รู้ว่าเป็นรูปภาพไม่ใช่ลิงก์ข้อความ - วงเล็บเหลี่ยม (
[...]): ใส่ alt text ซึ่งสำคัญมากสำหรับ screen reader และการจัดดรรชนีของเสิร์ชเอ็นจิ้น - วงเล็บเปิดปิด (
(...)): ใส่ URL หรือ path ของรูปภาพ พร้อมชื่อบนข้อความกำกับแบบลอย (ถ้ามี)
ข้อจำกัดของรูปภาพ Markdown มาตรฐาน
แม้ว่าไวยากรณ์นี้จะใช้ได้ดี แต่ Markdown มาตรฐานไม่มีตัวควบคุมสไตล์ เช่น:
- ขนาดที่แน่นอน: การกำหนดความกว้างพิกเซลหรือเปอร์เซ็นต์ (เช่น
width="600"หรือwidth="50%") - การจัดวาง: การจัดรูปภาพให้อยู่ตรงกลาง ซ้าย หรือขวา พร้อมการไหลของข้อความ
- คำอธิบายภาพ: การแสดงคำอธิบายใต้รูปภาพอย่างเป็นระบบ
- พฤติกรรมตอบสนอง: การกำหนด lazy-loading (
loading="lazy") หรือรูปภาพแบบตอบสนอง (srcset)
เมื่อเขียนบน GitHub READMEs หรือบล็อกส่วนตัว รูปภาพที่ไม่ได้จัดรูปแบบมักจะล้นคอนเทนเนอร์ แสดงขนาดใหญ่เกินไป หรือทำให้โครงสร้างหน้าเสีย
โค้ด HTML สำรอง vs โค้ดที่สะอาด
เพื่อเอาชนะข้อจำกัดเหล่านี้ ผู้เขียนมักแทรกแท็ก HTML ใน Markdown:
<img src="https://example.com/image.png" alt="Descriptive Alt Text" width="600" align="center" />
อย่างไรก็ตาม การเขียนแท็ก HTML ด้วยตนเองอาจทำให้เกิดข้อผิดพลาดทางไวยากรณ์ได้ง่าย
ด้วย Utiliome Free Markdown Image Formatter คุณสามารถสลับระหว่างไวยากรณ์ Markdown, แท็ก HTML และแท็ก <figure> ได้อย่างง่ายดาย เครื่องมือจะจัดการกรองและจัดรูปแบบโค้ดของคุณให้ตรงกับข้อกำหนดของแพลตฟอร์ม เช่น GitHub Flavored Markdown (GFM), CommonMark หรือ MDX