Đánh dấu để chèn và hiển thị hình ảnh trên repo GitHub

41

Theo tài liệu GitHub , cú pháp Markdown để chèn hình ảnh là:

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

Theo cú pháp ví dụ của họ, tôi dường như không thể làm cho nó hoạt động.

Ngay cả ví dụ về logo GitHub cũng không hoạt động.

Tôi đang thiếu gì? Hay là một lỗi GitHub?

github markdown

— đẹp
nguồn

Thay đổi URL thành một đường dẫn đầy đủ hoàn chỉnh với HTTP và xem nơi sẽ đưa bạn

— Tám ngày của Malaise

@EightDaysofMalaise: Đó thực sự là mánh khóe ... Bạn có thể vui lòng viết điều này như một câu trả lời không? Tôi đã báo cáo lỗi tài liệu cho Github.

— nic

Tôi nghĩ rằng tài liệu của họ đã thay đổi. "Hình ảnh" , "hình ảnh" và "logo" không còn được đề cập trên trang.

— jww

35

Bạn có thể thiếu đường dẫn / vị trí đầy đủ đến hình ảnh bạn muốn đưa vào tệp Markdown.

Ví dụ đưa ra là một đường dẫn tương đối, trong đó hình ảnh nằm trên cùng một máy chủ với tệp. Trong trợ giúp, nó sẽ cho rằng hình ảnh thực sự nằm ở:

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

Nhưng đó không phải là một tập tin hoặc vị trí hợp lệ.

Để đảm bảo bạn có thể hiển thị hình ảnh cho dù bạn đang xem nó từ đâu, an toàn hơn là bao gồm URL đầy đủ, bao gồm tên miền.

Vì vậy, ví dụ của bạn thay vào đó sẽ sử dụng một cái gì đó tương tự như thế này:

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

— Tám ngày bất ổn
nguồn

25

Đáp lại câu trả lời trên:

Kể từ ngày 30 tháng 1 năm 2013, GitHub hiện cho phép các liên kết tương đối .

Mặc dù vậy, hãy chắc chắn rằng bạn nối? Raw = true vào cuối URL. Đây là một ví dụ:

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

Do cách GitHub xử lý URL, nếu bạn không nối? Raw = true với URL nguồn, trình duyệt của bạn sẽ cố tải trang hiển thị hình ảnh.

— Chris Morris
nguồn

Bạn có chắc rằng bản cập nhật cũng bao gồm sử dụng như src không?

— Tám ngày bất ổn

1

Vâng, nó làm. Mặc dù vậy, bạn phải nối "? Raw = true" vào cuối URL. Đây là một ví dụ : ! [Hình ảnh] (../ blob / master / public_html / img / nokia.png? Raw = true)

— Chris Morris

Chỉ cần cập nhật câu trả lời :).

— Chris Morris

1

Điều này hoạt động cho tệp Markdown của tôi nhưng tôi gặp lỗi với pandoc: pandoc: Lỗi khi tạo PDF từ nguồn TeX. ! Lỗi LaTeX: Tiện ích mở rộng đồ họa không xác định: .png? Raw = true. Xem hướng dẫn sử dụng LaTeX hoặc LaTeX Companion để được giải thích. Nhập H <return> để được trợ giúp ngay lập tức. ... l.175 ... 2014-04-08_Bergman2011_Fig2.png? raw = true}

— djhocking

2

Tôi muốn kiểm tra Markdown của mình cục bộ trước khi đẩy một nơi nào đó chỉ có thể xem được thông qua một URL. Vì vậy, tôi muốn một URL tương đối mà tôi có thể sử dụng bất cứ nơi nào. GitHub hiện hỗ trợ những người đó.

Thư imagesmục con của bạn , giả sử nó nằm trong cùng thư mục với tệp Markdown của bạn, không cần gạch chéo ngay từ đầu - hãy thử:

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

thay vì

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

— brannerchinese
nguồn