ASCII-Art Arduino Pinouts


Managing arduino projects can be a nightmare because you only see the software side in your code documentation, the hardware is hard to keep track off.

To enable easy documentation of pin assignments, I created a couple of ASCII art arduinos; complete with ports, PWM and coms all marked. Simply paste as a comment into your code and marvel at your new found organisation.

I suggest altering the image (eg. a letter or X in the [ ]) to keep track of the pins you ended up using.

Find this project on gitHub

Plain Text – Arduino Pinout

Here is copy/paste-able Arduino Pinout ASCII art ready to go (tip: you can use the copy button, at the top of each ASCII art piece, to make the process easy).
     I place them in the Creatice Commons [Creative Commons Attribution (BY) license].
     Attribution via the url: “”

You may notice that the clean layout of these diagrams makes them very readable, personally I feel many graphical versions present too much information at once.

Some Updates (new models)

This idea seems to have caught on quickly, so I will keep the art coming.

Redit user plasticluthier adapted a nano version here, I thought that was spiffy, so I fixed an error tweaked it a bit and added chips and ports.

I have a Pro Mini project coming up, so knocked one of these out as well.

How to use them

Just fill in the spaces, either with an X, or with a reference letter which you document below the ASCII art.

They can be pasted into code comments, (use /* and */ in the arduino IDE to create a block comment). They can also be useful in forums, when you need a quick arduino diagram, but don’t want to fire up an image editor.




This is a snippet from a recent project. The sketch starts out with comments that set-out how the hardware is setup, this helps me a lot when I have to look at it again in a years time. Its also great if I want to share the code, as people don’t need to dig-around in the code to see how to connect the arduino to other devices.


Related Projects (based on this work)

  • I modified a version of this for markdeep and made it available for download  here.
    • There is a unofficial mirror (by vanderZwan) of the markdeep work here
  • A console version, by paulfantom, for terminal users is available here.


Our markdeep version (click image to download)


Stay Up To date and Provide Feedback


Version History

  • 18-11-2015   markdeep version added (as suggested by vanderZwan here)
  • 19-11-2015   typos fixed (as noted by oroki here)
  • 21-112015    Added nano (derived from plasticluthier’s contributions ) &  Pro Mini
  • 1-12-2015     Fixed typo’s spotted by Basile Laderchi. Also minor visual tweak to the arduino CPU.