HexoのPostに画像を置く

_config.ymlの設定

_config.ymlの中のpost_asset_folderをtrueにする。

post_asset_folder: true

記事作成

上の設定がされていると、記事作成時に.mdと同時にフォルダも作成されるので、そこに画像などの静的ファイルを配置する。例えば$ hexo new sample-postをすると、sample-post.mdと同一の階層にsample-postフォルダが作成される。

記事に配置するコード

フォルダを参照するためのコードを記事に設置することで、フォルダ内の静的ファイルを参照できる。Markdownなのでリンクのパス部分のみ置き換えなのかと思ったら、コードの設置のみで良いらしい。

// これは正しく実行されない
![example image]({% asset_img example.png %})

// 画像が出力される
{% asset_img example.png %}

// テキストリンクが出力される
{% asset_link example.png 'サンプル' %}

// パスがテキストで出力される
{% asset_link example.pdf 'サンプルpdf' %}