epub-hypercard-obsidian

Convert EPUB files into interactive HyperCard Markdown folders for Obsidian.

256|38|Updated Jun 16, 2026
One-click install
npx skills add https://github.com/twhsi/skills --skill epub-hypercard-obsidian
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: epub-hypercard-obsidian
Source: https://github.com/twhsi/skills/tree/main/skills/epub-hypercard-obsidian
Command: npx skills add https://github.com/twhsi/skills --skill epub-hypercard-obsidian

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and assets (resource) components.

What problem does it solve?

This Skill converts EPUB books into interactive HyperCard Markdown folders, enhancing the accessibility and portability of digital literature for Obsidian users.

Core Features & Use Cases

  • EPUB Conversion: Converts EPUB files into a folder structure with individual Markdown files for each card.
  • HyperCard Format: Adapts the converted content to the four-table HyperCard format for easy navigation in Obsidian.
  • Use Case: For users who want to transform EPUBs with various features (chapters, table of contents, index cards, etc.) into an interactive and searchable format within Obsidian.

Quick Start

Run the generator with the following command: python3 scripts/epub_to_hypercard_obsidian.py INPUT.epub --out OUTPUT_DIR --zip

Frequently Asked Questions about epub-hypercard-obsidian

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert an EPUB to Markdown files for Obsidian?

This Skill transforms an EPUB into an interactive HyperCard Markdown folder for Obsidian. It processes chapters, table of contents, index cards, and links into individual Markdown files for easy navigation and search.

What is the HyperCard format in Obsidian?

The HyperCard format is a four-table structure that adapts EPUB content for easy navigation in Obsidian. It converts book chapters and indexes into individual Markdown cards, making digital literature interactive and searchable within your notes.

Do I need Python to convert EPUB files to Obsidian Markdown?

Yes, Python is required to execute the EPUB to HyperCard conversion. You run the generator script via command line using Python3 to process the EPUB input and output the Obsidian-compatible Markdown folder structure.

How do I run the EPUB to Obsidian conversion script?

Run the conversion by executing `python3 scripts/epub_to_hypercard_obsidian.py INPUT.epub --out OUTPUT_DIR --zip` in your terminal. This command processes the EPUB and outputs the Markdown files to a specified directory.

Can I convert EPUBs with complex features like tables of contents and links?

Yes, this EPUB conversion handles various complex features including chapters, tables of contents, index cards, and links. It maps these elements into the HyperCard Markdown format to maintain interactivity within Obsidian.

What do I need to know before converting an EPUB to HyperCard Markdown?

Before converting an EPUB to HyperCard Markdown, you should understand EPUB structure and Markdown syntax. You also need a Python environment to execute the conversion script and generate the Obsidian folder output.