GitHub Blogger

English | 中文

GitHub Blogger is a VS Code extension for writing and managing blog posts via GitHub Issue. It supports Markdown editing, live preview, and seamless publishing — all powered by GitHub.

✨ Features

• Manage and publish blog posts via GitHub Issue
• GitHub-native interaction experience
• Markdown editing with live preview and plugin support (Math, Mermaid, etc.)
• Images stored in your repository with jsDelivr CDN for display
• All content and edits stored directly in your repository

🚀 Quick Start

1. Install from the VS Code Marketplace or Open VSX
2. Generate your GitHub Personal Access Token (classic)
3. Open the command palette (Cmd + Shift + P / Ctrl + Shift + P), search for Configure GitHub Blogger to set up
4. Then run Open GitHub Blogger and start writing!

Sample configuration:

{
  "github-blogger.token": "your-github-token",
  "github-blogger.user": "your-github-username",
  "github-blogger.repo": "your-github-repo",
  "github-blogger.branch": "main"
}

⚠️ Notes

• Your repository must be public for jsDelivr CDN to work (why)
• You can use any existing repository or create a new one
• Posts and images are saved under archives and images folders
• The working branch is set via github-blogger.branch. Ensure it exists—otherwise archiving and uploads may fail

🙏 Acknowledgements

This project is built upon and inspired by the open-source community, including:

• Aaronphy/Blogger – Project inspiration
• @octokit/core – GitHub's official SDKs
• @primer/react – GitHub's official UI components
• @tomjs/vite-plugin-vscode – VS Code extension tooling
• bytemd – Markdown editor
• jsDelivr – Free CDN service

📷 Screenshots

📚 Related Projects

• github-issue-toc – Generate a table of contents for GitHub Issue

📝 License

MIT