Images

Hey, if I refer an image ![](./photo.jpg) from markdown and add the image into the folder, jdown tries to parse the image (I think). It would be good to exclude extensions or to only include .md. Also it would be great to find a solution to include those images into the public dist folder of react-static, but I 'm not sure this is the right place to discuss about this.

[DanWebb]

Hey @bkniffler I’ve been working on this feature, you can see progress so far in the images branch of this repo https://github.com/DanWebb/jdown/tree/images

I’ve still got some test cases to write/run but it’s nearly there. It’d be a massive help if you could have a quick review and let me know your thoughts and if it looks like it suits what you were looking for.

Essentially, images/ sub-directories can be added in any of the contents folders (take a look at /example/content) then the images can be referenced from the md files using ./images/image.png. It’s possible to set an output directory as well as a base path and some minification in the options like:

jdown('example/content', {
  asset: {
    output: './your/static/file/directory',
    path: '/public' // images src will end up as path + imagename.ext
    png: {quality: '65-80'} // passed to imagemin
  }
})

The image files get run through imagemin and have an mtime (last modified time) timestamp appended to their file names for cache busting.

It’s currently possible to place an images folder in the top contents directory and then reference the images from that folder in subfolder md files like:

- images/
  | - image.png
- collections/
  | - blog/
  |   | - post.md <-- can use ./images/image.png

This wasn’t intended but I don’t mind it, as some people might just want a single image folder. However, I think if an images folder was placed inside collections/blog folder that contained a file called image.png it should overwrite it.

This is backwards compatible so the images directories and asset options are completely optional.

[DanWebb]

I’m going to close this issue as the latest version of jdown 0.6.4 contains the feature 🚀

Check the assets section of the readme for more details.