Markdown เพื่อแทรกและแสดงรูปภาพบน GitHub repo

41

ตามเอกสาร GitHubไวยากรณ์ Markdown สำหรับการแทรกภาพคือ:

![GitHub Logo](/images/logo.png)
Format: ![Alt Text](url)

ตามตัวอย่างไวยากรณ์ของพวกเขาฉันไม่สามารถทำให้มันทำงานได้

แม้แต่ตัวอย่างโลโก้ GitHub ก็ใช้งานไม่ได้

ฉันพลาดอะไรไป หรือเป็นข้อบกพร่องของ GitHub?

github markdown

— นิค
แหล่งที่มา

เปลี่ยน URL เป็นเส้นทางแบบสมบูรณ์พร้อมด้วย HTTP และดูว่าจะพาคุณไปที่ไหน

— Eight Days of Malaise

@EightDaysofMalaise: นั่นมันหลอกลวงจริง ๆ ... คุณช่วยเขียนมันเป็นคำตอบได้ไหม? ฉันรายงานข้อผิดพลาดของเอกสารไปยัง Github

— nic

ฉันคิดว่าเอกสารของพวกเขาเปลี่ยนไป "รูปภาพ" , "รูปภาพ"และ"โลโก้"จะไม่ถูกกล่าวถึงในหน้านี้อีกต่อไป

— jww

35

คุณอาจพลาดเส้นทาง / ที่ตั้งแบบเต็มไปยังรูปภาพที่คุณต้องการรวมไว้ในไฟล์ Markdown

ตัวอย่างที่ให้ไว้คือพา ธ สัมพัทธ์โดยที่ภาพวางอยู่บนเซิร์ฟเวอร์เดียวกันกับไฟล์ ในความช่วยเหลือมันจะถือว่าภาพอยู่ที่:

https://github.com/images/logo.png

แต่นั่นไม่ใช่ไฟล์หรือตำแหน่งที่ถูกต้อง

เพื่อให้แน่ใจว่าคุณสามารถแสดงภาพไม่ว่าคุณจะรับชมจากที่ใดก็ปลอดภัยกว่าที่จะรวม URL แบบเต็มซึ่งจะรวมถึงชื่อโดเมน

ดังนั้นตัวอย่างของคุณจะใช้สิ่งที่คล้ายกับสิ่งนี้แทน:

![Bilby Stampede](http://example.com/images/logo.png)

— แปดวันแห่ง Malaise
แหล่งที่มา

25

ในการตอบกลับคำตอบข้างต้น:

ตั้งแต่วันที่ 30 มกราคม 2013 ตอนนี้ GitHub อนุญาตการเชื่อมโยงที่เกี่ยวข้อง

ตรวจสอบให้แน่ใจว่าคุณต่อท้าย? raw = true ต่อท้าย URL นี่คือตัวอย่าง:

![Image](../blob/master/public_html/img/nokia.png?raw=true)

เนื่องจากวิธีที่ GitHub จัดการกับ URL หากคุณไม่ผนวก? raw = true ให้กับ URL ต้นทางเบราว์เซอร์ของคุณจะพยายามโหลดหน้าเว็บที่แสดงภาพ

— Chris Morris
แหล่งที่มา

คุณแน่ใจหรือว่าการอัปเดตนั้นรวมถึงการใช้เป็น src ด้วย?

— แปดวันแห่ง Malaise

1

ใช่แล้ว. แม้ว่าคุณจะต้องผนวก "? raw = true" ต่อท้าย URL นี่คือตัวอย่าง: ! [Image] (../ blob / master / public_html / img / nokia.png? raw = true)

— Chris Morris

เพิ่งปรับปรุงคำตอบ :)

— Chris Morris

1

สิ่งนี้ใช้ได้กับไฟล์ Markdown ของฉัน แต่ฉันได้รับข้อผิดพลาดกับ pandoc: pandoc: ข้อผิดพลาดในการสร้าง PDF จากแหล่ง TeX ! ข้อผิดพลาดของ LaTeX: ส่วนขยายกราฟิกที่ไม่รู้จัก: .png? raw = true ดูคำแนะนำจาก LaTeX หรือ LaTeX Companion พิมพ์ H <return> เพื่อขอความช่วยเหลือทันที ... l.175 ... 2014-04-08_Bergman2011_Fig2.png? raw = true}

— djhocking

2

ฉันต้องการทดสอบ Markdown ของฉันในพื้นที่ก่อนผลักดันบางแห่งที่สามารถดูได้ผ่าน URL เท่านั้น ดังนั้นฉันต้องการ URL สัมพัทธ์ที่ฉันสามารถใช้ได้ทุกที่ ตอนนี้ GitHub สนับสนุนสิ่งเหล่านั้นแล้ว

imagesไดเรกทอรีย่อยของคุณสมมติว่ามันอยู่ในไดเรกทอรีเดียวกับไฟล์ Markdown ของคุณโดยไม่ต้องใช้เครื่องหมายทับตอนเริ่มต้น - ลอง:

markdown ![GitHub Logo](images/logo.png)

แทน

markdown ![GitHub Logo](/images/logo.png)

— brannerchinese
แหล่งที่มา