Bluesky Comments For Quarto

Installing

quarto add gadenbuie/quarto-bluesky-comments

This will install the extension under the _extensions subdirectory. If you’re using version control, you will want to check in this directory.

Using

Adding Bluesky-powered comments to your blog is a three-step process1:

  1. Publish the blog post and post about it on Bluesky.
  2. Copy the link to the Bluesky post.
  3. Add {{< bluesky-comments {post-url} >}} to your blog post and re-publish.

Using Bluesky for comments introduces a chicken-or-egg problem. You need one Bluesky post to watch for replies so that those replies can be shown in your blog post as comments. But first, you need to publish your blog so you can share it on Bluesky. Once you have the link to your skeet, come back to your blog and add the {{< bluesky-comments >}} shortcode.

The {{< bluesky-comments >}} shortcode doesn’t add any additional decoration (to make it as flexible as possible for your use case). Here’s a short snippet that adds the comments under a horizontal rule and in a “Comments” section:

---

## Comments {.unlisted}

{{< bluesky-comments https://bsky.app/profile/grrrck.xyz/post/3lbu5opiixc2j >}}

Moderation

To moderate unruly or disruptive commentors, navigate to your Bluesky post and find the unwanted comment(s) in the replies. Click the post menu ⋯ on the reply and select Hide reply for everyone. Hidden posts and their replies are immediately hidden for any new visitors.

Community Built

This extension builds on the web component shared by @loouee.bsky.social in response to the bluesky-comments npm package shared by @coryzue.com inspired by @emilyliu.me’s post describing how to add comments from Bluesky. Then I (@grrrck.xyz) remixed the remix to make it work well with Quarto and to include some features from the npm package version.

Comments

Footnotes

  1. Yes, I know, that’s actually 5 steps.↩︎