HTMLのコメントアウトの書き方を具体例も使って紹介！

webサイトやwebサービスは、作って終わりではなく、改善を繰り返したり、追加のページや機能を入れることもよくあります。そんな時に、以前書いたコードにコメントがあると、『あれ？これなんだっけ？』と迷うようなことも少なくなります。

この記事では、HTMLのコメントアウトの書き方を具体例も使って紹介します。

CSSのコメントアウトの書き方については、下記の記事をご覧ください。

💡 コーディングの練習なら模写修行！

無料教材もあります！

【こんな方におすすめ】

• 実務のレベル感を知りたい
• プロの制作フローを学びたい
• 基礎学習中、もしくは終えたばかり
• CSS設計やSCSSを使った書き方を学びたい

公式サイトを見る

コーディング教材の【模写修行】は他の教材と何が違うのか？

コメントアウトとは？

コメントアウトとはコード上に残すメモです。プログラム・ブラウザ上の表示・SEOには、影響を与えません。

制作をしていると、自分が書いたコードでも、しばらく期間を空けて見ると、『なんだっけ、これ？』と思うことはよくあります。そんな時に、コメントとして、コードの説明があれば、理解の手助けになります。

複数人で制作するときにも、他の人にもわかるように、コメントを入れることはスムーズに制作を進める上で大切です。

• 制作の効率化(可読性アップ)
• 保守性アップ

これらの点において、コメントはとても有効です。

HTMLのコメントアウトの書き方

• 1行のコメントアウト
• 複数行のコメントアウト

これら2つのパターンに分けて、コメントアウトの書き方を紹介します。

1行のコメントアウト

<!-- <p>親譲りの無鉄砲で小供の時から損ばかりしている。</p> -->

1行コメントも複数行のコメントも、上のように<!--と-->で囲います。

<!-- 親譲りの無鉄砲で小供の時から損ばかりしている。 -->

このようにタグなしのテキストだけもコメントに出来ます。

複数行のコメントアウト

<!--
    <p>親譲りの無鉄砲で...</p>
    <p>親譲りの無鉄砲で...</p>
-->

<!--
    親譲りの無鉄砲で小供の時から
    損ばかりしている。
-->

複数行のコメントはこのように書きます。コメント内で改行しても問題ありません。

HTMLのコメントアウトは具体的にどんな時に使う？

実際にどんな時にコメントアウトを使うか紹介します。

終了タグをわかりやすくする

<div class="hoge01">
    <div class="hoge02">
        <div class="hoge03">
            <p>親譲りの無鉄砲で...</p>
            ...
        </div><!-- /.hoge03 -->
    </div><!-- /.hoge02 -->
</div><!-- /.hoge01 -->

デザインによっては、上のコードのようにdivが入れ子になります。この時、開始タグに対応する、終了タグが分かりやすいようにコメントを入れると良いです。

<!-- service -->
<section class="service">
    ...
</section>
<!-- end service -->

セクションなど大きなブロックごとに、開始と終了がわかりやすいようにしても良いです。

注意書きを残す

<!-- 広告バナーエリア -->
<div class="banner">
    <img src="" alt="">
</div>

例えば、必ず広告のバナーが入るエリアには上のようなコメントを入れておいても良いです。

制作時のメモを残す

<!-- TODO: 現在サンプルテキスト使用。後日差し替え必要。 -->
<p>親譲りの無鉄砲で...</p>

<!-- FIXME: 表示崩れ。修正必要。 -->
<p>親譲りの無鉄砲で...</p>

制作時のメモを残すこともあります。後述しますが、このTODOやFIXMEを使ったコメントは、アノテーションコメントと呼ばれるものです。

一時的にコメントにする

<!-- service -->
<!-- <section class="service">
    ...
</section> -->
<!-- end service -->

一時的にコメントにすることもあります。例えば、そのコンテンツを消すか残すか検討中の場合など、一旦コメントにして、決まり次第対応するようなイメージです。

後で公開するものを予め作っておいてコメントにしているケースもありますが、公開時はなるべく不必要なコメントは残さない方が良いです。

HTMLのコメントアウトの注意点

コメントアウトする際の注意点を紹介します。

入れ子に出来ない

<!-- 🙅‍♂️ 入れ子に出来ない -->

<!-- <div class="hoge">
    <!-- <img src="" alt=""> -->
    <p>親譲りの無鉄砲で...</p>
</div> -->

コメントの中にコメントを入れる(入れ子にする)ことはできません。

ディベロッパーツールから見られてしまう

コメントはディベロッパーツールから見れてしまいます。HTMLのコメントは隠すことが出来ません。

パスワードなど重要な情報はコメントとして残さないことはもちろん、見られて恥ずかしいような内容なども残さないように注意が必要です。

コメントを書きすぎない

コメントが多いと可読性が失われます。分かりやすくするためにコメントで、逆に分かりにくくなってしまったら本末転倒です。

