- 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
-
preview: context menu
-
editor: context menu
- docsify: open/close the side preview
- docsify: open the full preview
If you are interested in my Docsify template, welcome to visit my Docsify-template or fork this repo, 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
: numberSet the port of the server
- the default value is
10812
- the default value is
-
docsifyPreview.indexFile
: stringSet 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
-
-
docsifyPreview.followLinkWithCtrl
: booleanSet whether to open the link with
Ctrl
pressed- the default value is
false
- the default value is
Ctrl+Shift+A
: open/close the side previewCtrl+Shift+V
: open the full preview
- full preview (
Ctrl+Shift+V
) => open the markdown from the preview (go Here
) => show the markdown to the side (Ctrl+Shift+A
) - close the full preview (
Ctrl+W
)
You may open the duplicate tab in the browser if clicking the external link.
If you find any issues, please report them to issue
-
refactor the code
-
+:shortcut
ctrl+alt+a
: open/close the side preview -
+:shortcut
ctrl+alt+v
: open the full preview -
follow the link with
ctrl
pressedthis may help you get rid of the annoying popup window if enabled
fixed: failed to open an external link
Now you can open the external link in the preview, and then it will be opened in the browser. But the problem is that you may open the duplicate tab in the browser. I will try to fix it in the future.
-
feature:
-
the context menu of the preview
-
add: close preview
-
right-click the button will trigger the same event as clicking it.
-
-
the context menu of the editor
- add: show Docsify preview to the side
-
-
fix:
prevent the origin context menu when right-clicking the context menu
-
feature:
-
context menu
open develop tools
-
-
fix:
-
need to reload the VSCode if the
index.html
is changednow, you can just reopen the Docsify-Preview to make it work
-
-
change
pretty context menu
fix: issue
see more detail at #11
-
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