--- title: "github-markdown-toc vs blog-post-workflow" type: "comparison" canonical_url: "https://www.graphcanon.com/compare/ekalinin-github-markdown-toc-vs-gautamkrishnar-blog-post-workflow" tools: ["ekalinin-github-markdown-toc", "gautamkrishnar-blog-post-workflow"] --- # github-markdown-toc vs blog-post-workflow *GraphCanon updated Aug 10, 2026* ## Verdict Pick github-markdown-toc if github-markdown-toc is a shell-based tool to create table of contents for Markdown files on GitHub without requiring additional software installation; pick blog-post-workflow if automate GitHub profile README updates with RSS feeds using the blog-post-workflow tool. [github-markdown-toc](https://github.com/ekalinin/github-markdown-toc) reports 3.3k GitHub stars, 2.7k forks, and 24 open issues, last pushed Oct 12, 2024. [blog-post-workflow](https://github.com/marketplace/actions/blog-post-workflow) has 3.4k stars, 290 forks, and 0 open issues, last pushed Aug 10, 2026. Figures are from public GitHub metadata via [github-markdown-toc's repository](https://github.com/ekalinin/github-markdown-toc) and [blog-post-workflow's repository](https://github.com/gautamkrishnar/blog-post-workflow). | | [github-markdown-toc](/tools/ekalinin-github-markdown-toc.md) | [blog-post-workflow](/tools/gautamkrishnar-blog-post-workflow.md) | | --- | --- | --- | | Tagline | Tool for generating Table of Contents for Markdown files | Automate blog post updates on GitHub profiles using RSS feeds | | Stars | 3,294 | 3,438 | | Forks | 2,686 | 290 | | Open issues | 24 | 0 | | Language | Shell | JavaScript | | Adopt for | github-markdown-toc is a shell-based tool to create table of contents for Markdown files on GitHub without requiring additional software installation. | Automate GitHub profile README updates with RSS feeds using the blog-post-workflow tool. | | Persona | - | - | | Runtime | - | - | | License | MIT | AGPL-3.0 | | Categories | Developer Tools | Developer Tools | ## Trust and health _Sourced signals - not a safety guarantee. No winner column._ | | [github-markdown-toc](/tools/ekalinin-github-markdown-toc.md) | [blog-post-workflow](/tools/gautamkrishnar-blog-post-workflow.md) | | --- | --- | --- | | Maintenance | Dormant (18%) | Very active (96%) | | Days since push | 657d | 0d | | Open issues (now) | 24 | 0 | | Full report | [trust report](/tools/ekalinin-github-markdown-toc/trust.md) | [trust report](/tools/gautamkrishnar-blog-post-workflow/trust.md) | ## Decision facts: github-markdown-toc - **Adopt for:** github-markdown-toc is a shell-based tool to create table of contents for Markdown files on GitHub without requiring additional software installation. ## Decision facts: blog-post-workflow - **Adopt for:** Automate GitHub profile README updates with RSS feeds using the blog-post-workflow tool. ## Choose when ### Choose github-markdown-toc if… - github-markdown-toc is primarily Shell; blog-post-workflow is JavaScript. - License: github-markdown-toc is MIT, blog-post-workflow is AGPL-3.0. - Tags unique to github-markdown-toc: github, markdown, shell, table-of-contents. - github-markdown-toc ships Docker support for self-hosted deployment. - For users looking to generate a TOC from local or remote Markdown files, including README.md and wiki pages, in environments where installing software is either not allowed or unnecessary. ### Choose blog-post-workflow if… - blog-post-workflow is primarily JavaScript; github-markdown-toc is Shell. - License: blog-post-workflow is AGPL-3.0, github-markdown-toc is MIT. - Tags unique to blog-post-workflow: blog-posts, github-actions, rss-feeds. - You have multiple sources of blog content you wish to consolidate on your GitHub profile for easy visibility. ## When NOT to use github-markdown-toc - In Windows environments since it relies on shell scripting, although a Go-based alternative exists for more reliable cross-platform use. - For projects requiring advanced features such as parallel processing, which are supported by competitors written in languages better suited for these tasks. ## When NOT to use blog-post-workflow - Your blogging frequency does not require daily updates; if monthly summaries suffice for your needs. - You already have an established complex automation setup that would be difficult to integrate with this tool. ## Common questions ### What is the difference between github-markdown-toc and blog-post-workflow? github-markdown-toc: Tool for generating Table of Contents for Markdown files. blog-post-workflow: Automate blog post updates on GitHub profiles using RSS feeds. See the comparison table for live GitHub stats and shared categories. ### When should I choose github-markdown-toc over blog-post-workflow? Choose github-markdown-toc over blog-post-workflow when github-markdown-toc is primarily Shell; blog-post-workflow is JavaScript; License: github-markdown-toc is MIT, blog-post-workflow is AGPL-3.0; Tags unique to github-markdown-toc: github, markdown, shell, table-of-contents; github-markdown-toc ships Docker support for self-hosted deployment; For users looking to generate a TOC from local or remote Markdown files, including README.md and wiki pages, in environments where installing software is either not allowed or unnecessary. ### When should I choose blog-post-workflow over github-markdown-toc? Choose blog-post-workflow over github-markdown-toc when blog-post-workflow is primarily JavaScript; github-markdown-toc is Shell; License: blog-post-workflow is AGPL-3.0, github-markdown-toc is MIT; Tags unique to blog-post-workflow: blog-posts, github-actions, rss-feeds; You have multiple sources of blog content you wish to consolidate on your GitHub profile for easy visibility. ### When should I avoid github-markdown-toc? In Windows environments since it relies on shell scripting, although a Go-based alternative exists for more reliable cross-platform use. For projects requiring advanced features such as parallel processing, which are supported by competitors written in languages better suited for these tasks. ### When should I avoid blog-post-workflow? Your blogging frequency does not require daily updates; if monthly summaries suffice for your needs. You already have an established complex automation setup that would be difficult to integrate with this tool. ### Is github-markdown-toc or blog-post-workflow more popular on GitHub? blog-post-workflow has more GitHub stars (3,438 vs 3,294). Stars measure visibility, not whether either tool fits your constraints. ### Are github-markdown-toc and blog-post-workflow open source? Yes - both are open-source projects on GitHub (github-markdown-toc: MIT, blog-post-workflow: AGPL-3.0). ### Where can I find alternatives to github-markdown-toc or blog-post-workflow? GraphCanon lists graph-backed alternatives at [github-markdown-toc alternatives](/tools/ekalinin-github-markdown-toc/alternatives) and [blog-post-workflow alternatives](/tools/gautamkrishnar-blog-post-workflow/alternatives) ([github-markdown-toc markdown twin](/tools/ekalinin-github-markdown-toc/alternatives.md), [blog-post-workflow markdown twin](/tools/gautamkrishnar-blog-post-workflow/alternatives.md)), ranked by typed relationship edges rather than popularity votes. ### Is there a machine-readable version of this comparison? Yes. The markdown twin at [this comparison](/compare/ekalinin-github-markdown-toc-vs-gautamkrishnar-blog-post-workflow.md) mirrors this page for agents and LLM crawlers, with the same stats table and FAQ answers. ### Which is better maintained, github-markdown-toc or blog-post-workflow? github-markdown-toc: Dormant. blog-post-workflow: Very active. Compare maintenance labels, days since push, and release cadence in the trust section below - stars alone do not measure maintenance. ### Where are the full trust reports for github-markdown-toc and blog-post-workflow? GraphCanon publishes per-repo trust reports with dated maintenance, provenance, and scan summaries: [github-markdown-toc trust report](/tools/ekalinin-github-markdown-toc/trust); [blog-post-workflow trust report](/tools/gautamkrishnar-blog-post-workflow/trust). --- **Machine-readable endpoints** - JSON: [`/api/graphcanon/graph?tool=ekalinin-github-markdown-toc`](/api/graphcanon/graph?tool=ekalinin-github-markdown-toc) - LLM index: [/llms.txt](/llms.txt) - Full corpus: [/llms-full.txt](/llms-full.txt) _GraphCanon - The knowledge graph for AI development. https://www.graphcanon.com/_