O2 - Write Once, Convert to Multiple Platforms
O2 is an Obsidian plugin that allows you to convert your Obsidian Markdown files to other Markdown platforms such as Jekyll or Docusaurus. The name "O2" represents the idea of "Obsidian to Other platforms".
Features
- Convert Obsidian Markdown to Jekyll (Chirpy theme) format
- Convert Obsidian Markdown to Docusaurus format
- Automatic archiving of processed files
- Customizable folder structure
- Preserves frontmatter and metadata
- Handles attachments and images
Prerequisites
Vault Structure
Your Obsidian vault should have the following folder structure (folder names can be customized in settings):
Your vault
├── ready (where the notes you want to convert are placed)
├── archive (where the original notes before converting are placed)
└── attachments (where the attachments are placed)
Other folders in your vault will be ignored during the conversion process.
How to Use
- Move the notes you want to convert to the
ready
folder - Open Obsidian's command palette using
cmd + p
(macOS) orctrl + p
(Windows/Linux) - Search for and execute the command
O2: Grammar Transformation
- Your files will be converted according to your settings
Recommended Plugins
O2 works well with the following Obsidian plugins:
- imgur: Recommended for image handling
- Update frontmatter time on edit: Helps maintain accurate timestamps
Platform Support
Currently, O2 supports conversion to:
- Jekyll (Chirpy theme)
- Docusaurus
Each platform has its own specific settings and configurations that can be customized according to your needs.
Contributing
We welcome contributions to O2! If you'd like to contribute:
- For major changes, please open an issue or discussion first
- Fork the repository and create your feature branch
- Make your changes and ensure tests pass
- Submit a pull request
For detailed information about building and developing O2, please visit Obsidian Plugin Development Documentation.
Support
If you find O2 helpful and would like to support its development:
License
O2 is published under the MIT License.