From f5cc8fe3e14b5f39027c038c35fd9e2023556adb Mon Sep 17 00:00:00 2001
From: James Perkins <jperkins@redhat.com>
Date: Fri, 21 Aug 2020 11:37:09 -0700
Subject: [PATCH] [#1] Support more formatting options for the generated
 asciidoc.

---
 pom.xml                                       |   9 +-
 .../tool/plugin/PluginAdocGenerator.java      |  19 +--
 .../plugin/formatter/AbstractNodeVisitor.java | 109 ++++++++++++++++++
 .../formatter/AppendableNodeVisitor.java      |  53 +++++++++
 .../plugin/formatter/BoldNodeVisitor.java     |  46 ++++++++
 .../plugin/formatter/BreakNodeVisitor.java    |  46 ++++++++
 .../formatter/CodeBlockNodeVisitor.java       |  62 ++++++++++
 .../formatter/CompositeNodeVisitor.java       |  70 +++++++++++
 .../tool/plugin/formatter/Formatters.java     |  55 +++++++++
 .../plugin/formatter/ItalicNodeVisitor.java   |  46 ++++++++
 .../plugin/formatter/ListNodeVisitor.java     |  72 ++++++++++++
 .../formatter/ParagraphNodeVisitor.java       |  46 ++++++++
 .../plugin/formatter/TextNodeVisitor.java     |  48 ++++++++
 13 files changed, 672 insertions(+), 9 deletions(-)
 create mode 100644 src/main/java/org/wildfly/tool/plugin/formatter/AbstractNodeVisitor.java
 create mode 100644 src/main/java/org/wildfly/tool/plugin/formatter/AppendableNodeVisitor.java
 create mode 100644 src/main/java/org/wildfly/tool/plugin/formatter/BoldNodeVisitor.java
 create mode 100644 src/main/java/org/wildfly/tool/plugin/formatter/BreakNodeVisitor.java
 create mode 100644 src/main/java/org/wildfly/tool/plugin/formatter/CodeBlockNodeVisitor.java
 create mode 100644 src/main/java/org/wildfly/tool/plugin/formatter/CompositeNodeVisitor.java
 create mode 100644 src/main/java/org/wildfly/tool/plugin/formatter/Formatters.java
 create mode 100644 src/main/java/org/wildfly/tool/plugin/formatter/ItalicNodeVisitor.java
 create mode 100644 src/main/java/org/wildfly/tool/plugin/formatter/ListNodeVisitor.java
 create mode 100644 src/main/java/org/wildfly/tool/plugin/formatter/ParagraphNodeVisitor.java
 create mode 100644 src/main/java/org/wildfly/tool/plugin/formatter/TextNodeVisitor.java

diff --git a/pom.xml b/pom.xml
index 98e5575..9bb8cd6 100644
--- a/pom.xml
+++ b/pom.xml
@@ -1,7 +1,7 @@
 <?xml version="1.0" encoding="UTF-8"?>
 <!--
 
-    Copyright 2016-2018 Red Hat, Inc. and/or its affiliates
+    Copyright 2016-2020 Red Hat, Inc. and/or its affiliates
     and other contributors as indicated by the @author tags.
 
     Licensed under the Apache License, Version 2.0 (the "License");
@@ -31,6 +31,7 @@
 
   <packaging>maven-plugin</packaging>
   <properties>
+    <version.org.jsoup.jsoup>1.13.1</version.org.jsoup.jsoup>
     <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
   </properties>
 
@@ -64,5 +65,11 @@
       <artifactId>maven-plugin-annotations</artifactId>
       <type>jar</type>
     </dependency>
+
+    <dependency>
+      <groupId>org.jsoup</groupId>
+      <artifactId>jsoup</artifactId>
+      <version>${version.org.jsoup.jsoup}</version>
+    </dependency>
   </dependencies>
 </project>
\ No newline at end of file
diff --git a/src/main/java/org/wildfly/tool/plugin/PluginAdocGenerator.java b/src/main/java/org/wildfly/tool/plugin/PluginAdocGenerator.java
index 9f7c767..0902748 100644
--- a/src/main/java/org/wildfly/tool/plugin/PluginAdocGenerator.java
+++ b/src/main/java/org/wildfly/tool/plugin/PluginAdocGenerator.java
@@ -1,5 +1,5 @@
 /*
- * Copyright 2016-2018 Red Hat, Inc. and/or its affiliates
+ * Copyright 2016-2020 Red Hat, Inc. and/or its affiliates
  * and other contributors as indicated by the @author tags.
  *
  * Licensed under the Apache License, Version 2.0 (the "License");
@@ -25,6 +25,7 @@
 import java.util.List;
 import java.util.Locale;
 import java.util.ResourceBundle;
+
 import org.apache.maven.plugin.descriptor.MojoDescriptor;
 import org.apache.maven.plugin.descriptor.Parameter;
 import org.apache.maven.tools.plugin.ExtendedMojoDescriptor;
@@ -33,6 +34,7 @@
 import org.apache.maven.tools.plugin.generator.GeneratorUtils;
 import org.codehaus.plexus.util.IOUtil;
 import org.codehaus.plexus.util.StringUtils;
+import org.wildfly.tool.plugin.formatter.Formatters;
 
 /**
  *
@@ -434,8 +436,8 @@ private void writeParameterList(MojoDescriptor mojoDescriptor, String title, Lis
                 }
             }
 
-            // description
-            w.print("|");
+            // description, start with "a|" to allow for asciidoc formatting within the cell.
+            w.print(" a|");
             String description;
             if (StringUtils.isNotEmpty(parameter.getDeprecated())) {
                 description = format("pluginasciidoc.mojodescriptor.parameter.deprecated",
@@ -445,7 +447,11 @@ private void writeParameterList(MojoDescriptor mojoDescriptor, String title, Lis
             } else {
                 description = getString("pluginasciidoc.nodescription");
             }
-            w.println(description + " +");
+            w.println(description);
+            w.println();
+            // Print a new line instead of a "+" as the next line should not be associated as a continuation of this
+            // line.
+            ///w.println();
 
             if (StringUtils.isNotEmpty(parameter.getDefaultValue())) {
                 w.print(format("pluginasciidoc.mojodescriptor.parameter.defaultValue",
@@ -472,10 +478,7 @@ private void writeParameterList(MojoDescriptor mojoDescriptor, String title, Lis
 
     private String makeHtmlValid(String description) {
         String result = GeneratorUtils.makeHtmlValid(description);
-        result = result.replaceAll("<code>", "`");
-        result = result.replaceAll("</code>", "`");
-        result = result.replaceAll("<br/>", " +");
-        result = result.replaceAll("<br />", " +");
+        result = Formatters.format(result);
         return result;
     }
 
diff --git a/src/main/java/org/wildfly/tool/plugin/formatter/AbstractNodeVisitor.java b/src/main/java/org/wildfly/tool/plugin/formatter/AbstractNodeVisitor.java
new file mode 100644
index 0000000..535c323
--- /dev/null
+++ b/src/main/java/org/wildfly/tool/plugin/formatter/AbstractNodeVisitor.java
@@ -0,0 +1,109 @@
+/*
+ * Copyright 2016-2020 Red Hat, Inc. and/or its affiliates
+ * and other contributors as indicated by the @author tags.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.wildfly.tool.plugin.formatter;
+
+import org.jsoup.nodes.Node;
+import org.jsoup.nodes.TextNode;
+
+/**
+ * @author <a href="mailto:jperkins@redhat.com">James R. Perkins</a>
+ */
+abstract class AbstractNodeVisitor implements AppendableNodeVisitor {
+    private final StringBuilder builder;
+
+    AbstractNodeVisitor(final StringBuilder builder) {
+        this.builder = builder;
+    }
+
+    @Override
+    public AbstractNodeVisitor append(final CharSequence csq) {
+        builder.append(csq);
+        return this;
+    }
+
+    @Override
+    public AbstractNodeVisitor append(final CharSequence csq, final int start, final int end) {
+        builder.append(csq, start, end);
+        return this;
+    }
+
+    @Override
+    public AbstractNodeVisitor append(final char c) {
+        builder.append(c);
+        return this;
+    }
+
+    @Override
+    public AppendableNodeVisitor appendNewLine() {
+        builder.append(System.lineSeparator());
+        return this;
+    }
+
+    @Override
+    public String toString() {
+        return builder.toString();
+    }
+
+    /**
+     * Gets the possible text for a node. If the node is not a {@link TextNode} and empty string is returned.
+     *
+     * @param node the node to get the text from
+     *
+     * @return the text for the node or an empty string
+     */
+    String getText(final Node node) {
+        if (node instanceof TextNode) {
+            final TextNode textNode = (TextNode) node;
+            return textNode.getWholeText();
+        }
+        return "";
+    }
+
+    /**
+     * Gets the possible text for the first child node. If the child node is not a {@link TextNode} and empty string is
+     * returned.
+     *
+     * @param node the node to get the first child from
+     *
+     * @return the text for the first child node or an empty string
+     */
+    String getChildText(final Node node) {
+        if (node.childNodeSize() > 0) {
+            return getText(node.childNode(0));
+        }
+        return "";
+    }
+
+    /**
+     * Checks the node name against the names and returns {@code true} if one of the names matches the nodes name.
+     *
+     * @param node  the node to check
+     * @param names the names that may match
+     *
+     * @return {@code true} if the node name matches one of the names, otherwise {@code false}
+     */
+    boolean nodeNameMatches(final Node node, final String... names) {
+        final String nodeName = node.nodeName();
+        for (String name : names) {
+            if (name.equals(nodeName)) {
+                return true;
+            }
+        }
+        return false;
+    }
+}
diff --git a/src/main/java/org/wildfly/tool/plugin/formatter/AppendableNodeVisitor.java b/src/main/java/org/wildfly/tool/plugin/formatter/AppendableNodeVisitor.java
new file mode 100644
index 0000000..8c4c34b
--- /dev/null
+++ b/src/main/java/org/wildfly/tool/plugin/formatter/AppendableNodeVisitor.java
@@ -0,0 +1,53 @@
+/*
+ * Copyright 2016-2020 Red Hat, Inc. and/or its affiliates
+ * and other contributors as indicated by the @author tags.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.wildfly.tool.plugin.formatter;
+
+import org.jsoup.nodes.Node;
+import org.jsoup.select.NodeVisitor;
+
+/**
+ * @author <a href="mailto:jperkins@redhat.com">James R. Perkins</a>
+ */
+interface AppendableNodeVisitor extends Appendable, NodeVisitor {
+
+
+    @Override
+    AppendableNodeVisitor append(CharSequence csq);
+
+    @Override
+    AppendableNodeVisitor append(CharSequence csq, int start, int end);
+
+    @Override
+    AppendableNodeVisitor append(char c);
+
+    /**
+     * Appends the platforms {@linkplain System#lineSeparator() line separator}.
+     *
+     * @return this appender
+     */
+    AppendableNodeVisitor appendNewLine();
+
+    /**
+     * Indicates whether or not this visitor can process the node.
+     *
+     * @param node the node to check
+     *
+     * @return {@code true} if this visitor can process the node, otherwise {@code null}
+     */
+    boolean canProcess(Node node);
+}
diff --git a/src/main/java/org/wildfly/tool/plugin/formatter/BoldNodeVisitor.java b/src/main/java/org/wildfly/tool/plugin/formatter/BoldNodeVisitor.java
new file mode 100644
index 0000000..f624c3a
--- /dev/null
+++ b/src/main/java/org/wildfly/tool/plugin/formatter/BoldNodeVisitor.java
@@ -0,0 +1,46 @@
+/*
+ * Copyright 2016-2020 Red Hat, Inc. and/or its affiliates
+ * and other contributors as indicated by the @author tags.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.wildfly.tool.plugin.formatter;
+
+import org.jsoup.nodes.Node;
+import org.jsoup.select.NodeVisitor;
+
+/**
+ * @author <a href="mailto:jperkins@redhat.com">James R. Perkins</a>
+ */
+class BoldNodeVisitor extends AbstractNodeVisitor implements NodeVisitor {
+
+    BoldNodeVisitor(final StringBuilder builder) {
+        super(builder);
+    }
+
+    @Override
+    public void head(final Node node, final int depth) {
+        append('*');
+    }
+
+    @Override
+    public void tail(final Node node, final int depth) {
+        append("* ");
+    }
+
+    @Override
+    public boolean canProcess(final Node node) {
+        return nodeNameMatches(node, "b", "strong");
+    }
+}
diff --git a/src/main/java/org/wildfly/tool/plugin/formatter/BreakNodeVisitor.java b/src/main/java/org/wildfly/tool/plugin/formatter/BreakNodeVisitor.java
new file mode 100644
index 0000000..6bd15ea
--- /dev/null
+++ b/src/main/java/org/wildfly/tool/plugin/formatter/BreakNodeVisitor.java
@@ -0,0 +1,46 @@
+/*
+ * Copyright 2016-2020 Red Hat, Inc. and/or its affiliates
+ * and other contributors as indicated by the @author tags.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.wildfly.tool.plugin.formatter;
+
+import org.jsoup.nodes.Node;
+import org.jsoup.select.NodeVisitor;
+
+/**
+ * @author <a href="mailto:jperkins@redhat.com">James R. Perkins</a>
+ */
+class BreakNodeVisitor extends AbstractNodeVisitor implements NodeVisitor {
+
+    BreakNodeVisitor(final StringBuilder builder) {
+        super(builder);
+    }
+
+    @Override
+    public void head(final Node node, final int depth) {
+        append(" +");
+    }
+
+    @Override
+    public void tail(final Node node, final int depth) {
+        appendNewLine();
+    }
+
+    @Override
+    public boolean canProcess(final Node node) {
+        return nodeNameMatches(node, "br");
+    }
+}
diff --git a/src/main/java/org/wildfly/tool/plugin/formatter/CodeBlockNodeVisitor.java b/src/main/java/org/wildfly/tool/plugin/formatter/CodeBlockNodeVisitor.java
new file mode 100644
index 0000000..138d3d0
--- /dev/null
+++ b/src/main/java/org/wildfly/tool/plugin/formatter/CodeBlockNodeVisitor.java
@@ -0,0 +1,62 @@
+/*
+ * Copyright 2016-2020 Red Hat, Inc. and/or its affiliates
+ * and other contributors as indicated by the @author tags.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.wildfly.tool.plugin.formatter;
+
+import org.jsoup.nodes.Node;
+import org.jsoup.select.NodeVisitor;
+
+/**
+ * @author <a href="mailto:jperkins@redhat.com">James R. Perkins</a>
+ */
+class CodeBlockNodeVisitor extends AbstractNodeVisitor implements NodeVisitor {
+
+    private String currentText = "";
+
+    CodeBlockNodeVisitor(final StringBuilder builder) {
+        super(builder);
+    }
+
+    @Override
+    public void head(final Node node, final int depth) {
+        currentText = getChildText(node);
+        // Determine if we need a code block or the block is on a single line
+        if (currentText.contains(System.lineSeparator())) {
+            appendNewLine()
+                    .append("----")
+                    .appendNewLine();
+        } else {
+            append('`');
+        }
+    }
+
+    @Override
+    public void tail(final Node node, final int depth) {
+        if (currentText.contains(System.lineSeparator())) {
+            appendNewLine()
+                    .append("----")
+                    .appendNewLine();
+        } else {
+            append('`');
+        }
+    }
+
+    @Override
+    public boolean canProcess(final Node node) {
+        return nodeNameMatches(node, "code", "pre");
+    }
+}
diff --git a/src/main/java/org/wildfly/tool/plugin/formatter/CompositeNodeVisitor.java b/src/main/java/org/wildfly/tool/plugin/formatter/CompositeNodeVisitor.java
new file mode 100644
index 0000000..639ef66
--- /dev/null
+++ b/src/main/java/org/wildfly/tool/plugin/formatter/CompositeNodeVisitor.java
@@ -0,0 +1,70 @@
+/*
+ * Copyright 2016-2020 Red Hat, Inc. and/or its affiliates
+ * and other contributors as indicated by the @author tags.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.wildfly.tool.plugin.formatter;
+
+import java.util.Arrays;
+import java.util.Collection;
+
+import org.jsoup.nodes.Node;
+import org.jsoup.select.NodeVisitor;
+
+/**
+ * @author <a href="mailto:jperkins@redhat.com">James R. Perkins</a>
+ */
+class CompositeNodeVisitor implements NodeVisitor {
+    private final StringBuilder builder;
+    private final Collection<AppendableNodeVisitor> visitors;
+
+    CompositeNodeVisitor(final StringBuilder builder, final AppendableNodeVisitor... visitors) {
+        this.builder = builder;
+        this.visitors = Arrays.asList(visitors);
+    }
+
+    @Override
+    public void head(final Node node, final int depth) {
+        boolean processed = false;
+        for (AppendableNodeVisitor visitor : visitors) {
+            if (visitor.canProcess(node)) {
+                visitor.head(node, depth);
+                processed = true;
+            }
+        }
+        if (!processed && notMatches(node,"body", "html", "head")) {
+            builder.append(node.toString());
+        }
+    }
+
+    @Override
+    public void tail(final Node node, final int depth) {
+        for (AppendableNodeVisitor visitor : visitors) {
+            if (visitor.canProcess(node)) {
+                visitor.tail(node, depth);
+            }
+        }
+    }
+
+    private static boolean notMatches(final Node node, final String... names) {
+        final String nodeName = node.nodeName();
+        for (String name : names) {
+            if (name.equals(nodeName)) {
+                return false;
+            }
+        }
+        return true;
+    }
+}
diff --git a/src/main/java/org/wildfly/tool/plugin/formatter/Formatters.java b/src/main/java/org/wildfly/tool/plugin/formatter/Formatters.java
new file mode 100644
index 0000000..de1d052
--- /dev/null
+++ b/src/main/java/org/wildfly/tool/plugin/formatter/Formatters.java
@@ -0,0 +1,55 @@
+/*
+ * Copyright 2016-2020 Red Hat, Inc. and/or its affiliates
+ * and other contributors as indicated by the @author tags.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.wildfly.tool.plugin.formatter;
+
+import org.jsoup.Jsoup;
+import org.jsoup.nodes.Document;
+import org.jsoup.select.NodeTraversor;
+
+/**
+ * @author <a href="mailto:jperkins@redhat.com">James R. Perkins</a>
+ */
+public class Formatters {
+
+    /**
+     * Formats HTML tags into asciidoc equivalents.
+     *
+     * @param text the text to convert
+     *
+     * @return the formatted test
+     */
+    public static String format(final String text) {
+        final Document document = Jsoup.parseBodyFragment(text);
+        // No need to process if there is no HTML
+        if (document.text().equals(text)) {
+            return text;
+        }
+        final StringBuilder result = new StringBuilder();
+        final AppendableNodeVisitor[] visitors = {
+                new ListNodeVisitor(result),
+                new BreakNodeVisitor(result),
+                new CodeBlockNodeVisitor(result),
+                new ParagraphNodeVisitor(result),
+                new BoldNodeVisitor(result),
+                new ItalicNodeVisitor(result),
+                new TextNodeVisitor(result),
+        };
+        NodeTraversor.traverse(new CompositeNodeVisitor(result, visitors), document.children());
+        return result.toString();
+    }
+}
diff --git a/src/main/java/org/wildfly/tool/plugin/formatter/ItalicNodeVisitor.java b/src/main/java/org/wildfly/tool/plugin/formatter/ItalicNodeVisitor.java
new file mode 100644
index 0000000..11ecf72
--- /dev/null
+++ b/src/main/java/org/wildfly/tool/plugin/formatter/ItalicNodeVisitor.java
@@ -0,0 +1,46 @@
+/*
+ * Copyright 2016-2020 Red Hat, Inc. and/or its affiliates
+ * and other contributors as indicated by the @author tags.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.wildfly.tool.plugin.formatter;
+
+import org.jsoup.nodes.Node;
+import org.jsoup.select.NodeVisitor;
+
+/**
+ * @author <a href="mailto:jperkins@redhat.com">James R. Perkins</a>
+ */
+class ItalicNodeVisitor extends AbstractNodeVisitor implements NodeVisitor {
+
+    ItalicNodeVisitor(final StringBuilder builder) {
+        super(builder);
+    }
+
+    @Override
+    public void head(final Node node, final int depth) {
+        append('_');
+    }
+
+    @Override
+    public void tail(final Node node, final int depth) {
+        append("_ ");
+    }
+
+    @Override
+    public boolean canProcess(final Node node) {
+        return nodeNameMatches(node, "i", "em");
+    }
+}
diff --git a/src/main/java/org/wildfly/tool/plugin/formatter/ListNodeVisitor.java b/src/main/java/org/wildfly/tool/plugin/formatter/ListNodeVisitor.java
new file mode 100644
index 0000000..2315c2d
--- /dev/null
+++ b/src/main/java/org/wildfly/tool/plugin/formatter/ListNodeVisitor.java
@@ -0,0 +1,72 @@
+/*
+ * Copyright 2016-2020 Red Hat, Inc. and/or its affiliates
+ * and other contributors as indicated by the @author tags.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.wildfly.tool.plugin.formatter;
+
+import org.jsoup.nodes.Node;
+import org.jsoup.select.NodeVisitor;
+
+/**
+ * @author <a href="mailto:jperkins@redhat.com">James R. Perkins</a>
+ */
+class ListNodeVisitor extends AbstractNodeVisitor implements NodeVisitor {
+    private int listDepth = 0;
+    private char prefixChar = '*';
+
+    ListNodeVisitor(final StringBuilder builder) {
+        super(builder);
+    }
+
+    @Override
+    public void head(final Node node, final int depth) {
+        if (nodeNameMatches(node, "ul", "ol")) {
+            listDepth++;
+            if ("ol".equals(node.nodeName())) {
+                prefixChar = '.';
+            } else {
+                prefixChar = '*';
+            }
+            if (listDepth == 1) {
+                appendNewLine();
+            }
+        } else {
+            if (node.childNodeSize() > 0) {
+                final String text = getText(node.childNode(0));
+                if (!text.trim().isEmpty()) {
+                    for (int i = 0; i < listDepth; i++) {
+                        append(prefixChar);
+                    }
+                    append(' ');
+                }
+            }
+        }
+    }
+
+    @Override
+    public void tail(final Node node, final int depth) {
+        if (nodeNameMatches(node, "ul", "ol")) {
+            listDepth = Math.max(0, listDepth - 1);
+        } else {
+            appendNewLine();
+        }
+    }
+
+    @Override
+    public boolean canProcess(final Node node) {
+        return nodeNameMatches(node, "ul", "ol", "li");
+    }
+}
diff --git a/src/main/java/org/wildfly/tool/plugin/formatter/ParagraphNodeVisitor.java b/src/main/java/org/wildfly/tool/plugin/formatter/ParagraphNodeVisitor.java
new file mode 100644
index 0000000..4dabc91
--- /dev/null
+++ b/src/main/java/org/wildfly/tool/plugin/formatter/ParagraphNodeVisitor.java
@@ -0,0 +1,46 @@
+/*
+ * Copyright 2016-2020 Red Hat, Inc. and/or its affiliates
+ * and other contributors as indicated by the @author tags.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.wildfly.tool.plugin.formatter;
+
+import org.jsoup.nodes.Node;
+import org.jsoup.select.NodeVisitor;
+
+/**
+ * @author <a href="mailto:jperkins@redhat.com">James R. Perkins</a>
+ */
+class ParagraphNodeVisitor extends AbstractNodeVisitor implements NodeVisitor {
+
+    ParagraphNodeVisitor(final StringBuilder builder) {
+        super(builder);
+    }
+
+    @Override
+    public void head(final Node node, final int depth) {
+        appendNewLine();
+    }
+
+    @Override
+    public void tail(final Node node, final int depth) {
+        appendNewLine();
+    }
+
+    @Override
+    public boolean canProcess(final Node node) {
+        return nodeNameMatches(node, "p", "div");
+    }
+}
diff --git a/src/main/java/org/wildfly/tool/plugin/formatter/TextNodeVisitor.java b/src/main/java/org/wildfly/tool/plugin/formatter/TextNodeVisitor.java
new file mode 100644
index 0000000..5501afd
--- /dev/null
+++ b/src/main/java/org/wildfly/tool/plugin/formatter/TextNodeVisitor.java
@@ -0,0 +1,48 @@
+/*
+ * Copyright 2016-2020 Red Hat, Inc. and/or its affiliates
+ * and other contributors as indicated by the @author tags.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ *
+ *   http://www.apache.org/licenses/LICENSE-2.0
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+package org.wildfly.tool.plugin.formatter;
+
+import org.jsoup.nodes.Node;
+import org.jsoup.select.NodeVisitor;
+
+/**
+ * @author <a href="mailto:jperkins@redhat.com">James R. Perkins</a>
+ */
+class TextNodeVisitor extends AbstractNodeVisitor implements NodeVisitor {
+
+    TextNodeVisitor(final StringBuilder builder) {
+        super(builder);
+    }
+
+    @Override
+    public void head(final Node node, final int depth) {
+        final String text = getText(node);
+        if (!text.isEmpty() && !text.trim().isEmpty()) {
+            append(text);
+        }
+    }
+
+    @Override
+    public void tail(final Node node, final int depth) {
+    }
+
+    @Override
+    public boolean canProcess(final Node node) {
+        return nodeNameMatches(node, "#text");
+    }
+}