Using Images with the RapidWeaver Markdown plugin

In a recent comment by Gernot on my blog I was asked how to add images to MardownPages created with my RapidWeaver Markdown Plugin. It turned out, that this is pretty simple, although there are some catches to it. Hence, I will share the following recipe with you:

  • add a new page of type Markdown to RapidWeaver
  • bring up the Page Inspector with ⌘I
  • add the images to would like to reference in your Markdown document as page assets by using the "Add file" command in the Advanced tab of the Page inspector.
  • now you may add the image in your Markdown document like this: An image is added like this: ![a nice image](assets/my_image.jpg)

Please note that all images are stored in an assets directory relative to the Markdown page. Further, the filename of the image is given by the name of the file that has been uploaded in the page inspector. Renaming the file by specifying a different name in the Page Inspector does not work. Maybe this is a bug of the current version of RapidWeaver (3.5.1 at the time of writing).

Written March 15th, 2007