how to reference images in markdown-compliant manner?

[gernotstarke]

In markdown I usually reference images like

![](images/filename.png)

that seems NOT to work here.. any idea?

[ttskch]

@gernotstarke Thanks for using. You can use /assets/img/ dir for putting your own images. For example,

This change shows the specified image correctly like below.

I hope this helps you. Thanks.

[gernotstarke]

Hi Takashi, thanx for your nice reply. I recently started to work on a rather large Jekyll site, using a slightly modified version of your theme (please expect some PR’s later on)… The „standard“ markdown way of referencing images (as you wrote below) works for local Jekyll builds, but fails for gh_pages builds, to be both local & gh_pages compliant you afaik have to prepend {{ baseurl }} with the image path… We’ll write up some documentation for it and make it a PR for your theme… (In case you’re interested - a preview/draft of my site is currently online at https://arc42.github.io/faq/home/ <https://arc42.github.io/faq/home/>, best, Gernot

…

Am 13.12.2016 um 01:36 schrieb Takashi Kanemoto ***@***.*** ***@***.***>>: @gernotstarke <https://github.com/gernotstarke> Thanks for using. You can use /assets/img/ <https://github.com/ttskch/jekyll-ttskch-theme/tree/master/assets/img> dir for putting your own images. For example, <https://cloud.githubusercontent.com/assets/4360663/21122709/3b928abe-c117-11e6-976d-6e334bfaa2b7.png> This change shows the specified image correctly like below. <https://cloud.githubusercontent.com/assets/4360663/21122738/612fa02c-c117-11e6-909f-82fb6f0bdcc8.png> I hope this helps you. Thanks. — You are receiving this because you were mentioned. Reply to this email directly, view it on GitHub <#27 (comment)>, or mute the thread <https://github.com/notifications/unsubscribe-auth/ABLURuk_Yl83R1fTfRG3KPsC59aZDakrks5rHeiAgaJpZM4LGnPg>. <https://cloud.githubusercontent.com/assets/143418/17495839/a5054eac-5d88-11e6-95fc-7290892c7bb5.png> <https://cloud.githubusercontent.com/assets/143418/15842166/7c72db34-2c0b-11e6-9aed-b52498112777.png> <https://github.com/ttskch/jekyll-ttskch-theme> <https://github.com/ttskch/jekyll-ttskch-theme/tree/master/assets/img> <https://cloud.githubusercontent.com/assets/4360663/21122709/3b928abe-c117-11e6-976d-6e334bfaa2b7.png> <https://cloud.githubusercontent.com/assets/4360663/21122738/612fa02c-c117-11e6-909f-82fb6f0bdcc8.png> <#27 (comment)>

[ttskch]

@gernotstarke So sorry for my late response 🙇

And I belatedly realized that relative path like assets/img/ogp.png works well in a limited situation. It works well only when the jekyll site is located immediately below the domain top (iow, url of the site is like http://xxx.github.io/ or http://localhost:4000/) and the page using the relative reference is the top page (iow, url of the page isn't http://xxx.github.io/some-posts/ but just http://xxx.github.io/).

So you have to use absolute path every time. In this case, I think you have to do below:

1. If your site has some baseurl (iow, url is like http://xxx.github.io/site-name/)
   • Write markdown like ![](/site-name/assets/img/ogp.png)
2. If your site has no baseurl (iow, url is like http://xxx.gihutb.io/)
   • Write markdown like ![](/assets/img/ogp.png)

Thanks.