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.