A record of migrating from Jekyll to Astro. We share the entire process of building a blog with Astro, including installation, i18n, SEO, and image optimization.
[Astro] Troubleshooting and Tips
2026-04-05
Sharing the problems encountered and their solutions, along with useful tips, during the migration from Jekyll to Astro. Covers mobile scroll issues, Sass warnings, code highlighting, and more.
Sharing how we implemented a script to automatically share blog posts to social media platforms including Facebook, LinkedIn, Threads, Bluesky, and Mastodon.
Sharing the layout and component structure of an Astro blog. Covers the design of core components such as BaseLayout, PostLayout, Navbar, Footer, and dynamic routing.
Sharing how to implement static search functionality using Pagefind in an Astro blog. Covers build integration, multilingual search, category filtering, and more.
Sharing how to integrate Google AdSense ads into an Astro blog. Covers ad component setup, inserting ads within markdown using a custom rehype-in-feed-ads plugin, and more.
Sharing how to integrate the Utterances comment system into an Astro blog. Covers implementing a lightweight comment system based on GitHub Issues and usage in PostLayout.
Sharing how to implement a custom rehype plugin that automatically converts markdown images to AVIF/WebP in Astro. Covers image conversion with Sharp, caching, lazy loading, and more.
Sharing how to implement SEO (Search Engine Optimization) in an Astro blog. Covers meta tags, Open Graph, JSON-LD structured data, sitemaps, RSS, Google Analytics, and more.
Sharing how to implement a multilingual system supporting Japanese, Korean, and English in Astro. Covers URL-based routing, translation system, dynamic routing, and more.
Sharing how to install Astro and set up a blog project. Covers astro.config.mjs configuration, directory structure, SCSS setup, build scripts, and more.