About itzpapa

What is itzpapa

A blog template that lets you publish Markdown articles written in Obsidian directly as a website. You can use Obsidian-specific syntax like WikiLinks and Callouts as-is, allowing you to run a blog without changing your writing environment.

Origin of the Name

Itzpapalotl
Itzpapalotl

Named after the goddess from Aztec mythology. In Nahuatl, it means "Obsidian Butterfly" - combining "ītztli" (obsidian) and "pāpālotl" (butterfly).

The transformation from local writing environment to web publication. We liken this conversion to "a butterfly born from obsidian."

Features

🔗

Obsidian Compatible

Supports major Obsidian syntax including WikiLinks, Callouts, hierarchical tags, and mark highlights.

⚡

Fast Loading

Generates lightweight pages with minimal JavaScript through Astro static site generation.

📱

Responsive

Comfortable viewing on any device - PC, tablet, or smartphone.

Tech Stack

  • Astro v5Static site generation framework
  • TypeScriptType-safe development environment
  • Remark PluginsObsidian syntax conversion
  • CSS VariablesFlexible theme customization

Getting Started

  1. 1 Clone the repository from GitHub
  2. 2 Place articles in src/content/blog/
  3. 3 Build with npm run build
  4. 4 Deploy to your preferred hosting service