{"repo":"snapsynapse/substack2md","free":true,"listed":false,"github":"https://github.com/snapsynapse/substack2md","clone":"git clone https://github.com/snapsynapse/substack2md.git","description":"Convert Substack posts to clean, Obsidian-friendly Markdown using your authenticated browser session.","language":"Python","stars":23,"topics":["cdp","chrome-devtools-protocol","knowledge-management","markdown","newsletter","note-taking","obsidian","python","scraper","substack"],"license":"MIT","category":"scrapers-browser-automation","readme_excerpt":"substack2md Convert Substack posts to clean, Obsidian-friendly Markdown using your authenticated browser session. Why This Exists Substack doesn't let you bulk-export your reading list or subscriptions in a useful format. This tool: - Uses your logged-in browser via Chrome DevTools Protocol (CDP) - Preserves frontmatter metadata - Converts images/embeds to links (Obsidian-friendly) - Rewrites cross-references as wikilinks [[YYYY-MM-DD-slug]] - Organizes by publication into folders Features - No password management - Uses your live browser session - Batch processing - Single URLs or text files with multiple URLs - Sequential with delays - Configurable sleep between requests to be polite - Obsidian wikilinks - Auto-converts internal links to existing notes - Configurable naming - Map publication slugs to custom directory names - Transcript cleaning - Strips timestamps and speaker labels from podcast transcripts - Paywall detection - Optionally tags posts as free or subscriber-only via Substack's public API, so you can avoid accidentally sharing paid content Installation Homebrew (macOS and Linux): Or from source: AI-Assisted Installation This repo includes a GuideCheck Human-Verifiable Assistant Guide for bounded AI-assisted local install: - https://substack2md.space/.well-known/assistant-guide.txt - .well-known/assistant-guide.txt - assistant-guide.txt - assistant-guide-manifest.txt The guide is written for GuideCheck profile 0.3.0 and currently verifies at Level 3. The Pages ","default_branch":null,"files":null,"tree":[],"storefront":"/r/snapsynapse","claimed":false,"request_supported":{"post":"https://gitbuyer.com/r/snapsynapse/substack2md/request-supported","requests":0},"note":"indexed from public GitHub; nothing is for sale on this page. Clone it from GitHub. Paid listings live at /search."}