

HTMLを使ってWebページを作っていると、あとで見たときに「このコードは何のためだったっけ?」と迷うことがありますよね。
そんな時に役立つのがコメント機能です。
コメントを使えば、ブラウザには表示されないメモをコードの中に残すことができるのです。
複雑なコードでも、コメントがあれば安心して作業を進められます。
この記事ではHTMLのコメントの書き方と注意点について解説していきます。
まずは結論!HTMLのコメントはこう書く!



HTMLのコメントを書くための基本構文はとてもシンプルです。
以下の記号で文章を囲むだけで、簡単にコメントを作ることができます。
<!-- ここにコメントを書きます -->
この「<!–」と「–>」で囲まれた部分が、Webページ上では見えないコメントになります。
コメントを書くメリットは以下の通りです。
- 後からコードの意味を思い出しやすい
- 他の人と一緒に作業する時に便利
- 一時的にコードを無効化できる
このように、コメントはコードの整理に大活躍します。
短い一言から複数行の長い説明まで、どんな長さでも書くことができます。
理由その1!後から見返した時に迷わないから



HTMLのコードが長くなってくると、どこに何が書いてあるのか分からなくなることがよくあります。
特に、数週間や数ヶ月経ってからコードを見直した時、「これ、なんでこんな書き方をしたんだっけ?」と悩むことはプログラマーあるあるです。
そんな時にコメントが書いてあれば、すぐに思い出せます。
例えば、以下のようにヘッダーやフッターの区切りにコメントを入れます。
<!-- ここからヘッダー --> <header> 内容 </header> <!-- ここまでヘッダー -->
どこからどこまでが一つのまとまりなのかが、一目でわかるようになります。
コメントを残すことで、以下の効果があります。
- 修正作業がスピードアップする
- ミスを減らすことができる
- コードの構造が理解しやすくなる
未来の自分のために、コメントを残す習慣をつけましょう。
理由その2!一時的にコードを隠すテストに便利だから



Webページを作っていると、「この画像を一旦消して、どう見えるか試したいな」と思うことがあります。
そんな時、コードをわざわざ消してしまうと、元に戻すのが大変ですよね。
そこでコメントアウトというテクニックを使います。
HTMLのコードをまるごとコメントの記号で囲むと、その部分はブラウザに表示されなくなります。
<!-- <img src="image.jpg" alt="テスト画像"> -->
このようにすると、画像を一時的に非表示にできます。
この方法を使うと、以下のようなメリットがあります。
- コードを消さずにデザインのテストができる
- エラーの原因を探すときに便利
- 不要な部分を安全に取り除ける
コメントは、プログラムを作るうえでの強力な道具になります。
上手に活用して、効率よく作業を進めましょう。
HTMLだけでなく、Webサイトに動きをつけるスクリプトでもメモやコードの無効化を行いたい場合は、JavaScriptのコメントの書き方を解説|1行・複数行コメントと使い分けもチェックして言語ごとの記法の違いを把握しておきましょう。
これだけは注意!コメントを使う時のルール



コメントはとても便利ですが、使う時にはいくつか大切な注意点があります。
一番気をつけてほしいのは、絶対に秘密の情報をコメントに書かないことです。
コメントはブラウザの画面には表示されませんが、ページのソースコードを見ると誰でも簡単に読めてしまいます。
以下の情報は絶対に書かないようにしましょう。
- パスワードやログインID
- 個人情報やメールアドレス
- 公開前の重要な情報
また、コメントの中に「–」という文字を入れると、エラーの原因になることがあります。
<!-- ここに--を入れるとエラーになるかも -->
このように、ハイフンを連続して書くのは避けましょう。
ルールを守って、安全にコメントを活用してください。
コメントに関するよくある質問にお答えします



ここでは、HTMLのコメントについてよくある疑問を解決します。
長文のメモを残したい時は、以下のように改行して書くことができます。
<!-- ここは1行目です。 ここは2行目です。 複数行でも書けます。 -->
このように、開始記号と終了記号の間なら何度でも改行できます。
他にも、こんな質問がよくあります。
- CSSやJavaScriptでも同じ書き方ですか?
- コメントが多すぎるとページが重くなりますか?
CSSやJavaScriptではコメントの書き方が異なります。
HTMLの中だけでこの記号を使ってください。
また、コメントが多すぎると少しだけファイルサイズが大きくなりますが、普通のWebページならほとんど気にする必要はありません。
どんどんコメントを書いて、分かりやすいコードを目指しましょう。
本格的にプログラミングを学びたい方へ



独学で勉強していると、「これで合っているのかな?」と不安になることがありますよね。
より早く、確実にスキルを身につけたいなら、プログラミングスクールで学ぶのがおすすめです。
プロの講師が丁寧に教えてくれるので、分からないところでつまずく心配がありません。
特におすすめなのは、以下のスクールです。
- 手厚いサポートで初心者でも安心の学習コース
- 動画で分かりやすく学べるオンライン講座
- 現役エンジニアから直接指導を受けられるスクール
スクールなら、実践的なスキルを効率よく習得できます。
自分に合ったスクールを見つけて、プログラミングの世界に飛び込んでみましょう。
しっかり学びたい方は、ぜひ以下をチェックしてみてください。
転職保証付きプログラミングスクール DMM WEBCAMP
Skill Hacks
CodeCamp
HTMLのコメントを活用して綺麗なコードを書こう



HTMLのコメントは、コードを分かりやすく整理するための魔法のアイテムです。
メモを残したり、一時的にコードを隠したりと、使い方はあなた次第です。
未来の自分や仲間のために、ぜひコメントを書く習慣をつけてくださいね。
ただし、秘密の情報は絶対に書かないように注意しましょう。
コメントを上手に使って、見やすくて素晴らしいWebページを作っていきましょう。
さらにレベルアップしたい方は、プログラミングスクールでの学習も検討してみてください。
転職保証付きプログラミングスクール DMM WEBCAMP
Skill Hacks
CodeCamp
HTMLの基本ルールを固めて、Web制作やプログラミングを仕事にするためのスキルを本格的に学びたい方は、プログラミングスクールおすすめ比較|初心者が最短でスキル習得できる選び方とは?でプロのサポートを受けられる環境を比較してみてください。
