Social

Social link icon rows for footers.

A social block turns a list of links into an icon row. The icon is derived from each link's hostname:

::: social
- [GitHub](https://github.com/anypost/emailmd)
- [X](https://x.com/emailmd)
- [LinkedIn](https://www.linkedin.com/company/emailmd)
:::

Recognized networks: Facebook, X/Twitter, Instagram, LinkedIn, GitHub, YouTube, Pinterest, Medium, Vimeo, Dribbble, SoundCloud, Tumblr, Snapchat, and Xing. Any other host gets a generic web icon.

Parameters

Labels

Icons only by default; add the labels flag to show each link's text next to its icon:

::: social labels
- [Follow us](https://x.com/emailmd)
:::

Icon size and alignment

::: social icon-size=32 left
- [GitHub](https://github.com/anypost/emailmd)
:::

icon-size is pixels (default 24). Alignment keywords: left, center (default), right.

Self-hosted icons

The default icons are white marks from Simple Icons (CC0, free to reuse) on each network's brand color, served from https://www.emailmd.dev/icons/social/. To serve icons from your own domain, point icon-base at a directory with one <network>.png per network you link to:

facebook.png, x.png, instagram.png, linkedin.png, github.png, youtube.png, pinterest.png, medium.png, vimeo.png, dribbble.png, soundcloud.png, tumblr.png, snapchat.png, xing.png, and web.png for any other host.

To keep the default look, copy the defaults: each is a 96×96 PNG at https://www.emailmd.dev/icons/social/<name>.png.

::: social icon-base=https://cdn.example.com/icons/
- [GitHub](https://github.com/anypost/emailmd)
:::

You can also override a single link's icon with an attribute:

::: social
- [Blog](https://blog.example.com){icon=https://cdn.example.com/blog.png}
:::

In the plain-text version of the email, the block flattens to Label (url) lines.