Oct. 10, 2012

How to use comments in Python

When working with any programming language, you include comments in the code to notate your work. This details what certain parts of the code are for, and lets other developers – you included – know what you were up to when you wrote the code. This is a necessary practice, and good developers make heavy use of the comment system. Without it, things can get real confusing, real fast.


How to Write Comments in Python

In Python, there are two ways to annotate your code.

The first is to include comments that detail or indicate what a section of code – or snippet – does.

The second makes use of multi-line comments or paragraphs that serve as documentation for others reading your code.

Think of the first type as a comment for yourself, and the second as a comment for others. There is not right or wrong way to add a comment, however. You can do whatever feels comfortable.


Single-line comments are created simply by beginning a line with the hash (#) character, and they are automatically terminated by the end of line.

For example:


#This would be a comment in Python


Comments that span multiple lines – used to explain things in more detail – are created by adding a delimiter (""") on each end of the comment.


This would be a multiline comment
in Python that spans several lines and
describes your code, your day, or anything you want it to

Please note: The recommended method for commenting multiple lines is using # on each line. The (""") method isn't actually a comment but defines a Text constant of the text between the ("""). It isn't displayed, but exists and could potentially cause unexpected errors.

Remember to comment as often as possible. It’s important!

Share this article

Recommended Python Training – DataCamp

For Python training, our top recommendation is DataCamp.

Datacamp provides online interactive courses that combine interactive coding challenges with videos from top instructors in the field.

Datacamp has beginner to advanced Python training that programmers of all levels benefit from.


Download Our Free Guide To Learning Python

* indicates required

Read more about:
Disclosure of Material Connection: Some of the links in the post above are “affiliate links.” This means if you click on the link and purchase the item, I will receive an affiliate commission. Regardless, PythonForBeginners.com only recommend products or services that we try personally and believe will add value to our readers.