My Workflow
My Workflow
Writing
I write the notes using VNote. After comparing some note taking apps (Obsidian, Zettlr, etc.), I choose it for some reasons:
- markdown-it support
- markdown with Mathjax plug-in
- it can be hosted in Github Pages easily with Viki.
Hosting
My personal wiki is available in three static host:
- at Netlify using Gatsby Starter Bee, because:
- it supports markdown files and folder structures
- it is integrated with GitHub
- it has RSS feed
- it is fast
- at Gitbook Site using Gitbook, because:
- it supports markdown files and folder structures
- it is integrated with GitHub
- it supports full text search
- at GitHub Pages using Viki, because:
- it supports markdown files and folder structures
- it is integrated with GitHub
- it supports VNote structure
Syncing
So, I need to sync the notes to Gitbook and Netlify repository, and I use SyncFolder for Windows 10.
Workflow
So, here are my workflow:
- Write markdown notes using VNote
- Sync all the files and folders with SyncFolder
- Push to Github
- …
- Profit
Problems with Workflow
- Ensure to make consistent format between Gitbook and Gatsby Starter Bee
- index.md in Viki will be displayed as the first page, but it will be displayed as the last page in Gitbook
- readme.md will be displayed as the first page of Gitbook
- No first line texxt in Gitbook. We should start with Header to make Gitbook display the correct Header.
- In Gitbook, you cannot have two Header 1’s or more.
- In Gatsby, you need a title. So if you have both title and Header 1, both will be displayed in Gatsby site.
Feedback
Was this page helpful?
Glad to hear it! Please tell us how we can improve.
Sorry to hear that. Please tell us how we can improve.
Last modified March 6, 2023: update (7eba5da)