diff --git a/extensions/amp-youtube/amp-youtube.md b/extensions/amp-youtube/amp-youtube.md
index e077e1c4ae5d..ba604a3b819a 100644
--- a/extensions/amp-youtube/amp-youtube.md
+++ b/extensions/amp-youtube/amp-youtube.md
@@ -14,7 +14,7 @@ See the License for the specific language governing permissions and
 limitations under the License.
 -->
 
-### <a name="amp-youtube"></a> `amp-youtube`
+## <a name="amp-youtube"></a> `amp-youtube`
 
 Displays a Youtube video.
 
@@ -23,16 +23,13 @@ Example:
 <amp-youtube
     data-videoid="mGENRKrdoGY"
     layout="responsive"
-    width="480" height="270"></amp-youtube>
+    width="480" height="270">
+</amp-youtube>
 ```
+With responsive layout, the width and height from the example should yield correct layouts for 16:9 aspect ratio videos.
 
-
-With responsive layout the width and height from the example should yield correct layouts for 16:9 aspect ratio videos
-
-#### Attributes
+### Attributes
 
 **data-videoid**
 
-The Youtube video id found in every Youtube video page URL
-
-E.g. in https://www.youtube.com/watch?v=Z1q71gFeRqM Z1q71gFeRqM is the video id.
+The Youtube video ID found in every Youtube video page URL. For example, in the URL `https://www.youtube.com/watch?v=Z1q71gFeRqM`, "Z1q71gFeRqM" is the video ID.