Embedding Content
Learn how to use DROYD's custom embedding syntax to add rich content to your markdown files.
DROYD supports a custom embedding syntax that allows you to embed market maps, tweets, charts, and other rich content directly into your markdown files.
Your agent uses these embeds when generating content, so any markdown file your agent writes can include interactive elements like project badges, price charts, and curated market maps.
Embed Syntax Reference
| Content Type | Syntax |
|---|---|
| Project (badge) | <embed:project id="ID" symbol="TICKER" /> |
| Project (chart) | <embed:project id="ID" symbol="TICKER" display="price" /> |
| Post/Tweet/News | <embed:post id="ID" type="post|news|tweet" summary="Brief summary" /> |
| Chart | <embed:chart id="CHART_ID" /> |
| Image | <embed:image id="IMAGE_ID" alt="Description" /> |
| Project Table | <embed:project-table ids="ID1,ID2,ID3" columns="market_cap,traders,quant_score" /> |
| Market Map | <embed:market-map title="Title">Group: id:SYM, id:SYM</embed:market-map> |
| File | !file:{agentId}:{encodedFilepath} |
| Skill | !skill:{agentId}:{encodedFilepath} |
| Links | [Link text](url) |
Projects
Embed a project as a compact badge or as a live price chart.
Badge — displays the project name, symbol, and key stats inline:
<embed:project id="PROJECT_ID" symbol="SOL" />Price Chart — renders an interactive price chart for the project:
<embed:project id="PROJECT_ID" symbol="SOL" display="price" />Posts, Tweets & News
Embed social posts, tweets, or news articles with an optional summary:
<embed:post id="POST_ID" type="tweet" summary="Solana hits new ATH" />The type field accepts post, news, or tweet.
Charts
Embed a standalone chart by its ID:
<embed:chart id="CHART_ID" />Images
Embed an image with alt text for accessibility:
<embed:image id="IMAGE_ID" alt="Weekly market overview" />Project Tables
Display a comparison table of multiple projects with configurable columns:
<embed:project-table ids="ID1,ID2,ID3" columns="market_cap,traders,quant_score" />Available columns include market_cap, traders, quant_score, and more.
Market Maps
Market maps let you visually group projects into categories:
<embed:market-map title="DeFi Landscape">
DEX: id1:UNI, id2:RAY
Lending: id3:AAVE, id4:JTO
</embed:market-map>Each line inside the tag defines a group with a label followed by comma-separated id:SYMBOL pairs.
Files & Skills
Reference files and skills owned by an agent using the !file and !skill syntax:
!file:{agentId}:{encodedFilepath}
!skill:{agentId}:{encodedFilepath}These render as interactive links that navigate to the referenced file or skill.
Links
Standard markdown links work as expected:
[Link text](https://example.com)