Clean and document

.github/workflows/dist.yml

@@ -7,6 +7,10 @@ on:
     tags:
       - '*'
 
+permissions:
+  contents: write
+  pull-requests: write
+
 jobs:
   dist:
     if: github.repository == 'jelovirt/org.lwdita'
@@ -74,7 +78,7 @@ jobs:
           mv concat.json ${{ env.PLUGIN_NAME }}.json
           rm buf.json
       - name: Create Pull Request
-        uses: peter-evans/create-pull-request@v5
+        uses: peter-evans/create-pull-request@v7
         with:
           path: registry
           token: ${{ secrets.LWDITA_REGISTRY_PR }}

README.md

@@ -10,7 +10,7 @@ newer.
 
 It contains:
 
-- a custom parser for Markdown and HTML to allow using Markdown and HDITA
+- a custom SAX parser for Markdown and HTML to allow using Markdown and HDITA
   as source document formats,
 - and a transtype to generate Markdown from DITA source.
 

build.gradle

@@ -5,7 +5,7 @@ sourceCompatibility = 11
 targetCompatibility = 11
 
 group = 'com.elovirta.dita'
-version = "5.9.0"
+version = "5.9.1"
 
 repositories {
     mavenCentral()

src/main/java/com/elovirta/dita/markdown/DitaRenderer.java

@@ -20,138 +20,152 @@
 
 public class DitaRenderer {
 
+  /** Treat first paragraph as shortdesc. */
   public static final DataKey<Boolean> SHORTDESC_PARAGRAPH = new DataKey<>("SHORTDESC_PARAGRAPH", false);
   public static final DataKey<Boolean> TIGHT_LIST = new DataKey<>("TIGHT_LIST", true);
+  /** Read topic ID from YAML header if available. */
   public static final DataKey<Boolean> ID_FROM_YAML = new DataKey<>("ID_FROM_YAML", false);
+  /** Allow XML DITA in Markdown. */
   public static final DataKey<Boolean> RAW_DITA = new DataKey<>("RAW_DITA", true);
 
   /**
+   * Parse as MDITA.
+   *
    * @deprecated use {@link #MDITA_EXTENDED_PROFILE} instead.
    */
   @Deprecated
   public static final DataKey<Boolean> LW_DITA = new DataKey<>("LW_DITA", false);
 
+  /** Parse as MDITA core profile. */
   public static final DataKey<Boolean> MDITA_CORE_PROFILE = new DataKey<>("MDITA_CORE_PROFILE", false);
+  /** Parse as MDITA extended profile. */
   public static final DataKey<Boolean> MDITA_EXTENDED_PROFILE = new DataKey<>("MDITA_EXTENDED_PROFILE", false);
+  /** Support concept, task, and reference specialization from heading class. */
   public static final DataKey<Boolean> SPECIALIZATION = new DataKey<>("SPECIALIZATION", false);
+  /** Generate DITA concept output. */
   public static final DataKey<Boolean> SPECIALIZATION_CONCEPT = new DataKey<>("SPECIALIZATION_CONCEPT", false);
+  /** Generate DITA task output. */
   public static final DataKey<Boolean> SPECIALIZATION_TASK = new DataKey<>("SPECIALIZATION_TASK", false);
+  /** Generate DITA reference output. */
   public static final DataKey<Boolean> SPECIALIZATION_REFERENCE = new DataKey<>("SPECIALIZATION_REFERENCE", false);
+  /** Fix missing root heading by reading title from either YAML heading or filename. */
   public static final DataKey<Boolean> WIKI = new DataKey<>("WIKI", false);
+  /** Fix missing root heading by reading title from either YAML heading or filename. */
   public static final DataKey<Boolean> FIX_ROOT_HEADING = new DataKey<>("FIXUP_ROOT_HEADING", false);
+  /** Generate DITA map output. */
   public static final DataKey<Boolean> MAP = new DataKey<>("MAP", false);
-  public static final DataKey<String> SOFT_BREAK = new DataKey<>("SOFT_BREAK", "\n");
-  public static final DataKey<String> HARD_BREAK = new DataKey<>("HARD_BREAK", "<br />\n");
-  public static final NullableDataKey<String> STRONG_EMPHASIS_STYLE_HTML_OPEN = new NullableDataKey<>(
-    "STRONG_EMPHASIS_STYLE_HTML_OPEN"
-  );
-  public static final NullableDataKey<String> STRONG_EMPHASIS_STYLE_HTML_CLOSE = new NullableDataKey<>(
-    "STRONG_EMPHASIS_STYLE_HTML_CLOSE"
-  );
-  public static final NullableDataKey<String> EMPHASIS_STYLE_HTML_OPEN = new NullableDataKey<>(
-    "EMPHASIS_STYLE_HTML_OPEN"
-  );
-  public static final NullableDataKey<String> EMPHASIS_STYLE_HTML_CLOSE = new NullableDataKey<>(
-    "EMPHASIS_STYLE_HTML_CLOSE"
-  );
-  public static final NullableDataKey<String> CODE_STYLE_HTML_OPEN = new NullableDataKey<>("CODE_STYLE_HTML_OPEN");
-  public static final NullableDataKey<String> CODE_STYLE_HTML_CLOSE = new NullableDataKey<>("CODE_STYLE_HTML_CLOSE");
-  public static final NullableDataKey<String> INLINE_CODE_SPLICE_CLASS = new NullableDataKey<>(
-    "INLINE_CODE_SPLICE_CLASS"
-  );
-  public static final DataKey<Boolean> PERCENT_ENCODE_URLS = SharedDataKeys.PERCENT_ENCODE_URLS;
-  public static final DataKey<Integer> INDENT_SIZE = SharedDataKeys.INDENT_SIZE;
-  public static final DataKey<Boolean> ESCAPE_HTML = new DataKey<>("ESCAPE_HTML", false);
-  public static final DataKey<Boolean> ESCAPE_HTML_BLOCKS = new DataKey<>("ESCAPE_HTML_BLOCKS", ESCAPE_HTML);
-  public static final DataKey<Boolean> ESCAPE_HTML_COMMENT_BLOCKS = new DataKey<>(
-    "ESCAPE_HTML_COMMENT_BLOCKS",
-    ESCAPE_HTML_BLOCKS
-  );
-  public static final DataKey<Boolean> ESCAPE_INLINE_HTML = new DataKey<>("ESCAPE_HTML_BLOCKS", ESCAPE_HTML);
-  public static final DataKey<Boolean> ESCAPE_INLINE_HTML_COMMENTS = new DataKey<>(
-    "ESCAPE_INLINE_HTML_COMMENTS",
-    ESCAPE_INLINE_HTML
-  );
+  //  public static final DataKey<String> SOFT_BREAK = new DataKey<>("SOFT_BREAK", "\n");
+  //  public static final DataKey<String> HARD_BREAK = new DataKey<>("HARD_BREAK", "<br />\n");
+  //  public static final NullableDataKey<String> STRONG_EMPHASIS_STYLE_HTML_OPEN = new NullableDataKey<>(
+  //    "STRONG_EMPHASIS_STYLE_HTML_OPEN"
+  //  );
+  //  public static final NullableDataKey<String> STRONG_EMPHASIS_STYLE_HTML_CLOSE = new NullableDataKey<>(
+  //    "STRONG_EMPHASIS_STYLE_HTML_CLOSE"
+  //  );
+  //  public static final NullableDataKey<String> EMPHASIS_STYLE_HTML_OPEN = new NullableDataKey<>(
+  //    "EMPHASIS_STYLE_HTML_OPEN"
+  //  );
+  //  public static final NullableDataKey<String> EMPHASIS_STYLE_HTML_CLOSE = new NullableDataKey<>(
+  //    "EMPHASIS_STYLE_HTML_CLOSE"
+  //  );
+  //  public static final NullableDataKey<String> CODE_STYLE_HTML_OPEN = new NullableDataKey<>("CODE_STYLE_HTML_OPEN");
+  //  public static final NullableDataKey<String> CODE_STYLE_HTML_CLOSE = new NullableDataKey<>("CODE_STYLE_HTML_CLOSE");
+  //  public static final NullableDataKey<String> INLINE_CODE_SPLICE_CLASS = new NullableDataKey<>(
+  //    "INLINE_CODE_SPLICE_CLASS"
+  //  );
+  //  public static final DataKey<Boolean> PERCENT_ENCODE_URLS = SharedDataKeys.PERCENT_ENCODE_URLS;
+  //  public static final DataKey<Integer> INDENT_SIZE = SharedDataKeys.INDENT_SIZE;
+  //  public static final DataKey<Boolean> ESCAPE_HTML = new DataKey<>("ESCAPE_HTML", false);
+  //  public static final DataKey<Boolean> ESCAPE_HTML_BLOCKS = new DataKey<>("ESCAPE_HTML_BLOCKS", ESCAPE_HTML);
+  //  public static final DataKey<Boolean> ESCAPE_HTML_COMMENT_BLOCKS = new DataKey<>(
+  //    "ESCAPE_HTML_COMMENT_BLOCKS",
+  //    ESCAPE_HTML_BLOCKS
+  //  );
+  //  public static final DataKey<Boolean> ESCAPE_INLINE_HTML = new DataKey<>("ESCAPE_HTML_BLOCKS", ESCAPE_HTML);
+  //  public static final DataKey<Boolean> ESCAPE_INLINE_HTML_COMMENTS = new DataKey<>(
+  //    "ESCAPE_INLINE_HTML_COMMENTS",
+  //    ESCAPE_INLINE_HTML
+  //  );
   public static final DataKey<Boolean> SUPPRESS_HTML = new DataKey<>("SUPPRESS_HTML", false);
   public static final DataKey<Boolean> SUPPRESS_HTML_BLOCKS = new DataKey<>("SUPPRESS_HTML_BLOCKS", SUPPRESS_HTML);
-  public static final DataKey<Boolean> SUPPRESS_HTML_COMMENT_BLOCKS = new DataKey<>(
-    "SUPPRESS_HTML_COMMENT_BLOCKS",
-    SUPPRESS_HTML_BLOCKS
-  );
-  public static final DataKey<Boolean> SUPPRESS_INLINE_HTML = new DataKey<>("SUPPRESS_INLINE_HTML", SUPPRESS_HTML);
-  public static final DataKey<Boolean> SUPPRESS_INLINE_HTML_COMMENTS = new DataKey<>(
-    "SUPPRESS_INLINE_HTML_COMMENTS",
-    SUPPRESS_INLINE_HTML
-  );
-  public static final DataKey<Boolean> SOURCE_WRAP_HTML = new DataKey<>("SOURCE_WRAP_HTML", false);
-  public static final DataKey<Boolean> SOURCE_WRAP_HTML_BLOCKS = new DataKey<>(
-    "SOURCE_WRAP_HTML_BLOCKS",
-    SOURCE_WRAP_HTML
-  );
+  //  public static final DataKey<Boolean> SUPPRESS_HTML_COMMENT_BLOCKS = new DataKey<>(
+  //    "SUPPRESS_HTML_COMMENT_BLOCKS",
+  //    SUPPRESS_HTML_BLOCKS
+  //  );
+  //  public static final DataKey<Boolean> SUPPRESS_INLINE_HTML = new DataKey<>("SUPPRESS_INLINE_HTML", SUPPRESS_HTML);
+  //  public static final DataKey<Boolean> SUPPRESS_INLINE_HTML_COMMENTS = new DataKey<>(
+  //    "SUPPRESS_INLINE_HTML_COMMENTS",
+  //    SUPPRESS_INLINE_HTML
+  //  );
+  //  public static final DataKey<Boolean> SOURCE_WRAP_HTML = new DataKey<>("SOURCE_WRAP_HTML", false);
+  //  public static final DataKey<Boolean> SOURCE_WRAP_HTML_BLOCKS = new DataKey<>(
+  //    "SOURCE_WRAP_HTML_BLOCKS",
+  //    SOURCE_WRAP_HTML
+  //  );
   public static final DataKey<Boolean> HEADER_ID_GENERATOR_RESOLVE_DUPES =
     SharedDataKeys.HEADER_ID_GENERATOR_RESOLVE_DUPES;
   public static final DataKey<String> HEADER_ID_GENERATOR_TO_DASH_CHARS =
     SharedDataKeys.HEADER_ID_GENERATOR_TO_DASH_CHARS;
-  public static final DataKey<String> HEADER_ID_GENERATOR_NON_DASH_CHARS =
-    SharedDataKeys.HEADER_ID_GENERATOR_NON_DASH_CHARS;
+  //  public static final DataKey<String> HEADER_ID_GENERATOR_NON_DASH_CHARS =
+  //    SharedDataKeys.HEADER_ID_GENERATOR_NON_DASH_CHARS;
   public static final DataKey<Boolean> HEADER_ID_GENERATOR_NO_DUPED_DASHES =
     SharedDataKeys.HEADER_ID_GENERATOR_NO_DUPED_DASHES;
-  public static final DataKey<Boolean> HEADER_ID_GENERATOR_NON_ASCII_TO_LOWERCASE =
-    SharedDataKeys.HEADER_ID_GENERATOR_NON_ASCII_TO_LOWERCASE;
-  public static final DataKey<Boolean> HEADER_ID_REF_TEXT_TRIM_LEADING_SPACES =
-    SharedDataKeys.HEADER_ID_REF_TEXT_TRIM_LEADING_SPACES;
-  public static final DataKey<Boolean> HEADER_ID_REF_TEXT_TRIM_TRAILING_SPACES =
-    SharedDataKeys.HEADER_ID_REF_TEXT_TRIM_TRAILING_SPACES;
-  public static final DataKey<Boolean> HEADER_ID_ADD_EMOJI_SHORTCUT = SharedDataKeys.HEADER_ID_ADD_EMOJI_SHORTCUT;
-  public static final DataKey<Boolean> RENDER_HEADER_ID = SharedDataKeys.RENDER_HEADER_ID;
-  public static final DataKey<Boolean> GENERATE_HEADER_ID = SharedDataKeys.GENERATE_HEADER_ID;
+  //  public static final DataKey<Boolean> HEADER_ID_GENERATOR_NON_ASCII_TO_LOWERCASE =
+  //    SharedDataKeys.HEADER_ID_GENERATOR_NON_ASCII_TO_LOWERCASE;
+  //  public static final DataKey<Boolean> HEADER_ID_REF_TEXT_TRIM_LEADING_SPACES =
+  //    SharedDataKeys.HEADER_ID_REF_TEXT_TRIM_LEADING_SPACES;
+  //  public static final DataKey<Boolean> HEADER_ID_REF_TEXT_TRIM_TRAILING_SPACES =
+  //    SharedDataKeys.HEADER_ID_REF_TEXT_TRIM_TRAILING_SPACES;
+  //  public static final DataKey<Boolean> HEADER_ID_ADD_EMOJI_SHORTCUT = SharedDataKeys.HEADER_ID_ADD_EMOJI_SHORTCUT;
+  //  public static final DataKey<Boolean> RENDER_HEADER_ID = SharedDataKeys.RENDER_HEADER_ID;
+  //  public static final DataKey<Boolean> GENERATE_HEADER_ID = SharedDataKeys.GENERATE_HEADER_ID;
   public static final DataKey<Boolean> DO_NOT_RENDER_LINKS = SharedDataKeys.DO_NOT_RENDER_LINKS;
   public static final DataKey<String> FENCED_CODE_LANGUAGE_CLASS_PREFIX = new DataKey<>(
     "FENCED_CODE_LANGUAGE_CLASS_PREFIX",
     "language-"
   ); // prefix to add to unmapped info strings
-  public static final DataKey<HashMap<String, String>> FENCED_CODE_LANGUAGE_CLASS_MAP = new DataKey<>(
-    "FENCED_CODE_LANGUAGE_CLASS_MAP",
-    HashMap::new
-  ); // info to language class mapping
+  //  public static final DataKey<HashMap<String, String>> FENCED_CODE_LANGUAGE_CLASS_MAP = new DataKey<>(
+  //    "FENCED_CODE_LANGUAGE_CLASS_MAP",
+  //    HashMap::new
+  //  ); // info to language class mapping
   public static final DataKey<String> FENCED_CODE_NO_LANGUAGE_CLASS = new DataKey<>(
     "FENCED_CODE_NO_LANGUAGE_CLASS",
     ""
   );
-  public static final DataKey<String> FENCED_CODE_LANGUAGE_DELIMITERS = new DataKey<>(
-    "FENCED_CODE_LANGUAGE_DELIMITERS",
-    " \t"
-  );
-  public static final DataKey<String> SOURCE_POSITION_ATTRIBUTE = new DataKey<>("SOURCE_POSITION_ATTRIBUTE", "");
-  public static final DataKey<Boolean> SOURCE_POSITION_PARAGRAPH_LINES = new DataKey<>(
-    "SOURCE_POSITION_PARAGRAPH_LINES",
-    false
-  );
-  public static final DataKey<String> TYPE = new DataKey<>("TYPE", "HTML");
-  public static final DataKey<ArrayList<TagRange>> TAG_RANGES = new DataKey<>("TAG_RANGES", ArrayList::new);
+  //  public static final DataKey<String> FENCED_CODE_LANGUAGE_DELIMITERS = new DataKey<>(
+  //    "FENCED_CODE_LANGUAGE_DELIMITERS",
+  //    " \t"
+  //  );
+  //  public static final DataKey<String> SOURCE_POSITION_ATTRIBUTE = new DataKey<>("SOURCE_POSITION_ATTRIBUTE", "");
+  //  public static final DataKey<Boolean> SOURCE_POSITION_PARAGRAPH_LINES = new DataKey<>(
+  //    "SOURCE_POSITION_PARAGRAPH_LINES",
+  //    false
+  //  );
+  //  public static final DataKey<String> TYPE = new DataKey<>("TYPE", "HTML");
+  //  public static final DataKey<ArrayList<TagRange>> TAG_RANGES = new DataKey<>("TAG_RANGES", ArrayList::new);
 
-  public static final DataKey<Boolean> RECHECK_UNDEFINED_REFERENCES = new DataKey<>(
-    "RECHECK_UNDEFINED_REFERENCES",
-    false
-  );
-  public static final DataKey<Boolean> OBFUSCATE_EMAIL = new DataKey<>("OBFUSCATE_EMAIL", false);
-  public static final DataKey<Boolean> OBFUSCATE_EMAIL_RANDOM = new DataKey<>("OBFUSCATE_EMAIL_RANDOM", true);
-  public static final DataKey<Boolean> HTML_BLOCK_OPEN_TAG_EOL = new DataKey<>("HTML_BLOCK_OPEN_TAG_EOL", true);
-  public static final DataKey<Boolean> HTML_BLOCK_CLOSE_TAG_EOL = new DataKey<>("HTML_BLOCK_CLOSE_TAG_EOL", true);
-  public static final DataKey<Boolean> UNESCAPE_HTML_ENTITIES = new DataKey<>("UNESCAPE_HTML_ENTITIES", true);
-  public static final DataKey<String> AUTOLINK_WWW_PREFIX = new DataKey<>("AUTOLINK_WWW_PREFIX", "http://");
+  //  public static final DataKey<Boolean> RECHECK_UNDEFINED_REFERENCES = new DataKey<>(
+  //    "RECHECK_UNDEFINED_REFERENCES",
+  //    false
+  //  );
+  //  public static final DataKey<Boolean> OBFUSCATE_EMAIL = new DataKey<>("OBFUSCATE_EMAIL", false);
+  //  public static final DataKey<Boolean> OBFUSCATE_EMAIL_RANDOM = new DataKey<>("OBFUSCATE_EMAIL_RANDOM", true);
+  //  public static final DataKey<Boolean> HTML_BLOCK_OPEN_TAG_EOL = new DataKey<>("HTML_BLOCK_OPEN_TAG_EOL", true);
+  //  public static final DataKey<Boolean> HTML_BLOCK_CLOSE_TAG_EOL = new DataKey<>("HTML_BLOCK_CLOSE_TAG_EOL", true);
+  //  public static final DataKey<Boolean> UNESCAPE_HTML_ENTITIES = new DataKey<>("UNESCAPE_HTML_ENTITIES", true);
+  //  public static final DataKey<String> AUTOLINK_WWW_PREFIX = new DataKey<>("AUTOLINK_WWW_PREFIX", "http://");
 
   // regex for suppressed link prefixes
-  public static final DataKey<String> SUPPRESSED_LINKS = new DataKey<>("SUPPRESSED_LINKS", "javascript:.*");
-  public static final DataKey<Boolean> NO_P_TAGS_USE_BR = new DataKey<>("NO_P_TAGS_USE_BR", false);
-  public static final DataKey<Boolean> EMBEDDED_ATTRIBUTE_PROVIDER = new DataKey<>("EMBEDDED_ATTRIBUTE_PROVIDER", true);
-
-  public static final DataKey<Integer> FORMAT_FLAGS = new DataKey<>(
-    "RENDERER_FORMAT_FLAGS",
-    LineAppendable.F_TRIM_LEADING_WHITESPACE
-  );
-  public static final DataKey<Integer> MAX_TRAILING_BLANK_LINES = SharedDataKeys.RENDERER_MAX_TRAILING_BLANK_LINES;
-  public static final DataKey<Integer> MAX_BLANK_LINES = SharedDataKeys.RENDERER_MAX_BLANK_LINES;
+  //  public static final DataKey<String> SUPPRESSED_LINKS = new DataKey<>("SUPPRESSED_LINKS", "javascript:.*");
+  //  public static final DataKey<Boolean> NO_P_TAGS_USE_BR = new DataKey<>("NO_P_TAGS_USE_BR", false);
+  //  public static final DataKey<Boolean> EMBEDDED_ATTRIBUTE_PROVIDER = new DataKey<>("EMBEDDED_ATTRIBUTE_PROVIDER", true);
+  //
+  //  public static final DataKey<Integer> FORMAT_FLAGS = new DataKey<>(
+  //    "RENDERER_FORMAT_FLAGS",
+  //    LineAppendable.F_TRIM_LEADING_WHITESPACE
+  //  );
+  //  public static final DataKey<Integer> MAX_TRAILING_BLANK_LINES = SharedDataKeys.RENDERER_MAX_TRAILING_BLANK_LINES;
+  //  public static final DataKey<Integer> MAX_BLANK_LINES = SharedDataKeys.RENDERER_MAX_BLANK_LINES;
 
   private final DitaRendererOptions ditaOptions;
   private final DataHolder options;

src/main/java/com/elovirta/dita/markdown/MarkdownReader.java

@@ -62,6 +62,8 @@ public class MarkdownReader implements XMLReader {
    *     <dd>Parse as MDITA extended profile.</dd>
    *     <dt><code>http://lwdita.org/sax/features/mdita-core-profile</code></dt>
    *     <dd>Parse as MDITA core profile.</dd>
+   *     <dt><code>http://lwdita.org/sax/features/raw-dita</code></dt>
+   *     <dd>Allow XML DITA in Markdown.</dd>
    *     <dt><code>http://lwdita.org/sax/features/specialization</code></dt>
    *     <dd>Support concept, task, and reference specialization from heading class.</dd>
    *     <dt><code>http://lwdita.org/sax/features/specialization-concept</code></dt>
@@ -71,9 +73,10 @@ public class MarkdownReader implements XMLReader {
    *     <dt><code>http://lwdita.org/sax/features/specialization-reference</code></dt>
    *     <dd>Generate DITA reference output.</dd>
    *     <dt><code>http://lwdita.org/sax/features/fix-root-heading</code></dt>
-   *     <dd>Fix missing root heading by reading title from either YAML heading or filename.</dd>
+   *     <dd>Fix missing root heading by reading title from either YAML heading or filename. Throws a SAX warning about the missing header.</dd>
    *     <dt><code>http://lwdita.org/sax/features/map</code></dt>
    *     <dd>Generate DITA map output.</dd>
+   *     <dd>Fix missing root heading by reading title from either YAML heading or filename. Does not throw a warning about the missing header.</dd>
    * </dl>
    */
   private static final Map<String, DataKey<Boolean>> FEATURES;

src/test/java/com/elovirta/dita/markdown/MarkdownReaderTest.java

@@ -137,6 +137,28 @@ public void test_missingHeader(String file) throws Exception {
           .set(Parser.EXTENSIONS, singletonList(YamlFrontMatterExtension.create()))
           .set(DitaRenderer.FIX_ROOT_HEADING, true)
           .set(DitaRenderer.ID_FROM_YAML, true)
+      );
+    final TestErrorHandler errorHandler = new TestErrorHandler();
+    reader.setErrorHandler(errorHandler);
+
+    run(getSrc() + file, getExp() + "wiki/" + file.replaceAll("\\.md$", ".dita"));
+
+    assertEquals(1, errorHandler.warnings.size());
+    var act = errorHandler.warnings.get(0);
+    assertEquals(1, act.getLineNumber());
+    assertEquals(1, act.getColumnNumber());
+    assertEquals("classpath:/markdown/" + file, act.getSystemId());
+    assertEquals("Document content doesn't start with heading", act.getMessage());
+  }
+
+  @ParameterizedTest
+  @ValueSource(strings = { "missing_root_header.md", "missing_root_header_with_yaml.md" })
+  public void test_missingHeader_wiki(String file) throws Exception {
+    reader =
+      new MarkdownReader(
+        new MutableDataSet()
+          .set(Parser.EXTENSIONS, singletonList(YamlFrontMatterExtension.create()))
+          .set(DitaRenderer.ID_FROM_YAML, true)
           .set(DitaRenderer.WIKI, true)
       );
     final TestErrorHandler errorHandler = new TestErrorHandler();