Request for comments

Unlimited links in bio.

About pages are already ubiquitous. It's time to make them portable. No character limits. Available wherever you get your feeds.

GET /.well-known/about.md
HTTP/1.1 200 OK Content-Type: text/markdown; charset=utf-8
---
summary: Eager explorer, eternal optimist, passionate about taking the long way home.
---

### About Jordan

I’m an outdoor enthusiast with a gift for turning an ordinary walk into an adventure. I get excited about taking the long way home. 

![Out on the trail](/img/i-love-hiking.png)

JordanDoe.com is my digital garden, where I share the [places](/places), [ideas](/ideas), and [little discoveries](/links) that keep me moving. It’s my corner of the internet—a positive space to stay open to what’s ahead and remember that every path, however familiar, has something new to offer.

The best way to reach me is [[email protected]](mailto:[email protected]).

Jordan Doe

@jordandoe.com

Eager explorer, eternal optimist, passionate about taking the long way home.

I rewrote my about page in Markdown

And now every reader can show it.

About Jordan

I’m an outdoor enthusiast with a gift for turning an ordinary walk into an adventure. I get excited about taking the long way home.

Out on the trail

JordanDoe.com is my digital garden, where I share the places, ideas, and little discoveries that keep me moving. It’s my corner of the internet—a positive space to stay open to what’s ahead and remember that every path, however familiar, has something new to offer.

The best way to reach me is hi@jordandoe.com.

For publishers

From personal websites to CMS platforms

Use the AboutSpec API to make your about page content available in more places:

  • Create a file called about.md
  • Add your profile in Markdown format
  • Include as many links and images as you like!
  • Publish it at /.well-known/about.md
  • Allow CORS requests

That's it. That's all publishers need to implement.

Join the RFC →
Sitemap
  1. /index.html
  2. /img/i-love-hiking.png
  3. /.well-known/about.md
Request Discovery
GET https://jordandoe.com/.well-known/about.md Host: jordandoe.com Accept: text/markdown If-None-Match: "5eb63bbbe01eeed093cb22bb8f5acdc3"
Response Verification
HTTP/1.1 200 OK TLS certificate for jordandoe.com: valid Content-Type: text/markdown; charset=utf-8

For subscribers

From RSS feed readers to next-gen social experiences

Use the AboutSpec API to present richer profile pages.

  • Discovery is a single HTTP GET request
  • Parse responses using standard Markdown libraries
  • Display content in "About" tabs

That's it. That's all subscribers need to implement.

Join the RFC →

Open source, open process.

Help shape the future of the @aboutspec.org API.

Join the RFC 1