また、あまり気にしなくて良いことではありますが、コメントが多いと若干ファイルサイズは大きくなります。

サイト公開時に不必要なコメントは消す

下記はコメントを使う4つの場面です。

• 終了タグをわかりやすくする
• 注意書きを残す
• 制作時のメモを残す
• 一時的にコメントにする

このうち、後半2つはサイト公開時には消しておいた方が良いです。

アノテーションコメントを使うと便利！

アノテーションコメントを使うと、コメントにメタデータを付加できます。

<!-- TODO: 現在サンプルテキスト使用。後日差し替え必要。 -->
<p>親譲りの無鉄砲で...</p>

<!-- FIXME: 表示崩れ。修正必要。 -->
<p>親譲りの無鉄砲で...</p>

TODOやFIXMEがメタデータです。要はコメントを役割ごとに分類(カテゴリ分け)しているようなものです。

Visual Studio Codeではプラグインを入れることで、アノテーションコメントを一覧で見ることができるのでとても便利です。

TODOやFIXME以外にもいくつかあるので、参考サイトを載せておきます。

プログラミングではよく使いますが、コーディングで使っている方は、もしかしたら少ないかもしれません。個人的にはTODOをたまに使う程度です。

Visual Studio CodeのブラグインTodo Treeが便利！

Visual Studio CodeのブラグインTodo Treeを入れると、上のようにTODOやFIXMEをハイライトしてくれます。

また、左のメニューから一覧で見ることもできるので、対応漏れも防げます。

HTML以外の言語でも使えます。デフォルトでは、TODOとFIXMEしか対応していないので、カスタマイズする際は設定ファイルを修正する必要があります。興味がある方は調べてみてください。

HTMLのコメントアウトのショートカットキー

コメントにしたい箇所をドラックして、上のショートカットキーを押すことでコメントアウト出来ます。

よく使うので絶対に覚えておきたいショートカットキーの1つです。

Emmetを使って効率よくコメントを入れる方法

Emmetとは、HTML・CSSを書く時に使える、入力補完機能です。Visual Studio Codeでは標準で備わっています。

例えば、ul>li*3>aと入力して、tabキーを押してみてください。下のように表示されたはずです。

<ul>
    <li><a href=""></a></li>
    <li><a href=""></a></li>
    <li><a href=""></a></li>
</ul>

他にもたくさんできることがあるので、詳しくはCheat Sheetをご覧ください。

Emmetを使って効率的にコメントを入れることが出来ます。

section.hoge|cと入力して、tabキーを押してみてください。下のようにコメントとセットで表示されるはずです。

<section class="hoge"></section>
<!-- /.hoge -->

カスタマイズすることで、Emmetを使った時には必ずコメントが入るようにもできます。ただし必ず入るとコメントが多すぎて見にくくなる可能性もあるので注意してください。

また、cと入力して、tabキーを押すと、下のように空のコメントができます。

<!--  -->

(おまけ) コカ・コーラの遊び心があるコメント

最後におまけです。コカ・コーラはこんな遊び心があるコメントを残しています。

超実務向け！コーディングの練習が出来るサービス作りました 🎉

模写修行は実戦に沿った形で、コーディングの"練習"ができるサービスです。

こんな方におすすめ！

• 実務のレベル感を知りたい
• プロの制作フローを学びたい
• 何を考えながらコードを書くのか知りたい
• 基礎学習中、もしくは終えたばかり
• CSS設計やSCSSを使った書き方を学びたい

模写修行ではデザインデータ(FigmaとXD) / web上で見れる解説 / サンプルコードを提供しています。ご自身でデザインを見ながらコーディングに挑戦し、解説とサンプルコードで答え合わせ&さらに深く学ぶことができるサービスです。

他の書籍や教材との違いは、超初心者向け・学習用の書き方ではなく、実際の現場で通用する書き方や考え方にフォーカスしている点です。詳しくは下記の記事をご覧ください。

コーディング教材の【模写修行】は他の教材と何が違うのか？

無料教材もあります！👍

模写修行を見る

脱初心者！自信を持ってプロと言えるスキルを！

嬉しい声もいただいています！

自分のweb制作におけるコードの書き方、ファイル管理は模写修行さんから学ばせていただきました。独学の強い味方だと思いました。教材、メディアありがとうございました！
TwitterでDMいただきました！🙇

---

classの命名迷子・横並びレイアウト恐怖症だったけど、無料〜中級までいくつかやっていく中で、どんどん迷いが減っていって楽しかったです！解説記事もわかりやすい...！
Tweet

---

デザインきれいだし、解説とサンプルソースが付いて答え合わせしやすいところが良い。
Tweet

---

答え合わせ終わった。top-kvの実装方法に脱帽。そういうやり方があることを知れたことが大きい。。sass学びはじめたばかりなのでscssコードがとても参考になった。次からはscssでかく。
Tweet

---

無料教材もあります！👍

模写修行を見る

脱初心者！自信を持ってプロと言えるスキルを！