shd101wyy / vscode-markdown-preview-enhanced

One of the "BEST" markdown preview extensions for Visual Studio Code
https://shd101wyy.github.io/markdown-preview-enhanced
Other
1.46k stars 173 forks source link

Please support Hugo/mkdocs #1315

Open parthi2929 opened 5 years ago

parthi2929 commented 5 years ago

Hi

I very much love this extension and want to use it for my day to day documentation. For single file documentations it works fine. But for multiple docs, I am using mkdocs and also trying hugo. I could not find a way to integrate this workflow in hugo or mkdocs. Can you please share a tutorial or provide hugo/mkdocs/docsify plugin support so we could directly use the md files there?

I find this support to any static gen would be greatly appreciated, as many people might want to do multiple files organized in the form of mkdocs or similar documentation setup. I see you have used docsify for the documentation of this plugin, so you could see the benefit I hope :)

matchavez commented 5 years ago

In short, you'll find some very interesting OS level tricks to make this a reality. There are some more elegant ways, most specifically to use multimarkdown transclusions. However, by doing it via scripting, the guy I wrote this for is now using the .bat to inject text based on whether the build has uncommitted checkins on the git repo and then writes a warning into the document to say you need to catch up. Lots of interesting possibilities if you script...