How do you do block comments in YAML?

Question

How do I comment a block of lines in YAML?

Answer 1

For Ruby Mine users on Windows:

Open file in editor Select the block and press Ctrl+forward slash, you will have selected block starting with #.

Now if you want to un-comment the commented block, press same key combination Ctrl+forward slash again

Answer 2

One way to block commenting in YAML is by using a text editor like Notepad++ to add a # (comment) tag to multiple lines at once.

In Notepad++ you can do that using the "Block Comment" right-click option for selected text.

Answer 3

An alternative approach:

If

• your YAML structure has well defined fields to be used by your app
• AND you may freely add additional fields that won't mess up with your app

then

• at any level you may add a new block text field named like "Description" or "Comment" or "Notes" or whatever

Example:

Instead of

# This comment
# is too long

use

Description: >
  This comment
  is too long

or

Comment: >
    This comment is also too long
    and newlines survive from parsing!

More advantages:

1. If the comments become large and complex and have a repeating pattern, you may promote them from plain text blocks to objects
2. Your app may -in the future- read or update those comments

Answer 4

YAML supports inline comments, but does not support block comments.

From Wikipedia:

Comments begin with the number sign ( # ), can start anywhere on a line, and continue until the end of the line

A comparison with JSON, also from Wikipedia:

The syntax differences are subtle and seldom arise in practice: JSON allows extended charactersets like UTF-32, YAML requires a space after separators like comma, equals, and colon while JSON does not, and some non-standard implementations of JSON extend the grammar to include Javascript's /* ... */ comments. Handling such edge cases may require light pre-processing of the JSON before parsing as in-line YAML.

# If you want to write
# a block-commented Haiku
# you'll need three pound signs

Answer 5

Emacs has comment-dwim (Do What I Mean) - just select the block and do a:

M-;

It's a toggle - use it to comment AND uncomment blocks.

If you don't have yaml-mode installed you will need to tell Emacs to use the hash character (#).

Answer 6

Not trying to be smart about it, but if you use Sublime Text for your editor, the steps are:

1. Select the block
2. cmd+/ on Mac or ctrl+/ on Linux & Windows
3. Profit

I'd imagine that other editors have similar functionality too. Which one are you using? I'd be happy to do some digging.