I figured out the multiple --image tag shortly after posting my question. The reason I set it to c:\jsduck\content is because that's the root folder, so I would specify images\image.png and guides\guide\image.png, etc., for the images. I suppose I can specify two --image options, one for c:\jsduck\images and one for c:\jsduck\guides, as long as I don't place image files directly in the guides folder, as this could potentially run the risk of two images with the same name getting copied to the same place, right?

Whenever I try to specify the --img tag, I get an error saying '< was unexpected at this time'. I've tried every permutation of specifying quotes that I could think of, even tried it without the quotes, and had no success. I want to add the title attribute to the image tag. I get the same error when I copy and paste the example you provided.

Code:

jsduck --img '<p><img src="%u" alt="%a"></p>'

One unrelated question:
For the meta-tags option, not knowing Ruby or its naming conventions, do I have to name a Ruby class file to be the same as its class name? I played briefly with a simple example and it seemed to be ignoring it, so I didn't pursue it any further.

as long as I don't place image files directly in the guides folder, as this could potentially run the risk of two images with the same name getting copied to the same place, right?

Right. That's again one of the things to improve.

As for the --img option, I guess Windows doesn't support single quotes, have you tried reversing the single and double quotes? You might also attempt to use the windows escape character ^, but I guess you would end up escaping way too many things.

Ruby doesn't care how your files are named, but the convention is to place SomeCoolClass into either some_cool_class.rb or somecoolclass.rb - I find the first one more readable.

I now specify --images=c:\jsduck\content\images --images=c:\jsduck\content\guides, but if I do this to pick up an image from the images folder:

Code:

{@img image.png}

It creates a URL relative to where the markdown file for the guide is, so I get a broken image. Therefore, I have to specify --images=c:\jsduck\content as the root, so I can reference {@img images/image.png} in the guide. But then that doesn't work, either, because {@img} is creating a URL that is relative to where the markdown file lives (though it is odd that if I specify {@img guides/guide/image.png} it works).

I am completely unable to get an image to appear from the c:\jsduck\content\images folder from within a guide using the {@img} syntax in a guide, but it works from doc-comments. I guess that is OK if the convention is to keep all images relevant to a guide in with the guide folder, but it does make it tricky to pull up a common image.

As for the markdown syntax, I have to specify ![Alt text](images/image.png), which seems inconsistent with {@img image.png} to retrieve the same image. I get confused as to why I have to specify images/images/image.png if I simply name c:\jsduck\content\images as the root, but I don't have to specify images/guides/guide/image.png. There seems to be some logic in there somewhere muddying the water, or some concept I'm missing.