GitHub Blogger is a VS Code extension that lets you create and manage blog posts with GitHub Issues. Enjoy Markdown editing, preview, and seamless publishing—all powered by GitHub.
- Manage and publish blog posts via GitHub Issues.
- GitHub-like interaction experience.
- Markdown editing with real-time preview and plugins (Math, Mermaid, etc.).
- Automatic image upload and CDN acceleration via jsDelivr.
- All your posts and images are stored in your repository.
- Install from the VS Code Marketplace.
- Prepare your GitHub Personal Access Token.
- Open the command palette (
Command + Shift + P
on macOS,Ctrl + Shift + P
on Windows/Linux), typeConfig GitHub Blogger
to set up. - Open the command palette again, type
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"
}
- Your blog repository must be public for image CDN acceleration to work (details).
- You can use an existing repository or create a new one.
- Posts and images are stored in the
archives
andimages
directories. The branch is set bygithub-blogger.branch
. Usually, the default branch is sufficient. Make sure this branch exists, or archiving and image uploads may fail.
This project is inspired by and built upon the work of the open-source community, including but not limited to:
- Aaronphy/Blogger – Project inspiration
- @octokit/core – GitHub API toolkit
- @primer/react – GitHub's official UI components
- @tomjs/vite-plugin-vscode – VSCode extension tooling
- bytemd – Markdown editor
- jsDelivr – Free CDN service
- github-issue-toc: Generate a table of contents for GitHub Issues
MIT