Repolode
gautamkrishnar

gautamkrishnar/blog-post-workflow

A GitHub Action that pulls your latest blog posts from RSS feeds into your profile or project README on a schedule.

Stars
3,449
Forks
291
Open issues
1
Last commit
13 days ago

What is it?

Blog Post Workflow is a GitHub Action that keeps a list of recent posts in a README up to date. You add a placeholder comment to your README, point the workflow at one or more RSS feed URLs, and it replaces the placeholder with a generated list of your latest articles. It runs on a cron schedule or can be triggered manually from the Actions page.

The list can be customized heavily. You control the maximum number of posts, sorting and ordering, and the output format through a template that supports variables such as title, URL, description, date, category, counter, and feed name. Titles and descriptions can be trimmed, and StackOverflow and StackExchange comment entries can be filtered out. Multiple readme files can be updated in one run.

The workflow is configured through a YAML file in the .github/workflows folder, and the README documents the full list of options. It is aimed at developers who want their GitHub profile to show their writing or activity without updating it by hand.

Key features

  • 01Pulls posts from any RSS feed, including blogs, StackOverflow activity and YouTube channels.
  • 02Runs on a daily, weekly or monthly cron schedule or manually via workflow_dispatch.
  • 03Customizable output through a template with variables for title, URL, date, description and category.
  • 04Sorts posts by publish date, with ascending or descending order.
  • 05Can trim titles and descriptions and filter out StackOverflow or StackExchange comments.
  • 06Can update multiple README files in a single run.

Use cases

  • Showing your latest blog posts on your GitHub profile README.
  • Listing recent articles or release notes in a project's README.
  • Displaying your recent StackOverflow answers or YouTube videos on a profile page.

Quick start

  1. 1

    Add the BLOG-POST-LIST markers to your README.md

  2. 2

    Create .github/workflows/blog-post-workflow.yml with the sample workflow and your feed_list

  3. 3

    In repo settings, under Actions > General, set Workflow permissions to Read and write

  4. 4

    Run the workflow manually from the Actions page or wait for the daily schedule

Things to know

  • Licensed under AGPL-3.0, a strong copyleft license that may restrict some reuse.

Topics

FAQ

What is blog-post-workflow?
A GitHub Action that pulls your latest blog posts from RSS feeds into your profile or project README on a schedule. Blog Post Workflow is a GitHub Action that keeps a list of recent posts in a README up to date. You add a placeholder comment to your README, point the workflow at one or more RSS feed URLs, and it replaces the placeholder with a generated list of your latest articles. It runs on a cron schedule or can be triggered manually from the Actions page.
Is blog-post-workflow free to use? What license does it have?
blog-post-workflow is open source under the AGPL-3.0 license. Check the license terms before using it in commercial products.
Is blog-post-workflow still maintained?
Actively maintained. The last commit to blog-post-workflow was on Oct 7, 2026.
What can I use blog-post-workflow for?
Showing your latest blog posts on your GitHub profile README. Listing recent articles or release notes in a project's README. Displaying your recent StackOverflow answers or YouTube videos on a profile page.
How do I install blog-post-workflow?
Add the BLOG-POST-LIST markers to your README.md Create .github/workflows/blog-post-workflow.yml with the sample workflow and your feed_list In repo settings, under Actions > General, set Workflow permissions to Read and write Run the workflow manually from the Actions page or wait for the daily schedule
Where can I get blog-post-workflow?
The source code and installation instructions are on GitHub: https://github.com/gautamkrishnar/blog-post-workflow

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects