remark-tweet-card

Embed beautiful tweet cards in Markdown & MDX

Demo · English Docs · 中文文档

Features

• No API key needed — Uses Twitter's public syndication API
• Build-time rendering — Perfect for SSG/SSR projects like Astro
• Full tweet card — Avatar, body, media, quoted tweets, engagement metrics, and more

Installation

npm install remark-tweet-card

Usage

Use the following syntax in your Markdown / MDX files:

[$tweet](1654079444816936969)

Or with a full URL:

[$tweet](https://x.com/github/status/1654079444816936969)

After building, each tweet is rendered as a full card including avatar, body, media, quoted tweets, engagement metrics, and more.

Credits

This project is inspired by react-tweet. The vast majority of the code was written by DeepSeek V4 Pro and Claude Sonnet 4.6, with all code reviewed by a human (me).