Skip to content
J·BJon BishopIndependent growth marketer

Publishing · llms.txt file breakdown

Buttondown llms.txt

Newsletter platform overview/documentation for writers, creators and developers, including features, integrations, pricing and help resources.

The actual file

Source Markdown

The saved llms.txt text, displayed as source. The file belongs to its publisher; the live endpoint may change.

Open saved text ↗

Complete saved Markdown shown below.

# Buttondown

> Buttondown is a simple, powerful newsletter platform for people who want to own their audience. It's built for writers, creators, and developers who care about clean design, reliable deliverability, and having full control over their data.

## What Buttondown does

Buttondown lets you write and send newsletters, manage subscribers, accept paid subscriptions via Stripe, set up automations, and build on top of a comprehensive REST API. It supports Markdown and rich text editing, custom sending and hosting domains, RSS-to-email, tags and metadata for segmentation, surveys, and integrations with tools like Zapier, Discord, and webhooks.

## Who Buttondown is for

- **Writers and journalists** who want a clean, distraction-free writing experience
- **Developers** who want API-first newsletter infrastructure they can build on
- **Creators** (artists, musicians, podcasters) who want to own their audience relationship
- **Small businesses and nonprofits** who need simple, reliable email without enterprise complexity
- **Anyone migrating** from Substack, Mailchimp, Ghost, beehiiv, MailerLite, or other platforms

## Pricing

- **Free tier**: Up to 100 subscribers, unlimited emails
- **Basic** ($9/month): Custom domains, API access, automations, remove Buttondown branding
- **Professional** ($29/month): Surveys, premium integrations, priority support
- **Enterprise**: Custom pricing for large organizations

Paid subscriptions via Stripe are available on all paid plans with no revenue share.

## Migration

Buttondown has built-in import tools and step-by-step migration guides for:

- [Substack](https://docs.buttondown.com/substack)
- [Mailchimp](https://docs.buttondown.com/mailchimp)
- [Ghost](https://docs.buttondown.com/ghost)
- [beehiiv](https://docs.buttondown.com/beehiiv)
- [MailerLite](https://docs.buttondown.com/mailerlite)
- [ConvertKit / Kit](https://docs.buttondown.com/convertkit)
- [And many more](https://docs.buttondown.com/importing-your-data)

Subscriber data, archives, and paid subscriptions can all be migrated.

## Key differentiators

- **No ads, no boosts, no growth hacks**: Buttondown focuses on the writing and sending experience, not selling your audience to advertisers
- **API-first**: Full REST API with OpenAPI spec, CLI tool, webhooks, and programmatic access to everything
- **Markdown-native**: First-class Markdown support, not bolted on
- **Indie and profitable**: Bootstrapped, no VC pressure to enshittify, sustainable business model
- **Data portability**: Export everything at any time, no lock-in

## Links

- Website: https://buttondown.com
- Documentation: https://docs.buttondown.com
- API reference: https://docs.buttondown.com/api-introduction
- OpenAPI spec: https://docs.buttondown.com/openapi.json
- Status page: https://status.buttondown.com
- Blog: https://buttondown.com/blog
- Changelog: https://buttondown.com/changelog

Measured from the saved file

Linked document

UTF-8 text size
2.8 KB2908 bytes
Token count
655o200k_base encoding
Markdown links
77 distinct URLs
Fenced code blocks
056 lines in the file

Size measures the captured UTF-8 text, not compressed transfer size. Tokens are counted with a named tokenizer; other models can count differently. Neither measure establishes context compatibility or answer quality.

Project H1
Buttondown

Opening blockquote

Buttondown is a simple, powerful newsletter platform for people who want to own their audience. It's built for writers, creators, and developers who care about clean design, reliable deliverability, and having full control over their data.

Context architecture

How the content is divided

6 H2 sections organize 7 parsed Markdown links. 0 links point to .md or .markdown paths; 7 link occurrences use another hostname. Linked destinations have not been recursively validated.

H2 sectionLinksUTF-8 bytesTokens
What Buttondown doesLine 5037774
Who Buttondown is forLine 9045497
PricingLine 17037480
MigrationLine 267532136
Key differentiatorsLine 400483115
LinksLine 48032682

Link counts exclude parsed fenced and inline code and resolve relative destinations against the final endpoint. Section sizes cover the text below each H2 until the next H2.

Embedded material

Code, installation and API examples

Fenced blocks
0 closed
Declared languages
No fenced blocks detected
Package-install commands
0 detected in fenced or inline code
Authentication examples
0 fenced lines match API-key, Authorization, Bearer, OAuth or access-token patterns
HTTP request examples
0 fenced lines match request-method patterns
Authentication links
0 links have authentication-related labels

Embedded example text and links to further documentation are counted separately. A code block does not establish that a sample runs or that an authentication flow succeeds.

Publisher prioritization

The Optional section

No H2 section named “Optional” was detected in this file.

The community proposal uses Optional by convention for secondary links that can be skipped for a shorter context. This label does not establish that everything outside it is critical, or that the material inside it is deprecated.

Machine-readable routes

MCP references and configuration text

No MCP or Model Context Protocol term was detected in the captured file. 0 links have MCP-related labels or paths. 0 fenced lines match mcpServers, mcp_servers or an mcp add command.

These are text and link observations. No MCP server connection, authentication or tool call was tested.

Index and bundle

llms-full.txt companion

Not found at checked URLs

A verified text response establishes a companion at the checked URL. It does not prove the bundle contains all product documentation, that generation is automated, or that it fits an assistant’s context window.

Change evidence

What can be said about freshness

This capture establishes a baseline. Update frequency cannot be determined from one observation.

File changes can reveal documentation edits or navigation changes. They do not by themselves measure product release velocity, accuracy, agent adoption or AI visibility.

Capture identity and measurement method
Requested endpoint
https://buttondown.com/llms.txt
Final endpoint
https://buttondown.com/llms.txt
HTTP status
200
Content type
text/plain; charset=utf-8
Text retrieval
Firecrawl literal text capture
Tokenizer
tiktoken 0.14.0 · o200k_base
SHA-256 of saved UTF-8 text
ad99d6be5570e7badcfba48189bbb928d493d4007d3208d941a9275e7d5cad81

Counts use a deterministic parser, not a spec-compliance grade. Unusual Markdown and indented code can fall outside its recognized patterns. See the llms.txt proposal and tokenizer implementation.

Related tools and resources

Prefer to write? Send Jon a message.