Apply suggestions from code review

Co-authored-by: Gregg Kellogg <[email protected]>

spec/index.html

@@ -243,7 +243,7 @@ <h2>Introduction</h2>
       <p>
         Since YAML is more expressive than JSON,
         both in the available data types and in the document structure
-        (see [[I-D.ietf-yaml-mediatypes]]),
+        (see [[I-D.ietf-httpapi-yaml-mediatypes]]),
         this document identifies constraints on YAML documents
         such that they can be used to represent JSON-LD documents.
       </p>
@@ -308,7 +308,7 @@ <h2>Basic Concepts</h2>
       JSON encoding is UTF-8.
     </p>
 
-    <p>Example: the JSON-LD document below
+    <p data-format="markdown>Example: the JSON-LD document below
 
     ```
     {
@@ -345,7 +345,7 @@ <h2>Basic Concepts</h2>
     </p>
   </section>
   <section id="specifications" class="normative">
-    <h2>Specifications</h2>
+    <h2>Core Requirements</h2>
 
     <p>
       A YAML-LD document is a [[YAML]] document that can be interpreted as linked data.
@@ -373,7 +373,7 @@ <h2>Specifications</h2>
       When interpreting the document as JSON-LD,
       alias nodes MUST be resolved by value to their target nodes.
     </p>
-    <p>
+    <p data-format="markdown>
       Example: The following YAML-LD document
       contains alias nodes for the {"@id": "country:ITA"} object;