I am using Markdown Monster to create user docs on a Windows machine. they are deployed on a Ubuntu machine running Docsify. The image links break when deployed. The folder structure on both machines is
docs/Topic1/Images
docs/Topic2/Images
there are files
docs/Topic1/topic1.md
docs/Topic1/Images/topic1img.jpg
docs/Topic2/topic2.md
docs/Topic2/Images/topic2img.jpg
in Markdown Monster, the code src="Images/topic1img.jpg" or src="./Images/topic1img.jpg" works.
in Docsify, I need to use the code src="Topic1/Images/topic1img.jpg" This does not preview correctly in Markdown Moster.
I have tried setting relative path in Docsify but no joy. Is there a way to use the same code and see the same preview in Markdown Monster on Windows that I would see on Docsify/Ubuntu?
Not sure I fully understand, but I think what you want is a base path for your 'project' that provides the same root as your live site does. What this does is resolve / or ~/ in the previewer to the path you specify or 'mark' with a marker file.
There are two ways to do this:
- Using a Yaml document header or Project value
- Use a marker file in the root folder
Generally the marker file is the easier way to do this and I typically do this. So I copy a .markdownmonster file into the root folder and that resolves the / path to the path when previewing. You can now reference things based on the root of the site in the same way that the live site does bringing the two into sync.
You can find more info on how to configure a root base path here:
A related thing: I've created a documentation tool that is designed specifically for creating cross linked Markdown based documentation. It uses most of MM's editor features along with the project management features and dedicated cross-linking support and many other documentation specific features.
It generates ready to run static Web sites that can be hosted anywhere.
Still in beta, but I've been using it for all of my doc sites for about 3 months now.
+++ Rick ---