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.
