1 files changed, 19 insertions, 20 deletions
diff --git a/files/ja/web/css/comments/index.md b/files/ja/web/css/comments/index.md
index 2c90a49e58..49065643af 100644
--- a/files/ja/web/css/comments/index.md
+++ b/files/ja/web/css/comments/index.md
@@ -3,23 +3,26 @@ title: コメント
 slug: Web/CSS/Comments
 tags:
   - CSS
-  - CSS 構文と基本データ型
-  - Reference
+  - ガイド
+  - リファレンス
 translation_of: Web/CSS/Comments
 ---
-<div>{{CSSRef}}</div>
+{{CSSRef}}
 
-<p>CSS の<strong>コメント</strong>は、説明的なメモをコードに追加したり、スタイルシートの特定の部分をブラウザーに解釈させないようにしたりするために使用します。設計上、コメントは文書のレイアウトにおいて効果を持ちません。</p>
+CSS の**コメント**は、説明的なメモをコードに追加したり、スタイルシートの特定の部分をブラウザーに解釈させないようにしたりするために使用します。設計上、コメントは文書のレイアウトにおいて効果を持ちません。
 
-<h2 id="Syntax" name="Syntax">構文</h2>
+## 構文
 
-<p>コメントはスタイルシート内で、ホワイトスペースが置ける場所ならばどこでも配置できます。1行で使用したり、複数行に渡らせたりすることができます。</p>
+コメントはスタイルシート内で、ホワイトスペースが置ける場所ならばどこでも配置できます。1行で使用したり、複数行に渡らせたりすることができます。
 
-<pre class="syntaxbox">/* コメント */</pre>
+```css
+/* コメント */
+```
 
-<h2 id="Examples" name="Examples">例</h2>
+## 例
 
-<pre class="brush:css">/* 1行のコメント */
+```css
+/* 1 行のコメント */
 
 /*
 複数行に
@@ -35,20 +38,16 @@ span {
   font-size: 1.5em;
 }
 */
-</pre>
+```
 
-<h2 id="Notes" name="Notes">メモ</h2>
+## メモ
 
-<p><code>/* */</code> のコメント構文は、1行のコメントにも複数行のコメントにも使用されます。外部のスタイルシートでコメントを指定する方法は他にありません。しかし、推奨されませんが、 {{htmlelement("style")}} 要素を使用するときは、古いブラウザーから CSS を隠すために <code>&lt;!-- --&gt;</code> を使用することができます。 <code>/* */</code> のコメント文法を使用する他のプログラミング言語と同様、コメントはネストできません。言い換えれば、 <code>/*</code> の後で最初に <code>*/</code> が出現すると、コメントが終了します。</p>
+`/* */` のコメント構文は、 1 行のコメントにも複数行のコメントにも使用されます。外部のスタイルシートでコメントを指定する方法は他にありません。しかし、推奨されませんが、 {{htmlelement("style")}} 要素を使用するときは、古いブラウザーから CSS を隠すために `<!-- -->` を使用することができます。 `/* */` のコメント文法を使用する他のプログラミング言語と同様、コメントは入れ子にすることができません。言い換えれば、 `/*` の後で最初に `*/` が出現すると、コメントが終了します。
 
-<h2 id="Specifications" name="Specifications">仕様書</h2>
+## 仕様書
 
-<ul>
- <li><a href="http://www.w3.org/TR/CSS21/syndata.html#comments">CSS 2.1 Syntax and basic data types #comments</a></li>
-</ul>
+- [CSS 2.1 Syntax and basic data types #comments](https://www.w3.org/TR/CSS21/syndata.html#comments)
 
-<h2 id="See_also" name="See_also">関連情報</h2>
+## 関連情報
 
-<ul>
- <li>{{CSS_key_concepts}}</li>
-</ul>
+- {{CSS_key_concepts}}