CLI tool to publish Joplin notes as a static website, currently supports both blog/wiki forms, framework supports hexo/vuepress/docsify.
- Install nodejs and npm(installed by default)
- Knowledge of command line
- Understanding VSCode
- Navigate to the relevant directory at the command line
- Add dependencies
npm i -D joplin-blog.
- add a configuration file
.joplin-blog.json(see configuration for details)
- add an npm script file
"gen": "joplin-blog blog"(if you want to generate a wiki then
"gen": "joplin-blog wiki")
- Run the command
npm run gen
- Then you can see that the relevant directory already contains the notes and attached resources
Please add two files .joplin-blog.json and .joplin-cache.json to the .gitignore ignore file, the former contains sensitive information
token, the latter is automatically generated.
The supported frameworks have examples in the examples directory, which you can clone locally to see.
||yes||type of integrated blog|
||no||hexo/vuepress directory, default is
||yes||token for joplin web clipper|
||no||base path of joplin web clipper, default is
||yes||joplin's blog tag|
||Topped note id (only valid under fluid topic)|
I've shared over 190 notes with this tool, blog address (Chinese)
What does token/port refer to and where can I find it?
You can usually see it in Tools > Options > Web Clipper
Why did the note id of the exported blog, wiki change?
Some possible reasons are
- Export jex and then import jex, all notes here are created operations, refer to: https://discourse.joplinapp.org/t/when-will-joplin-modify-the-id-of-the-note/17806
- Notes conflict when syncing