Розмітка для вставки та відображення зображення на репортажі GitHub

40

Відповідно до документації GitHub , синтаксис Markdown для вставки зображення є:

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

Слідуючи їх прикладу синтаксису, я, здається, не зможу змусити його працювати.

Навіть приклад логотипу GitHub не працює.

Що я пропускаю? Або це помилка GitHub?

github markdown

— нік
джерело

Змініть URL-адресу на повний шлях разом із HTTP та подивіться, куди це веде

— Вісім днів нездужання

@EightDaysofMalaise: Це справді хитрість ... Чи не могли б ви написати це як відповідь? Я повідомив про помилку в документації Github.

— Нік

Я думаю, що їх документація змінилася. "Зображення" , "картинка" та "логотип" більше не згадуються на сторінці.

34

Можливо, вам не вистачає повного шляху / розташування до зображення, яке ви хочете включити у файл Markdown.

Наведений приклад - відносний шлях, коли зображення опирається на той же сервер, що і файл. У довідці можна припустити, що зображення фактично розташоване за адресою:

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

Але це не допустимий файл чи місцезнаходження.

Щоб переконатися, що ви можете відображати зображення незалежно від того, звідки ви його переглядаєте, безпечніше буде вказати повну URL-адресу, яка б включала доменне ім’я.

Тож замість вашого прикладу буде використовувати щось подібне до цього:

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

— Вісім днів нездужання
джерело

24

У відповідь на відповідь вище:

Станом на 30 січня 2013 року GitHub тепер надає відносні посилання .

Переконайтеся, що ви додали? Raw = true до кінця URL-адреси. Ось приклад:

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

Завдяки тому, як GitHub обробляє URL-адреси, якщо ви не додаєте? Raw = true до вихідної URL-адреси, ваш браузер спробує завантажити сторінку, на якій відображається зображення.

— Кріс Морріс
джерело

Ви впевнені, що оновлення також включає використання як src?

— Вісім днів нездужання

1

Так. Хоча до кінця URL-адреси потрібно додати "? Raw = true". Ось приклад :! [Зображення] (../ blob / master / public_html / img / nokia.png? Raw = true)

— Кріс Морріс

Щойно оновив відповідь :).

— Кріс Морріс

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)

— висівки
джерело