Convert Pmwiki pages to markdown files.
- Install Pmwikilib, which is a Python2 package that parse Pmwiki metadata into plain text (with the synytax).
- Run converter.rb to convert the plain text from last step into markdown file.
Currently the simple script handles only partially the features included in the Pmwiki, including:
- basic styles: bold, italics, ordered/unordered list, different level of heading.
- plain table or table directives, note navigation bar is not supported.
- links to external website, assets, images, other pages or anchors within the same page.
The development of Pmwiki is unclear, and the last update was back in 2022. Time to move on to something more modern! The script is written in Ruby because the plan was to convert Pmwiki and host the markdowns with Jekyll, which is written in Ruby, so everything can be managed nicely within the Ruby ecosystem.
The next step would be to integrate Pmwikilib
and the converter script so it is easier to add features.
- parse more metadata: creation time, author, last modified time, etc.
- better handling of page title, file structure, etc.