- market: https://marketplace.visualstudio.com/items?itemName=dzylikecode.docsify-preview
- online docs: https://dzylikecode.github.io/VSCodeExt-docsify-Preview/#/
Docsify is a magical documentation site generator. What the plugin does is help you see the preview of your markdown file when writing it so that you can get better feedback. What you see is what you get.
-
preview Docsify in the sidebar
-
auto scroll when markdown file scrolled
-
auto jump to the corresponding position when opening a markdown file
-
auto-reload when the markdown file saved
-
context menu
If you are interested in my Docsify template, welcome to visit my Docsify-template, which supports mindmap, math formula, mermaid, jsRunkit, and so on.
If you want to paste images in markdown, welcome to use my other plugin:md-paste-enhanced.
If you like this plugin, please give me a star. Thanks!
-
docsifyPreview.port
Set the port of the server
- the default value is
10812
- the default value is
-
docsifyPreview.indexFile
Set the path of your custom
index.html
To change the path, use
/
refer to the relative path from the workspace.-
Example:
/index.html
-
the default value is
/docs/index.html
-
I have fixed all the issues I met. If you find any issues, please report them to issue
The scroll will be in the wrong position when you save the markdown file if the current markdown file can't be found in the sidebar. I find the reason is that Docsify won't execute the function hook.ready
if the Markdown file is not in the sidebar. So you'd better add the markdown file to the sidebar first before writing the Markdown file with joy.
-
fix:
-
open in browser
it will open the wrong link if you change the page in the preview
-
the title doesn't respond when you change the page in the preview
-
-
refactor code
🎉 🎉 🎉
-
fix: the scroll position will be put at the wrong position when opening the
Docsify Preview
the first time -
change: use the context menu to open the preview in a browser instead of right-clicking
-
add: the button "go here" in the context menu
If you click the button, the VSCode will open the corresponding markdown and scroll to the same position.
-
fix: the state of whether the sidebar is closed will be reset if you reload the window
@paulhibbitts
fix: An annoying bug is that you have to drag the next markdown to the sidebar to see the preview.
change the label of the menu to "Show Docsify preview to the side"
Thanks to @paulhibbitts
feature: right-click the preview will open the preview in the default browser
feature: add input box if the configuration is not correct
congratulations!
- scroll sync
- reload automatically when saving markdown
- jump to the corresponding link automatically when switching the markdown
I'm a student from China and I sacrificed the entire National Day holiday to write this plugin(Not only that, but I also overdrawn five days of study😰). If you like this plugin, please give me a star. If you want to buy me a coffee, scan the QR code below. Thanks! 😝 😝 😝
PayPal | WeChat Pay | Alipay |
---|---|---|
dzylikecode |
Thank you very much!!!
@paulhibbitts