I’ve tried unsuccessfully over the years to get Scrivener to generate markdown so that it could truly be the writing tool that I want.
This week I decided to bite the bullet and see what I could do in spite of a manual which is good, but in which I have trouble finding complete explanations.
So far, I’ve figured out how to generate H1 and H2 and H3 headers.
Hyperlinks come out okay.
Images stored locally seem to work okay although I’d like to be able to keep their leading pathnames: copying them is not the behavior I want.
But I cannot figure out how to show images stored on remote servers, something that I almost always do with markdown.
Markdown makes it extremely easy to display remote images.
If I type the markdown into Scrivener, like this
![image from Maker Faire](https://storage.googleapis.com/s3-inbox/zabouti-east-000/server/2016-10-01-Maker-Faire/DSC09700-bw.jpg).
Scrivener messes it up when it generates markdown.
!\[image from Maker Faire\](<https://storage.googleapis.com/s3-inbox/zabouti-east-000/server/2016-10-01-Maker-Faire/DSC09700-bw.jpg>).
Scrivener does not appear to be able to display remote images, much less generate markdown commands for them.
If you want Scrivener to display a remote image, it must first be copied to local storage.
If I insert a local image, say, ~/Dropbox/MyBookFolder/scene_break.jpg, into my document, Scrivener will generate correct markdown:
Unfortunately Scrivener also copies the file to the output folder, thereby losing the original file path, which could be very useful for websites. In other words, this is markdown, but not the markdown I want.
Reading the manual and watching the Scrivener videos, I came upon the idea of placeholders, in particular, this example from §15.7.5 of the manual.
So I tried it:
Output is correct markdown. Almost.
For one thing the image file is copied and not left in its original location. Worse, the file extension, .jpg, is removed. This kind of markdown doesn’t work as far as I can tell.
Finally, I tried a placeholder to a remote image:
No markdown was generated at all!!!
I NEED GOOD, CLEAR HELP
If Scrivener can generate simple markdown of the type I’d like to see, please, someone tell me how. Tell me clearly, preferably with a video. In fact, tell me how you would get Scrivener to generate the following markdown:
[code]# Header Number 1
This is a paragraph inside the first header.
This is bold.
This is italics.
Scrivener is made by Litterature and Latte.
It looks like this:
Marked 2 renders this markdown correctly: