Free BlueSky facets converter

Convert Markdown links into BlueSky rich text facets

Paste Markdown, strip unsupported formatting, and generate the plain text plus BlueSky facet JSON needed for links and tags in custom AT Protocol workflows.

Markdown input

This helper is for technical formatting checks. ONYX users can also write and schedule approved BlueSky posts directly in the dashboard without manually building facet JSON.

Before wiring facets into a complete record, use the payload checker for calculating exact record payload size restrictions and byte weight limits.

When a manual span fails, use the byte-offset calculator for calculating exact UTF-8 byte offsets for rich text facets.

For reply records, use the thread pointer builder for formatting exact root and parent reference pointers for deep multi-part threads.

Plain post text

Markdown syntax is removed before publishing. Facets point back to byte ranges in this text.

222/300

New guide is live: BlueSky scheduling for builders Bold markdown will be stripped because BlueSky facets support links, mentions, and tags, not bold text. Use #BlueSky and #CreatorTools when they actually help discovery.

Facet JSON

{
  "text": "New guide is live: BlueSky scheduling for builders\n\nBold markdown will be stripped because BlueSky facets support links, mentions, and tags, not bold text.\n\nUse #BlueSky and #CreatorTools when they actually help discovery.",
  "facets": [
    {
      "index": {
        "byteStart": 19,
        "byteEnd": 50
      },
      "features": [
        {
          "$type": "app.bsky.richtext.facet#link",
          "uri": "https://onyxhq.us/blog/how-to-schedule-bluesky-posts"
        }
      ]
    },
    {
      "index": {
        "byteStart": 161,
        "byteEnd": 169
      },
      "features": [
        {
          "$type": "app.bsky.richtext.facet#tag",
          "tag": "BlueSky"
        }
      ]
    },
    {
      "index": {
        "byteStart": 174,
        "byteEnd": 187
      },
      "features": [
        {
          "$type": "app.bsky.richtext.facet#tag",
          "tag": "CreatorTools"
        }
      ]
    }
  ]
}

Conversion checks

Bold, italic, headings, and inline code are stripped because BlueSky rich text facets do not publish those styles.
Facet ranges use UTF-8 byte offsets. Test with the official AT Protocol client before publishing through custom code.

What BlueSky facets support

BlueSky rich text facets cover links, mentions, and tags. They do not publish Markdown bold, italic, headings, or inline code styles.

Official references

BlueSky rich text docs AT Protocol API client

Schedule the readable version

ONYX helps creators write, review, and schedule the approved post without hand-editing JSON for normal publishing.

Start Free