Meme Factory

Create memes using the free memegen.link API and textual meme formats.

Triggers

Trigger

Description

/meme-factory

Manual invocation

/meme-factory {template} {top} {bottom}

Direct meme generation

meme-factory: create a meme about X

Natural language request

Quick Reference

Action

Format

Basic meme

https://api.memegen.link/images/{template}/{top}/{bottom}.png

With sizing

?width=1200&height=630

Custom background

?style=https://example.com/image.jpg

All templates

https://api.memegen.link/templates/

Interactive docs

https://api.memegen.link/docs/

Additional Resources:

Markdown Memes Guide - 15+ textual meme formats
Examples - Practical usage examples
meme_generator.py - Python helper script

Quick Start

Basic Meme Structure

https://api.memegen.link/images/{template}/{top_text}/{bottom_text}.{extension}

Example:

https://api.memegen.link/images/buzz/memes/memes_everywhere.png

Result: Buzz Lightyear meme with "memes" at top and "memes everywhere" at bottom.

Text Formatting

Character

Encoding

Space

_ or -

Newline

~n

Question mark

~q

Percent

~p

Slash

~s

Hash

~h

Single quote

''

Double quote

""

Popular Templates

Template

Use Case

Example

buzz

X, X everywhere

bugs/bugs_everywhere

drake

Comparisons

manual_testing/automated_testing

success

Victories

deployed/no_errors

fine

Things going wrong

server_on_fire/this_is_fine

fry

Uncertainty

not_sure_if_bug/or_feature

changemind

Hot takes

tabs_are_better_than_spaces

distracted

Priorities

my_code/new_framework/current_project

mordor

One does not simply

one_does_not_simply/deploy_on_friday

Template Selection Guide

Context

Template

Why

Comparing options

drake

Two-panel reject/approve format

Celebrating wins

success

Positive outcome emphasis

Problems ignored

fine

Ironic "everything is fine"

Uncertainty

fry

"Not sure if X or Y" format

Controversial opinion

changemind

Statement + challenge

Ubiquitous things

buzz

"X, X everywhere"

Bad ideas

mordor

"One does not simply..."

Validation

After generating a meme:

URL returns valid image (test in browser)
Text is readable (not too long)
Template matches the message context
Special characters properly encoded
Dimensions appropriate for platform

Platform Dimensions

Platform

Dimensions

Social media (Open Graph)

1200x630

Slack/Discord

800x600

GitHub

Default

Anti-Patterns

Avoid

Why

Instead

Spaces without encoding

URL breaks

Use _ or -

Too much text

Unreadable

2-6 words per line

Wrong template

Message mismatch

Match template to context

Missing extension

Invalid URL

Always include .png, .jpg, etc.

Unencoded special chars

URL breaks

Use ~q, ~s, ~p, etc.

Assuming template exists

404 error

Check templates list first

Verification

Meme generation is successful when:

URL is valid - Returns HTTP 200
Image renders - Displays correctly in markdown
Text is visible - Properly formatted on image
Context matches - Template fits the message

Test command:

curl -I "https://api.memegen.link/images/buzz/test/test.png"
# Should return: HTTP/2 200

Image Formats

Extension

Use Case

.png

Best quality, default

.jpg

Smaller file size

.webp

Modern, good compression

.gif

Animated templates

Dimensions

?width=800
?height=600
?width=800&height=600  (padded to exact)
`### Layout Options`
?layout=top     # Text at top only
?layout=bottom  # Text at bottom only
?layout=default # Standard top/bottom

Custom Fonts

View available: https://api.memegen.link/fonts/

?font=impact (default)

Custom Images

Use any image as background:

https://api.memegen.link/images/custom/hello/world.png?style=https://example.com/image.jpg

Code Reviews

Template: fry
https://api.memegen.link/images/fry/not_sure_if_feature/or_bug.png
`### Deployments`
Template: interesting
https://api.memegen.link/images/interesting/i_dont_always_test/but_when_i_do_i_do_it_in_production.png
`### Documentation`
Template: yodawg
https://api.memegen.link/images/yodawg/yo_dawg_i_heard_you_like_docs/so_i_documented_the_documentation.png
`### Performance Issues`
Template: fine
https://api.memegen.link/images/fine/memory_usage_at_99~/this_is_fine.png
`### Successful Deploy`
Template: success
https://api.memegen.link/images/success/deployed_to_production/zero_downtime.png
`### Generating Memes in Response`
Here's a relevant meme:

![Meme](https://api.memegen.link/images/buzz/bugs/bugs_everywhere.png)
`### Dynamic Generation (Python)`
def generate_status_meme(status: str, message: str):
    template_map = {
        "success": "success",
        "failure": "fine",
        "review": "fry",
        "deploy": "interesting"
    }

    template = template_map.get(status, "buzz")
    words = message.split()
    top = "_".join(words[0:3])
    bottom = "_".join(words[3:6])

    return f"https://api.memegen.link/images/{template}/{top}/{bottom}.png"
`### Using the Helper Script`
from meme_generator import MemeGenerator

meme = MemeGenerator()
url = meme.generate("buzz", "features", "features everywhere")
print(url)

Endpoints

Endpoint

Purpose

/templates/

List all templates

/templates/{id}

Template details

/fonts/

Available fonts

/images/{template}/{top}/{bottom}.{ext}

Generate meme

API Characteristics

Free and open-source
No API key required
No rate limiting (normal use)
Stateless (all info in URL)
Images generated on-demand

Error Handling

Check template at https://api.memegen.link/templates/
Verify text formatting (underscores for spaces)
Check special character encoding
Ensure valid extension
Test URL in browser

References

Document

Content

markdown-memes-guide.md

15+ textual meme formats (greentext, copypasta, ASCII, etc.)

examples.md

Practical usage examples

Scripts

Script

Purpose

meme_generator.py

Python helper for meme generation

Summary

Generate contextual memes to:

Add humor to conversations
Create social media visuals
Make code reviews engaging
Celebrate successes

Golden rule: Keep text concise, match template to context.