Как отображать изображения в файлах Markdown на Github?

82

Я хочу отобразить некоторые изображения в файле Markdown на Github. Я обнаружил, что это работает так:

![Figure 1-1](https://raw.github.com/username/repo/master/images/figure 1-1.png "Figure 1-1")

Но мне нужно сотрудничать с другими, поэтому я не хочу, чтобы имя пользователя и имя репо были жестко закодированы.

Я пробовал использовать это:

![Figure 1-1](images/figure 1-1.png "Figure 1-1")

Он работает на моем локальном диске, но не работает на Github.

Кто-нибудь знает об этой проблеме?

WoooHaaaa
источник

Ответы:

139

Я сам нашел ответ.

Просто добавьте ? Raw = true к URL-адресу изображения, и это поможет:

![](images/table 1-1.png?raw=true)
WoooHaaaa
источник
2
У меня это работает при просмотре файлов Markdown непосредственно на GitHub, но не для файла README.markdown, отображаемого на главной странице проекта.
jmohr
@jmohr Я считаю, что файлы README на главной странице следует рассматривать как исключение.
WoooHaaaa
Это сработало для меня с файлом README на главной странице.
Майк Грейс
1
Github по-прежнему не поддерживает SVG даже с raw. stackoverflow.com/questions/13808020/…
Йео
20

У меня была такая же проблема, и она оказалась вызвана пробелом в URL-адресе. URL-адрес, кодирующий пробел вручную, как %20исправлено.

Итак, используя ваш пример, я изменил:

![](images/table 1-1.png)

кому:

![](images/table%201-1.png)

Изменить: я спросил github об этом, и это ожидаемое поведение с тех пор, как они перешли на новую спецификацию для рендеринга Markdown. Спецификация явно запрещает пробелы в URI, потому что теперь пробел используется для отделения URI от необязательного заголовка изображения. Соответствующая часть спецификации находится здесь:

https://github.github.com/gfm/#example-471 - пункт назначения не может содержать пробелы или разрывы строк, даже если они заключены в заостренные скобки.

foz
источник