Webmention.io

Webmention.io is a hosted service created to easily receive web mentions on any web page.

Once you have signed up, add the following tags to your HTML, replacing “username” with the username you got when you signed up:

1
2

    <link rel="webmention" href="https://webmention.io/username/webmention" />
    <link rel="pingback" href="https://webmention.io/username/xmlrpc" />

The system will begin collecting web mentions and pingbacks on your behalf. Of course, you can leave off the pingback endpoint if you’d like.

Note that the “username” here will most likely be your domain. For instance, if your domain is https://aaronparecki.com/, then your username will be aaronparecki.com.

• ! How This Blog Does IndieWeb || Math ∩ Programming with Hugo. Implemented in My Webmention.io
• A Webmention implementation for Hugo - tips & tricks - HUGO
  • ~seirdy/seirdy.one: layouts/partials/webmentions.html - sourcehut git
  • ~seirdy/seirdy.one: layouts/posts/single.html - sourcehut git
• Using Web Mentions in a static site (Hugo)

• step by step with hugo: How to Add BlueSky Comments to Your Hugo Blog: A Step-by-Step Guide | XVRC
  • based on Integrate Bluesky replies as your blog’s comment section in gohugo.io framework · GitHub
    • Another GoHugo example inspired by above Gist: Powering your Hugo blog with Bluesky Comments - invest in a feed you control · Kaushik Gopal’s Home
  • no Webmention.io needed, but require a manual adding bsky url whenever you post
• Beautiful integration of comments and likes G̶o̶o̶g̶l̶e̶r̶… ex-Googler. · April 10, 2025
  • I’m using brid.gy to crawl and gather references, then I ping their service from my Deno server for mentions of my url, then render results to a post 🙂 @nerdy.dev on Bluesky
• How This Blog Does IndieWeb || Math ∩ Programming

Bridgy is a service that connects your website to social networks by sending webmentions between them. For it to automatically poll your social media accounts (like Bluesky) without manual intervention, your website needs to implement specific microformat tags.

I used that for fetching my webmentions and comments from Bluesky. Below some relevant tags I had to add. This documentation is based on Brid.gy documentation (linked at the end).

The primary microformat tags needed for Bridgy to work with your second brain - h-entry etc.:

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23

<!-- Main container for a post/note -->
<article class="h-entry">
  <!-- Title of the post -->
  <h1 class="p-name">Your Title</h1>
  
  <!-- Publication date -->
  <time class="dt-published" datetime="2025-05-05T12:00:00Z">May 5, 2025</time>
  
  <!-- Author information (can be hidden) -->
  <span style="display: none;">
    <a href="https://www.ssp.sh" class="p-author h-card">Simon Späti</a>
  </span>
  
  <!-- Main content -->
  <div class="e-content">
    Your content goes here
  </div>
  
  <!-- Optional: Syndication links (only needed for posts you share on social media) -->
  <a class="u-syndication" href="https://bsky.app/profile/yourusername/post/postid">
    Also on Bluesky
  </a>
</article>

1. h-entry: Marks a note/post as a distinct piece of content that Bridgy can identify and track.
2. p-name: Helps Bridgy identify the title of your post.
3. dt-published: Provides the publication timestamp, which Bridgy uses to order responses chronologically.
4. p-author h-card: Identifies you as the author of the content.
5. e-content: Defines the main content area of your post.
6. u-syndication: (Optional) Creates a direct link between your website post and its corresponding social media post.

When you have many notes like in a second brain, you don’t need to add syndication links to every note. Instead:

1. Ensure your Bluesky profile links to your website

2. Add h-feed to list/index pages:

   1 2 3 4

   <div class="h-feed"> <h1 class="p-name">Notes Collection</h1> <!-- Your list of notes goes here --> </div>

3. Add syndication links only to important notes that you specifically share on social media

1. Bridgy checks your social network accounts periodically (typically every 30 minutes).
2. If you’ve been signed up for over a week with no successful webmentions sent, or if the last webmention was over a month ago, polling decreases to once a day.
3. To maintain frequent polling:
   • Ensure your social profile links to your website
   • Consistently post content that generates responses
   • When posting to social media, include links back to your website

1. Sign up at brid.gy
2. Connect your Bluesky account
3. Enable “Listen” for backfeed (to receive interactions from Bluesky)
4. Optionally enable “Publish” if you want to cross-post

If automatic polling isn’t working:

1. Check for a ⚠️ icon on your Bridgy user page, which indicates lost access
2. Click “Poll now” once to restart the automatic polling process
3. Make sure some of your notes have correct h-entry markup
4. Verify your Bluesky profile links to your website

• Bridgy Documentation
• IndieWeb Webmention
• Microformats2 h-entry Reference

This setup allows Bridgy to automatically poll your Bluesky account and discover interactions with your content without manual intervention, making it practical for large collections of notes like your second brain.

Origin: Webmentions in Blogs
References: IndieWeb, My Webmention.io