This plugin allows you to sync your Obsidian notes with Hugo, a popular static site generator. It converts Obsidian-style markdown and frontmatter to Hugo-compatible format.
- Sync selected files from Obsidian to Hugo
- Convert Obsidian tags to Hugo tags
- Filter out specified headers and their content
- Customizable Hugo content path
- Open Obsidian Settings
- Navigate to Community Plugins and disable Safe Mode
- Click on Browse and search for "Hugo Sync"
- Install the plugin and enable it
- Open the plugin settings
- Set the Hugo Path: This is the root directory of your Hugo project
- Set the Content Path: This is the subdirectory where your Hugo content is stored (default is 'content/posts')
- Set Filtered Headers: Enter any headers you want to exclude from the Hugo output, one per line
- Select one or more files in the Obsidian file explorer
- Click the "Sync to Hugo" icon in the left ribbon, or use the command "Sync selected file(s) to Hugo"
- The selected files will be converted and copied to your Hugo content directory
- Obsidian tags are automatically converted to Hugo tags
- Tags can be in various formats:
- YAML frontmatter:
tags: [tag1, tag2] - List format:
tags: - tag1 - tag2
- YAML frontmatter:
- Pure symbol tags are ignored
- Headers specified in the "Filtered Headers" setting will be excluded from the Hugo output
- All content under a filtered header, up to the next header of the same or higher level, will also be excluded
If you encounter any issues:
- Check the console log for error messages
- Ensure your Hugo path and content path are set correctly
- Verify that your Obsidian tags are in a supported format
- Make sure filtered headers are entered correctly in the settings
If you need help or want to report a bug, please open an issue on the GitHub repository.
Contributions are welcome! Please feel free to submit a Pull Request.