Syndication

Syndication is optional. Choose services during npx inkstead init, or add them later in site.config.ts when you want Inkstead to publish posts to social platforms as part of npm run publish.

Add syndicate to a post:

syndicate:
  - provider-name

Titled posts syndicate as title plus canonical URL. Untitled notes syndicate as native social posts. Untitled photo notes syndicate as native social posts with attached photos when the selected provider supports media uploads.

For photo notes, Inkstead prepares temporary optimized copies when a service has image size or dimension limits. Your original files stay unchanged.

After a service publishes successfully, Inkstead writes the result back to the post under syndication. Future publishes skip anything already marked as published, so the command is safe to run again.

Example result:

syndication:
  provider-name:
    status: published
    url: https://social.example/you/123

npm run publish deploys the website before syndication runs so canonical links are already live.