Carbon

Translations

Espaol		Deutsch		Portugus
	Trke			Franais
	Svenska	Polski	Nederlands
Indonesia		Italiano
	Add +

Introduction

You know all of those code screenshots you see on Twitter? Though the code's usually impressive, we saw room for improvement in the aesthetic department. Carbon makes it easy to create and share beautiful images of your source code. So what are you waiting for? Go impress all of your followers with your newfound design prowess.

Features

• Customization. Customize things like your image's syntax theme, font style, and more
• Share quickly. Save your image or a link with one click
• Save snippets. Create an account to save snippets for later. Shared snippets are automatically unfurled on Twitter and Slack.

Usage

Import

There are a few different ways to import code into Carbon:

• Drop a file onto the editor
• Append a GitHub gist ID to the URL (e.g. carbon.now.sh/<gist_id_goes_here>)
• Or just start typing!

Customization

Once you've got all of your code into Carbon, you can customize your image by changing the syntax theme, background color, window theme, padding, shadows, fonts, and more.

Exporting & Sharing

After you've customized your image you can share your snippet in a number of ways

Create a saved snippet

Sharing a saved snippet will automatically unfurl the image on platforms like Twitter and Slack. This lets users see your creation, while also giving them access to the source code via the link. Better yet, if you need to make an update, simply follow the link yourself to edit the snippet directly.

To create a saved snippet:

1. Login using the "Sign in/Sign up" button
2. Edit as you normally would your snippet will get saved automatically
3. Copy the URL from your browser window and share away!

Embed a snippet

This is the recommended method for sharing Carbon on your own website or blog. Readers can even copy the code with the click of a button.

You can embed any Carbon snippet in your website directly using the carbon.now.sh/embed URL. The "Copy Menu" lets you quickly copy the correct iFrame snippet, or the encoded URL for embedding on platforms like Medium.

Finally, you can also embed saved snippets or GitHub gists using carbon.now.sh/embed/:id.

Use the Tweet button

The Tweet button will not only share the image on Twitter, but it will also correctly encode the alt text to ensure your images are accessible. However, if you want to tweet image yourself, please check out how to make your Twitter images accessible.

Download the image directly

Carbon supports downloading your image as a PNG and SVG. You can also click Export Open to open your image directly in the browser. Finally, you can copy the Carbon image directly to your clipboard by going to Copy Image.

Installing Carbon for Desktop (Offline)

If you are using Google Chrome, or another browser that supports Progressive Web Apps, you can install Carbon for use offline by:

1. Visit carbon.now.sh
2. Click your browser's settings menu
3. Click "Install Carbon..."

Community

Check out these projects our awesome community has created:

Editor Plugins

• IntelliJ IDEA carbon-now-sh - Open up the selection in your current IntelliJ IDEA file in Carbon through a context menu
• Atom carbon-now-sh - Open up your current Atom file in Carbon with shift-cmd-A
• VS Code carbon-now-sh - Open up your current VS Code file in Carbon with command carbon
• Sublime Text 3 carbon-now-sh - Open up the selection in your current Sublime Text 3 file with a custom bound key
• Vim carbon-now-sh - Open up the selection in your current Vim/Neovim using function CarbonNowSh()
• Emacs carbon-now-sh - Open up the selection in your current Emacs using interactive function carbon-now-sh
• Xcode carbon-now-sh - Open up your current selection in carbon.now.sh
• Xcode nef - This Xcode extension enables you to export a code selection as a Carbon snippet in a single action

Tools

• CLI carbon-now-cli - Open a file in Carbon or download it directly using carbon-now, featuring an interactive mode, selective highlighting and more
• CodeExpander - A smart GitHub gist client with the TextExpander features
• nef - Export multiple Carbon code snippets from Xcode Playground.
• @carbonshbot - A Telegram chatbot wich takes in a code snippet or gist URL and generates an Carbon image
• R carbonate - Iteratively manipulate image aesthetics in R and either open in Carbon or download directly.
• Carbon for Slack - Use Carbon directly in Slack. Just invoke the /carbon command.

Citations

• "CS 101 - An Introduction to Computational Thinking" - a computer science textbook by Sarbo Roy.

Authors

Carbon is a project by:

• Mike Fix (@mfix22)
• Brian Dennis (@briandennis)
• Jake Dexheimer (@jakedex)

License

---

Contribute & Support

Pull requests are welcome! Please see our contributing guidelines for more details.

Sponsors & Backers

Thanks To

Vercel for sponsoring Carbon's hosting.

All Contributors

Thanks goes out to all these wonderful people (emoji key):

briandennis	mfix22	jakedex	andrewda	yeskunall	stoshfabricius	jkling38
otobrglez	darahak	dom96	elrumordelaluz	cjb	Krzysztof-Cieslak	fernahh
g3r4n	Mat Gadd	Brad Davies	Rafael Cmara	Gleb Bahmutov	Ivn Mungua	Dillon Mulroy
Nihad Abbasov	Bruno C. Couto	Mark Molnar	Takahiko Inayama	Franois Martin	Raphael Amorim	Camron Flanders
Eric Adamski	Winner Crespo	Milos	Yashu Mittal	Rachel M. Carmena	Miguel Salazar	Vyom Jain
racaljk	Sean	Izabela Borges	Shinil M S	Berke Atac	LEE YONGJUN	Matthew Nielsen
Boy	Vetrivel Chinnasamy	Farzad YZ	Yannick Loriot	Joel Hanson	Muhammad Muzzammil	souppower
Masato Urai (@uraway_)	Fernando	Megha Sachdev	Anudeep Reddy	Munieru	Adam Lusted	Jose Noriega
Merlin Fuchs	Ramy Majouji	Viktor Nemes	Eric Bailey	Nazeefa	Pratik Butani	Bakti Aditya
Caleb Taylor	Rogrio Munhoz	Technoknol	Tymoteusz Makowski	Nisar Hassan Naqvi	Ilyas Karim	Nick Fix
Melanie Sumner	aluc	B. Mearns	Peng Jie	Binyamin Aron Green	Michal	Quinn Blenkinsop
Dwiferdio Seagal Putra	Ashley Woodall Clark	Tim Wienk	George McCarron	Erwin Rahayu	Luca	Andrew Hayes
Bereket Semagn	Lorenzo Lancia	Guy Adler	Dan Bamikiya	kewang	Rizda Dwi Prasetya	AbreuY
>_Rizky.dev	Abidemi Harry	Marco	Sam Robbins	alceil	hatsu	Praveen Kumar Purushothaman