Skip to content

Conversation

@jvns
Copy link

@jvns jvns commented Oct 21, 2025

I'm a big fan of using curl to make HTTP requests, but I'm always forgetting how to do basic things in curl, like "how do I make a POST request with JSON again?". So I was thinking it could be useful if curl had an official cheat sheet. I know there's a tutorial, but it's quite long and personally I only use an extremely minimal subset of curl's functionality.

This is a pretty rough draft but I wanted to see if there's interest before getting into the details. I linked each option to the appropriate place in the man page.

Here's what it looks like visually right now.
image

some todos:

  • not sure about the name yet (maybe it should be http-cheat-sheet.html?). I feel like it's useful to have a cheat sheet just for doing HTTP(S) requests in curl even though curl does much more.
  • Probably the CSS should be simplified or look a little closer to the curl website's aesthetic
  • The CSS uses nested selectors, that needs to be fixed because not all browsers support nested selectors yet
  • Maybe mention how to set cookies?

@dfandrich
Copy link
Collaborator

dfandrich commented Oct 22, 2025 via email

@bagder
Copy link
Member

bagder commented Oct 22, 2025

I am always in favor of improved documentation - and I like the proposed look. This could be a way to bring a good-looking http cheat sheet to the curl website.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants