From 653eebfad5d4b9fe2149225e502ed5884f32511c Mon Sep 17 00:00:00 2001
From: Harry Huang <harryhuang2652@qq.com>
Date: Thu, 13 Feb 2025 21:37:30 +0800
Subject: [PATCH 01/10] chore: add commonmark-java lib

---
 .idea/gradle.xml | 1 +
 build.gradle     | 5 +++++
 2 files changed, 6 insertions(+)

diff --git a/.idea/gradle.xml b/.idea/gradle.xml
index 47784b0d..724a0f8d 100644
--- a/.idea/gradle.xml
+++ b/.idea/gradle.xml
@@ -5,6 +5,7 @@
     <option name="linkedExternalProjectsSettings">
       <GradleProjectSettings>
         <option name="externalProjectPath" value="$PROJECT_DIR$" />
+        <option name="gradleJvm" value="17" />
         <option name="modules">
           <set>
             <option value="$PROJECT_DIR$" />
diff --git a/build.gradle b/build.gradle
index f865a1fe..22f49597 100644
--- a/build.gradle
+++ b/build.gradle
@@ -70,6 +70,11 @@ project(":core") {
         api "com.jfoenix:jfoenix:9.0.1"
         // FastJson
         api "com.alibaba:fastjson:2.0.39"
+        // CommonMark
+        api "org.commonmark:commonmark:0.24.0"
+        api "org.commonmark:commonmark-ext-autolink:0.24.0"
+        api "org.commonmark:commonmark-ext-gfm-strikethrough:0.24.0"
+        api "org.commonmark:commonmark-ext-gfm-tables:0.24.0"
         // Log4j
         api "apache-log4j:log4j:1.2.15"
         // TiniPinyin

From d4af4016ea8d037f032e1f4211e38958ef1e5dc8 Mon Sep 17 00:00:00 2001
From: Harry Huang <harryhuang2652@qq.com>
Date: Thu, 13 Feb 2025 22:16:16 +0800
Subject: [PATCH 02/10] feat(mdRender): basic md renderer

---
 .../utils/markdown/CoreFxmlNodeRenderer.java  | 354 ++++++++++++++++++
 .../arkpets/utils/markdown/FxmlConvertor.java |  45 +++
 .../arkpets/utils/markdown/FxmlPrefabs.java   |  77 ++++
 3 files changed, 476 insertions(+)
 create mode 100644 desktop/src/cn/harryh/arkpets/utils/markdown/CoreFxmlNodeRenderer.java
 create mode 100644 desktop/src/cn/harryh/arkpets/utils/markdown/FxmlConvertor.java
 create mode 100644 desktop/src/cn/harryh/arkpets/utils/markdown/FxmlPrefabs.java

diff --git a/desktop/src/cn/harryh/arkpets/utils/markdown/CoreFxmlNodeRenderer.java b/desktop/src/cn/harryh/arkpets/utils/markdown/CoreFxmlNodeRenderer.java
new file mode 100644
index 00000000..8471212e
--- /dev/null
+++ b/desktop/src/cn/harryh/arkpets/utils/markdown/CoreFxmlNodeRenderer.java
@@ -0,0 +1,354 @@
+/** Copyright (c) 2022-2025, Harry Huang
+ * At GPL-3.0 License
+ */
+package cn.harryh.arkpets.utils.markdown;
+
+import org.commonmark.node.*;
+import org.commonmark.renderer.NodeRenderer;
+import org.commonmark.renderer.html.HtmlNodeRendererContext;
+import org.commonmark.renderer.html.HtmlWriter;
+
+import java.util.HashMap;
+import java.util.LinkedHashMap;
+import java.util.Map;
+import java.util.Set;
+
+
+/** The modded node renderer that renders all the core nodes to FXML used by JavaFX.
+ * This implementation is adapted from {@link org.commonmark.renderer.html.HtmlRenderer} class.
+ */
+public class CoreFxmlNodeRenderer extends AbstractVisitor implements NodeRenderer {
+    protected final HtmlNodeRendererContext context;
+    private final HtmlWriter writer;
+    private final Map<ListBlock, Integer> listItemCount;
+
+    public CoreFxmlNodeRenderer(HtmlNodeRendererContext context) {
+        this.context = context;
+        this.writer = context.getWriter();
+        this.listItemCount = new HashMap<>(4);
+    }
+
+    @Override
+    public Set<Class<? extends Node>> getNodeTypes() {
+        return Set.of(
+                Document.class, Heading.class, Paragraph.class,
+                BlockQuote.class, BulletList.class, FencedCodeBlock.class,
+                HtmlBlock.class, ThematicBreak.class, IndentedCodeBlock.class,
+                Link.class, ListItem.class, OrderedList.class,
+                Image.class, Emphasis.class, StrongEmphasis.class,
+                Text.class, Code.class, HtmlInline.class,
+                SoftLineBreak.class, HardLineBreak.class
+        );
+    }
+
+    @Override
+    public void render(Node node) {
+        node.accept(this);
+    }
+
+    @Override
+    public void visit(Document document) {
+        // FXML headers
+        writer.raw(
+                "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +
+                        "<?import javafx.scene.control.*?>\n" +
+                        "<?import javafx.scene.layout.*?>\n" +
+                        "<?import javafx.scene.shape.*?>\n" +
+                        "<?import javafx.scene.text.*?>\n" +
+                        "<?import java.lang.*?>\n"
+        );
+
+        // Use VBox to wrap the whole document
+        writer.tag("VBox", FxmlPrefabs.DOCUMENT.getAttrs());
+        writer.line();
+
+        visitChildren(document);
+
+        writer.tag("/VBox");
+        writer.line();
+    }
+
+    @Override
+    public void visit(Heading heading) {
+        writer.tag("TextFlow", switch (heading.getLevel()) {
+            case 1 -> FxmlPrefabs.H1.getAttrs();
+            case 2 -> FxmlPrefabs.H2.getAttrs();
+            case 3 -> FxmlPrefabs.H3.getAttrs();
+            default -> FxmlPrefabs.H4.getAttrs();
+        });
+        writer.line();
+
+        writer.tag("Text", FxmlPrefabs.TEXT.getAttrs());
+        visitChildren(heading);
+        writer.tag("/Text");
+        writer.line();
+
+        writer.tag("/TextFlow");
+        writer.line();
+    }
+
+    @Override
+    public void visit(Paragraph paragraph) {
+        writer.tag("TextFlow");
+        writer.line();
+        writer.tag("Text");
+        writer.line();
+
+        visitChildren(paragraph);
+
+        writer.tag("/Text");
+        writer.line();
+        writer.tag("/TextFlow");
+        writer.line();
+    }
+
+    @Override
+    public void visit(BlockQuote blockQuote) {
+        writer.tag("VBox", FxmlPrefabs.BLOCK_QUOTE.getAttrs());
+        writer.line();
+
+        visitChildren(blockQuote);
+
+        writer.tag("/VBox");
+        writer.line();
+    }
+
+    @Override
+    public void visit(BulletList bulletList) {
+        writer.tag("VBox");
+        writer.line();
+
+        visitChildren(bulletList);
+
+        writer.tag("/VBox");
+        writer.line();
+    }
+
+    @Override
+    public void visit(FencedCodeBlock fencedCodeBlock) {
+        String literal = fencedCodeBlock.getLiteral();
+        Map<String, String> attrs = new LinkedHashMap<>();
+        String info = fencedCodeBlock.getInfo();
+        if (info != null && !info.isEmpty()) {
+            int space = info.indexOf(" ");
+            String language = space == -1 ? info : info.substring(0, space);
+            attrs.put("class", "language-" + language);
+        }
+        renderCodeBlock(literal);
+    }
+
+    @Override
+    public void visit(HtmlBlock htmlBlock) {
+        // TODO Not implemented
+    }
+
+    @Override
+    public void visit(ThematicBreak thematicBreak) {
+        writer.tag("Separator", Map.of(), true);
+        writer.line();
+    }
+
+    @Override
+    public void visit(IndentedCodeBlock indentedCodeBlock) {
+        writer.tag("VBox", FxmlPrefabs.BLOCK_QUOTE.getAttrs());
+        writer.line();
+
+        visitChildren(indentedCodeBlock);
+
+        writer.tag("/VBox");
+        writer.line();
+    }
+
+    @Override
+    public void visit(Link link) {
+        // TODO Not implemented
+        writer.tag("Hyperlink");
+        writer.line();
+        visitChildren(link);
+        writer.tag("/Hyperlink");
+        writer.line();
+    }
+
+    @Override
+    public void visit(ListItem listItem) {
+        String prefix = "· ";
+        if (listItem.getParent() instanceof OrderedList orderedList) {
+            if (listItemCount.containsKey(orderedList)) {
+                prefix = listItemCount.get(orderedList).toString() + ". ";
+                listItemCount.put(orderedList, listItemCount.get(orderedList) + 1);
+            }
+        }
+        writer.tag("HBox", FxmlPrefabs.LIST_BLOCK_OUTER.getAttrs());
+        writer.line();
+
+        writer.tag("Text", FxmlPrefabs.TEXT.getAttrs());
+        writer.text(prefix);
+        writer.tag("/Text");
+        writer.line();
+
+        writer.tag("VBox", FxmlPrefabs.LIST_BLOCK_INNER.getAttrs());
+        writer.line();
+
+        visitChildren(listItem);
+
+        writer.line();
+        writer.tag("/VBox");
+        writer.line();
+
+        writer.tag("/HBox");
+        writer.line();
+    }
+
+    @Override
+    public void visit(OrderedList orderedList) {
+        renderListBlock(orderedList);
+    }
+
+    @Override
+    public void visit(Image image) {
+        // TODO Not implemented
+    }
+
+    @Override
+    public void visit(Emphasis emphasis) {
+        writer.tag("/Text");
+        writer.tag("Text", FxmlPrefabs.EMPHASIS.getAttrs());
+        visitChildren(emphasis);
+        writer.tag("/Text");
+        writer.tag("Text");
+    }
+
+    @Override
+    public void visit(StrongEmphasis strongEmphasis) {
+        writer.tag("/Text");
+        writer.tag("Text", FxmlPrefabs.STRONG_EMPHASIS.getAttrs());
+        visitChildren(strongEmphasis);
+        writer.tag("/Text");
+        writer.tag("Text");
+    }
+
+    @Override
+    public void visit(Text text) {
+        writer.text(text.getLiteral());
+    }
+
+    @Override
+    public void visit(Code code) {
+        writer.text(code.getLiteral());
+    }
+
+    @Override
+    public void visit(HtmlInline htmlInline) {
+        // TODO Not implemented
+    }
+
+    @Override
+    public void visit(SoftLineBreak softLineBreak) {
+        writer.tag("/Text");
+        writer.line();
+        writer.tag("/TextFlow");
+        writer.line();
+        writer.tag("TextFlow");
+        writer.line();
+        writer.tag("Text", FxmlPrefabs.TEXT.getAttrs());
+    }
+
+    @Override
+    public void visit(HardLineBreak hardLineBreak) {
+        writer.tag("/Text");
+        writer.line();
+        writer.tag("/TextFlow");
+        writer.line();
+        writer.tag("TextFlow");
+        writer.line();
+        writer.tag("Text", FxmlPrefabs.TEXT.getAttrs());
+    }
+
+    protected void visitChildren(Node parent) {
+        Node next;
+        for (Node node = parent.getFirstChild(); node != null; node = next) {
+            next = node.getNext();
+            this.context.render(node);
+        }
+    }
+
+    private void renderCodeBlock(String literal) {
+        writer.tag("VBox", FxmlPrefabs.CODE_BLOCK.getAttrs());
+        writer.line();
+
+        writer.tag("TextFlow");
+        writer.line();
+        writer.tag("Text", FxmlPrefabs.TEXT.getAttrs());
+        writer.text(literal);
+        writer.tag("/Text");
+        writer.line();
+        writer.tag("/TextFlow");
+        writer.line();
+
+        writer.line();
+        writer.tag("/VBox");
+        writer.line();
+    }
+
+    private void renderListBlock(ListBlock listBlock) {
+        writer.tag("VBox", FxmlPrefabs.LIST_BLOCK_OUTER.getAttrs());
+        writer.line();
+
+        if (listBlock instanceof OrderedList orderedList) {
+            int start = orderedList.getMarkerStartNumber() != null ? orderedList.getMarkerStartNumber() : 1;
+            listItemCount.put(orderedList, start);
+            visitChildren(orderedList);
+            listItemCount.remove(orderedList);
+        } else {
+            visitChildren(listBlock);
+        }
+
+        writer.line();
+        writer.tag("/VBox");
+        writer.line();
+    }
+
+    private boolean isInTightList(Paragraph paragraph) {
+        Node parent = paragraph.getParent();
+        if (parent != null) {
+            Node gramps = parent.getParent();
+            if (gramps instanceof ListBlock) {
+                ListBlock list = (ListBlock) gramps;
+                return list.isTight();
+            }
+        }
+        return false;
+    }
+
+    private Map<String, String> getAttrs(Node node, String tagName) {
+        return getAttrs(node, tagName, Map.of());
+    }
+
+    private Map<String, String> getAttrs(Node node, String tagName, Map<String, String> defaultAttributes) {
+        return context.extendAttributes(node, tagName, defaultAttributes);
+    }
+
+
+    private static class AltTextVisitor extends AbstractVisitor {
+        private final StringBuilder sb = new StringBuilder();
+
+        private AltTextVisitor() {
+        }
+
+        String getAltText() {
+            return sb.toString();
+        }
+
+        public void visit(Text text) {
+            sb.append(text.getLiteral());
+        }
+
+        public void visit(SoftLineBreak softLineBreak) {
+            sb.append('\n');
+        }
+
+        public void visit(HardLineBreak hardLineBreak) {
+            sb.append('\n');
+        }
+    }
+}
diff --git a/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlConvertor.java b/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlConvertor.java
new file mode 100644
index 00000000..267bbb56
--- /dev/null
+++ b/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlConvertor.java
@@ -0,0 +1,45 @@
+/** Copyright (c) 2022-2025, Harry Huang
+ * At GPL-3.0 License
+ */
+package cn.harryh.arkpets.utils.markdown;
+
+import cn.harryh.arkpets.utils.IOUtils;
+import javafx.fxml.FXMLLoader;
+import org.commonmark.parser.Parser;
+import org.commonmark.renderer.html.HtmlRenderer;
+
+import java.io.ByteArrayInputStream;
+import java.io.File;
+import java.io.IOException;
+
+
+/** The helper class for Markdown-to-FXML document conversion.
+ */
+public class FxmlConvertor {
+    /** Converts a Markdown document to an FXML document.
+     * @param markdown The Markdown content.
+     * @return The converted FXML content.
+     */
+    public static String toFxml(String markdown) {
+        Parser parser = Parser.builder().build();
+        org.commonmark.node.Node document = parser.parse(markdown);
+        HtmlRenderer renderer = HtmlRenderer.builder().nodeRendererFactory(CoreFxmlNodeRenderer::new).build();
+        return renderer.render(document);
+    }
+
+    /** Converts a Markdown document to an FXML document.
+     * @param markdown The Markdown content.
+     * @return The converted JavaFX Node that contains the given content.
+     */
+    public static javafx.scene.Node toFxmlVBox(String markdown) {
+        String fxml = toFxml(markdown);
+        try {
+            // TODO Debug only
+            IOUtils.FileUtil.writeString(new File("temp.fxml"), "UTF-8", fxml, false);
+            FXMLLoader loader = new FXMLLoader();
+            return loader.load(new ByteArrayInputStream(fxml.getBytes()));
+        } catch (IOException e) {
+            throw new RuntimeException(e);
+        }
+    }
+}
diff --git a/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlPrefabs.java b/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlPrefabs.java
new file mode 100644
index 00000000..acc673a3
--- /dev/null
+++ b/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlPrefabs.java
@@ -0,0 +1,77 @@
+/** Copyright (c) 2022-2025, Harry Huang
+ * At GPL-3.0 License
+ */
+package cn.harryh.arkpets.utils.markdown;
+
+import java.util.Map;
+
+
+/** The FXML document attribute prefabs for styling a common document.
+ */
+public enum FxmlPrefabs {
+    DOCUMENT(Map.of(
+            "xmlns:fx", "http://javafx.com/fxml/1",
+            "fx:id", "body",
+            "spacing", "7.5",
+            "style", "-fx-font-size:13px;-fx-font-weight:normal;" +
+                    "-fx-padding:10px;-fx-wrap-text:true;"
+    )),
+    H1(Map.of(
+            "style", "-fx-font-size:21px;-fx-font-weight:bold;"
+    )),
+    H2(Map.of(
+            "style", "-fx-font-size:19px;-fx-font-weight:bold;"
+    )),
+    H3(Map.of(
+            "style", "-fx-font-size:17px;-fx-font-weight:bold;"
+    )),
+    H4(Map.of(
+            "style", "-fx-font-size:15px;-fx-font-weight:bold;"
+    )),
+    BLOCK_QUOTE(Map.of(
+            "spacing", "7.5",
+            "style", "-fx-background-color:#2481;-fx-background-radius:2.5px;" +
+                    "-fx-border-color:#2488;-fx-border-width:0 0 0 2.5px;-fx-border-radius:2.5px;" +
+                    "-fx-padding:10px;"
+    )),
+    EMPHASIS(Map.of(
+            "style", "-fx-font-weight:normal;-fx-font-style:oblique;"
+    )),
+    STRONG_EMPHASIS(Map.of(
+            "style", "-fx-font-weight:bold;-fx-font-style:normal;"
+    )),
+    TEXT(Map.of(
+    )),
+    CODE_BLOCK(Map.of(
+            "style", "-fx-background-color:#2481;-fx-background-radius:7.5px;" +
+                    "-fx-border-color:#2484;-fx-border-width:1px;-fx-border-radius:7.5px;" +
+                    "-fx-padding:10px;-fx-font-family:monospace;-fx-font-size:13px;"
+    )),
+    HYPERLINK(Map.of(
+            "fill", "#248F",
+            "underline", "true"
+    )),
+    LIST_BLOCK_OUTER(Map.of(
+            "style", "-fx-padding:0 5px;"
+    )),
+    LIST_BLOCK_INNER(Map.of(
+            "style", "-fx-padding:0 10px;"
+    )),
+    TABLE(Map.of(
+            "style", "-fx-padding:10px 5px;-fx-hgap:0;-fx-vgap:0;-fx-wrap-text:true;"
+    )),
+    TABLE_CELL(Map.of(
+            "style", "-fx-padding:5px 10px;-fx-wrap-text:true;" +
+                    "-fx-border-color:#2482;-fx-border-width:1px;-fx-border-radius:0;"
+    ));
+
+    private final Map<String, String> attrsMap;
+
+    FxmlPrefabs(Map<String, String> attrsMapMap) {
+        this.attrsMap = attrsMapMap;
+    }
+
+    public Map<String, String> getAttrs() {
+        return attrsMap;
+    }
+}

From c33fad311a7f6d5ffd3a2223ce292be7c02652d7 Mon Sep 17 00:00:00 2001
From: Harry Huang <harryhuang2652@qq.com>
Date: Fri, 14 Feb 2025 22:43:35 +0800
Subject: [PATCH 03/10] feat(mdRender): support table

---
 .../arkpets/utils/markdown/FxmlConvertor.java |   9 +-
 .../arkpets/utils/markdown/FxmlPrefabs.java   |   4 +-
 .../utils/markdown/TableFxmlNodeRenderer.java | 175 ++++++++++++++++++
 .../utils/markdown/TablesExtension.java       |  32 ++++
 4 files changed, 216 insertions(+), 4 deletions(-)
 create mode 100644 desktop/src/cn/harryh/arkpets/utils/markdown/TableFxmlNodeRenderer.java
 create mode 100644 desktop/src/cn/harryh/arkpets/utils/markdown/TablesExtension.java

diff --git a/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlConvertor.java b/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlConvertor.java
index 267bbb56..fc5b1edc 100644
--- a/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlConvertor.java
+++ b/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlConvertor.java
@@ -11,6 +11,7 @@
 import java.io.ByteArrayInputStream;
 import java.io.File;
 import java.io.IOException;
+import java.util.List;
 
 
 /** The helper class for Markdown-to-FXML document conversion.
@@ -21,9 +22,13 @@ public class FxmlConvertor {
      * @return The converted FXML content.
      */
     public static String toFxml(String markdown) {
-        Parser parser = Parser.builder().build();
+        Parser parser = Parser.builder()
+                .extensions(List.of(TablesExtension.create()))
+                .build();
         org.commonmark.node.Node document = parser.parse(markdown);
-        HtmlRenderer renderer = HtmlRenderer.builder().nodeRendererFactory(CoreFxmlNodeRenderer::new).build();
+        HtmlRenderer renderer = HtmlRenderer.builder()
+                .extensions(List.of(TablesExtension.create()))
+                .nodeRendererFactory(CoreFxmlNodeRenderer::new).build();
         return renderer.render(document);
     }
 
diff --git a/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlPrefabs.java b/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlPrefabs.java
index acc673a3..a761f574 100644
--- a/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlPrefabs.java
+++ b/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlPrefabs.java
@@ -58,10 +58,10 @@ public enum FxmlPrefabs {
             "style", "-fx-padding:0 10px;"
     )),
     TABLE(Map.of(
-            "style", "-fx-padding:10px 5px;-fx-hgap:0;-fx-vgap:0;-fx-wrap-text:true;"
+            "style", "-fx-padding:10px 5px;-fx-hgap:0;-fx-vgap:0;"
     )),
     TABLE_CELL(Map.of(
-            "style", "-fx-padding:5px 10px;-fx-wrap-text:true;" +
+            "style", "-fx-padding:5px 10px;" +
                     "-fx-border-color:#2482;-fx-border-width:1px;-fx-border-radius:0;"
     ));
 
diff --git a/desktop/src/cn/harryh/arkpets/utils/markdown/TableFxmlNodeRenderer.java b/desktop/src/cn/harryh/arkpets/utils/markdown/TableFxmlNodeRenderer.java
new file mode 100644
index 00000000..c3f3d8cb
--- /dev/null
+++ b/desktop/src/cn/harryh/arkpets/utils/markdown/TableFxmlNodeRenderer.java
@@ -0,0 +1,175 @@
+/** Copyright (c) 2022-2025, Harry Huang
+ * At GPL-3.0 License
+ */
+package cn.harryh.arkpets.utils.markdown;
+
+import org.commonmark.ext.gfm.tables.*;
+import org.commonmark.node.*;
+import org.commonmark.renderer.NodeRenderer;
+import org.commonmark.renderer.html.HtmlNodeRendererContext;
+import org.commonmark.renderer.html.HtmlWriter;
+
+import java.util.HashMap;
+import java.util.Map;
+import java.util.Set;
+
+
+/** The modded node renderer that renders all the table nodes to FXML used by JavaFX.
+ * This implementation is adapted from {@link org.commonmark.ext.gfm.tables.internal.TableHtmlNodeRenderer} class.
+ */
+public class TableFxmlNodeRenderer implements NodeRenderer {
+    private final HtmlNodeRendererContext context;
+    private final HtmlWriter writer;
+    private final Map<TableBlock, RowColumnValue> rowColumnCount;
+
+    public TableFxmlNodeRenderer(HtmlNodeRendererContext context) {
+        this.context = context;
+        this.writer = context.getWriter();
+        this.rowColumnCount = new HashMap<>(4);
+    }
+
+    @Override
+    public Set<Class<? extends Node>> getNodeTypes() {
+        return Set.of(TableBlock.class, TableHead.class, TableBody.class, TableRow.class, TableCell.class);
+    }
+
+    @Override
+    public void render(Node node) {
+        if (node instanceof TableBlock tableBlock) {
+            renderBlock(tableBlock);
+        } else if (node instanceof TableHead tableHead) {
+            renderHead(tableHead);
+        } else if (node instanceof TableBody tableBody) {
+            renderBody(tableBody);
+        } else if (node instanceof TableRow tableRow) {
+            renderRow(tableRow);
+        } else if (node instanceof TableCell tableCell) {
+            renderCell(tableCell);
+        }
+    }
+
+    protected void renderBlock(TableBlock tableBlock) {
+        writer.tag("GridPane", FxmlPrefabs.TABLE.getAttrs());
+        writer.line();
+
+        rowColumnCount.put(tableBlock, new RowColumnValue());
+        renderChildren(tableBlock);
+        rowColumnCount.remove(tableBlock);
+
+        writer.tag("/GridPane");
+        writer.line();
+    }
+
+    protected void renderHead(TableHead tableHead) {
+        if (tableHead.getParent() instanceof TableBlock tableBlock) {
+            renderChildren(tableHead);
+            rowColumnCount.get(tableBlock).increaseRow();
+        } else {
+            throw new RuntimeException("Illegal parent of table head");
+        }
+    }
+
+    protected void renderBody(TableBody tableBody) {
+        if (tableBody.getParent() instanceof TableBlock tableBlock) {
+            renderChildren(tableBody);
+            rowColumnCount.get(tableBlock).increaseRow();
+        } else {
+            throw new RuntimeException("Illegal parent of table body");
+        }
+    }
+
+    protected void renderRow(TableRow tableRow) {
+        if (tableRow.getParent().getParent() instanceof TableBlock tableBlock) {
+            renderChildren(tableRow);
+            rowColumnCount.get(tableBlock).increaseRow();
+        } else {
+            throw new RuntimeException("Illegal parent of table row");
+        }
+    }
+
+    protected void renderCell(TableCell tableCell) {
+        if (tableCell.getParent().getParent().getParent() instanceof TableBlock tableBlock) {
+            writer.tag("HBox", getCellAttrs(tableCell));
+            writer.line();
+
+            if (allChildrenAreText(tableCell)) {
+                writer.tag("TextFlow");
+                writer.tag("Text", FxmlPrefabs.TEXT.getAttrs());
+                renderChildren(tableCell);
+                writer.tag("/Text");
+                writer.tag("/TextFlow");
+            }
+
+            writer.tag("/HBox");
+            writer.line();
+            rowColumnCount.get(tableBlock).increaseColumn();
+        } else {
+            throw new RuntimeException("Illegal parent of table cell");
+        }
+    }
+
+    private Map<String, String> getCellAttrs(TableCell tableCell) {
+        if (tableCell.getParent().getParent().getParent() instanceof TableBlock tableBlock) {
+            RowColumnValue rc = rowColumnCount.get(tableBlock);
+            Map<String, String> attrs = new HashMap<>(8);
+            attrs.put("GridPane.rowIndex", String.valueOf(rc.row));
+            attrs.put("GridPane.columnIndex", String.valueOf(rc.column));
+            attrs.put("alignment", switch (tableCell.getAlignment()) {
+                case LEFT -> "CENTER_LEFT";
+                case CENTER -> "CENTER";
+                case RIGHT -> "CENTER_RIGHT";
+            });
+            attrs.putAll(FxmlPrefabs.TABLE_CELL.getAttrs());
+            return attrs;
+        } else {
+            throw new RuntimeException("Illegal parent of table cell");
+        }
+    }
+
+    private void renderChildren(Node parent) {
+        Node node = parent.getFirstChild();
+        while (node != null) {
+            Node next = node.getNext();
+            context.render(node);
+            node = next;
+        }
+    }
+
+    private boolean allChildrenAreText(Node parent) {
+        Node node = parent.getFirstChild();
+        while (node != null) {
+            Node next = node.getNext();
+            if (!(node instanceof Text ||
+                    node instanceof Code ||
+                    node instanceof Link ||
+                    node instanceof HtmlInline ||
+                    node instanceof Emphasis ||
+                    node instanceof StrongEmphasis
+            )) {
+                return false;
+            }
+            node = next;
+        }
+        return true;
+    }
+
+
+    private static class RowColumnValue {
+        private int row;
+        private int column;
+
+        private RowColumnValue() {
+            row = 0;
+            column = 0;
+        }
+
+        public void increaseRow() {
+            row += 1;
+            column = 0;
+        }
+
+        public void increaseColumn() {
+            column += 1;
+        }
+    }
+}
diff --git a/desktop/src/cn/harryh/arkpets/utils/markdown/TablesExtension.java b/desktop/src/cn/harryh/arkpets/utils/markdown/TablesExtension.java
new file mode 100644
index 00000000..9cadf889
--- /dev/null
+++ b/desktop/src/cn/harryh/arkpets/utils/markdown/TablesExtension.java
@@ -0,0 +1,32 @@
+/** Copyright (c) 2022-2025, Harry Huang
+ * At GPL-3.0 License
+ */
+package cn.harryh.arkpets.utils.markdown;
+
+import org.commonmark.Extension;
+import org.commonmark.ext.gfm.tables.internal.TableBlockParser;
+import org.commonmark.parser.Parser;
+import org.commonmark.renderer.html.HtmlRenderer;
+
+
+/** Extension for <a href="https://github.github.com/gfm/#tables-extension-">GFM tables</a> using "|" pipes.
+ * This implementation is adapted from {@link org.commonmark.ext.gfm.tables.TablesExtension} class.
+ */
+public class TablesExtension implements Parser.ParserExtension, HtmlRenderer.HtmlRendererExtension {
+    private TablesExtension() {
+    }
+
+    public static Extension create() {
+        return new TablesExtension();
+    }
+
+    @Override
+    public void extend(Parser.Builder parserBuilder) {
+        parserBuilder.customBlockParserFactory(new TableBlockParser.Factory());
+    }
+
+    @Override
+    public void extend(HtmlRenderer.Builder rendererBuilder) {
+        rendererBuilder.nodeRendererFactory(TableFxmlNodeRenderer::new);
+    }
+}

From 289b4487c21ec9b59ab53527992c28cb45649f29 Mon Sep 17 00:00:00 2001
From: Harry Huang <harryhuang2652@qq.com>
Date: Sat, 15 Feb 2025 22:45:39 +0800
Subject: [PATCH 04/10] feat(mdRender): support hyperlink

---
 .../utils/markdown/CoreFxmlNodeRenderer.java  | 39 ++++++++++----
 .../arkpets/utils/markdown/FxmlConvertor.java | 17 +++---
 .../markdown/FxmlDocumentController.java      | 53 +++++++++++++++++++
 3 files changed, 92 insertions(+), 17 deletions(-)
 create mode 100644 desktop/src/cn/harryh/arkpets/utils/markdown/FxmlDocumentController.java

diff --git a/desktop/src/cn/harryh/arkpets/utils/markdown/CoreFxmlNodeRenderer.java b/desktop/src/cn/harryh/arkpets/utils/markdown/CoreFxmlNodeRenderer.java
index 8471212e..415efdf6 100644
--- a/desktop/src/cn/harryh/arkpets/utils/markdown/CoreFxmlNodeRenderer.java
+++ b/desktop/src/cn/harryh/arkpets/utils/markdown/CoreFxmlNodeRenderer.java
@@ -8,10 +8,7 @@
 import org.commonmark.renderer.html.HtmlNodeRendererContext;
 import org.commonmark.renderer.html.HtmlWriter;
 
-import java.util.HashMap;
-import java.util.LinkedHashMap;
-import java.util.Map;
-import java.util.Set;
+import java.util.*;
 
 
 /** The modded node renderer that renders all the core nodes to FXML used by JavaFX.
@@ -21,11 +18,13 @@ public class CoreFxmlNodeRenderer extends AbstractVisitor implements NodeRendere
     protected final HtmlNodeRendererContext context;
     private final HtmlWriter writer;
     private final Map<ListBlock, Integer> listItemCount;
+    private String lastHref;
 
     public CoreFxmlNodeRenderer(HtmlNodeRendererContext context) {
         this.context = context;
         this.writer = context.getWriter();
         this.listItemCount = new HashMap<>(4);
+        this.lastHref = null;
     }
 
     @Override
@@ -161,12 +160,17 @@ public void visit(IndentedCodeBlock indentedCodeBlock) {
 
     @Override
     public void visit(Link link) {
-        // TODO Not implemented
-        writer.tag("Hyperlink");
+        writer.tag("/Text");
         writer.line();
+
+        lastHref = link.getDestination();
+        writer.tag("Text", getHyperlinkAttachedAttrs(FxmlPrefabs.TEXT.getAttrs()));
         visitChildren(link);
-        writer.tag("/Hyperlink");
+        lastHref = null;
+        writer.tag("/Text");
         writer.line();
+
+        writer.tag("Text");
     }
 
     @Override
@@ -212,19 +216,19 @@ public void visit(Image image) {
     @Override
     public void visit(Emphasis emphasis) {
         writer.tag("/Text");
-        writer.tag("Text", FxmlPrefabs.EMPHASIS.getAttrs());
+        writer.tag("Text", getHyperlinkAttachedAttrs(FxmlPrefabs.EMPHASIS.getAttrs()));
         visitChildren(emphasis);
         writer.tag("/Text");
-        writer.tag("Text");
+        writer.tag("Text", getHyperlinkAttachedAttrs(FxmlPrefabs.TEXT.getAttrs()));
     }
 
     @Override
     public void visit(StrongEmphasis strongEmphasis) {
         writer.tag("/Text");
-        writer.tag("Text", FxmlPrefabs.STRONG_EMPHASIS.getAttrs());
+        writer.tag("Text", getHyperlinkAttachedAttrs(FxmlPrefabs.STRONG_EMPHASIS.getAttrs()));
         visitChildren(strongEmphasis);
         writer.tag("/Text");
-        writer.tag("Text");
+        writer.tag("Text", getHyperlinkAttachedAttrs(FxmlPrefabs.TEXT.getAttrs()));
     }
 
     @Override
@@ -328,6 +332,19 @@ private Map<String, String> getAttrs(Node node, String tagName, Map<String, Stri
         return context.extendAttributes(node, tagName, defaultAttributes);
     }
 
+    private Map<String, String> getHyperlinkAttachedAttrs(Map<String, String> defaultAttrs) {
+        if (lastHref != null && !lastHref.isBlank()) {
+            Map<String, String> attrs = new HashMap<>(8);
+            attrs.putAll(defaultAttrs);
+            attrs.putAll(FxmlPrefabs.HYPERLINK.getAttrs());
+            attrs.put("onMouseClicked", "#handleHyperlinkClick");
+            attrs.put("userData", lastHref);
+            return attrs;
+        } else {
+            return defaultAttrs;
+        }
+    }
+
 
     private static class AltTextVisitor extends AbstractVisitor {
         private final StringBuilder sb = new StringBuilder();
diff --git a/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlConvertor.java b/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlConvertor.java
index fc5b1edc..79930e28 100644
--- a/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlConvertor.java
+++ b/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlConvertor.java
@@ -5,6 +5,7 @@
 
 import cn.harryh.arkpets.utils.IOUtils;
 import javafx.fxml.FXMLLoader;
+import org.commonmark.node.Node;
 import org.commonmark.parser.Parser;
 import org.commonmark.renderer.html.HtmlRenderer;
 
@@ -21,11 +22,11 @@ public class FxmlConvertor {
      * @param markdown The Markdown content.
      * @return The converted FXML content.
      */
-    public static String toFxml(String markdown) {
+    public static String toFxmlString(String markdown) {
         Parser parser = Parser.builder()
                 .extensions(List.of(TablesExtension.create()))
                 .build();
-        org.commonmark.node.Node document = parser.parse(markdown);
+        Node document = parser.parse(markdown);
         HtmlRenderer renderer = HtmlRenderer.builder()
                 .extensions(List.of(TablesExtension.create()))
                 .nodeRendererFactory(CoreFxmlNodeRenderer::new).build();
@@ -34,15 +35,19 @@ public static String toFxml(String markdown) {
 
     /** Converts a Markdown document to an FXML document.
      * @param markdown The Markdown content.
-     * @return The converted JavaFX Node that contains the given content.
+     * @return The {@link FxmlDocumentController} that bound with the converted FXML document.
      */
-    public static javafx.scene.Node toFxmlVBox(String markdown) {
-        String fxml = toFxml(markdown);
+    public static FxmlDocumentController toFxmlController(String markdown) {
+        String fxml = toFxmlString(markdown);
         try {
             // TODO Debug only
             IOUtils.FileUtil.writeString(new File("temp.fxml"), "UTF-8", fxml, false);
+            FxmlDocumentController controller = new FxmlDocumentController();
             FXMLLoader loader = new FXMLLoader();
-            return loader.load(new ByteArrayInputStream(fxml.getBytes()));
+            loader.setClassLoader(FxmlConvertor.class.getClassLoader());
+            loader.setController(controller);
+            loader.load(new ByteArrayInputStream(fxml.getBytes()));
+            return controller;
         } catch (IOException e) {
             throw new RuntimeException(e);
         }
diff --git a/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlDocumentController.java b/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlDocumentController.java
new file mode 100644
index 00000000..d2a22625
--- /dev/null
+++ b/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlDocumentController.java
@@ -0,0 +1,53 @@
+/** Copyright (c) 2022-2025, Harry Huang
+ * At GPL-3.0 License
+ */
+package cn.harryh.arkpets.utils.markdown;
+
+import javafx.fxml.FXML;
+import javafx.scene.Node;
+import javafx.scene.input.MouseEvent;
+import javafx.scene.layout.VBox;
+
+import java.util.function.Consumer;
+
+
+/** The controller that the FXML document rendered by {@link FxmlConvertor} bind to.
+ */
+public final class FxmlDocumentController {
+    @FXML
+    private VBox body;
+
+    private Consumer<String> hyperlinkConsumer;
+
+    public FxmlDocumentController() {
+        hyperlinkConsumer = null;
+    }
+
+    /** This method is used to bind to the {@code onMouseClicked} attribute in the rendered FXML document.
+     */
+    @FXML
+    @SuppressWarnings("unused")
+    private void handleHyperlinkClick(MouseEvent event) {
+        if (event.getSource() instanceof Node node) {
+            if (node.getUserData() instanceof String string) {
+                if (hyperlinkConsumer != null) {
+                    hyperlinkConsumer.accept(string);
+                }
+            }
+        }
+    }
+
+    /** Sets the consumer that accepts the URL of the hyperlink the user clicked.
+     * @param consumer A string consumer.
+     */
+    public void setHyperlinkConsumer(Consumer<String> consumer) {
+        hyperlinkConsumer = consumer;
+    }
+
+    /** Gets the body node of the FXML document.
+     * @return The body node.
+     */
+    public VBox getBodyNode() {
+        return body;
+    }
+}

From fd66aeb672791aff99b103a2bc3b19bfd7e9bf54 Mon Sep 17 00:00:00 2001
From: Harry Huang <harryhuang2652@qq.com>
Date: Sun, 16 Feb 2025 15:03:12 +0800
Subject: [PATCH 05/10] refactor(mdRender): using textflow coordinator

---
 .../utils/markdown/CoreFxmlNodeRenderer.java  |  80 ++++--------
 .../utils/markdown/TextFlowCoordinator.java   | 120 ++++++++++++++++++
 2 files changed, 147 insertions(+), 53 deletions(-)
 create mode 100644 desktop/src/cn/harryh/arkpets/utils/markdown/TextFlowCoordinator.java

diff --git a/desktop/src/cn/harryh/arkpets/utils/markdown/CoreFxmlNodeRenderer.java b/desktop/src/cn/harryh/arkpets/utils/markdown/CoreFxmlNodeRenderer.java
index 415efdf6..f22efe30 100644
--- a/desktop/src/cn/harryh/arkpets/utils/markdown/CoreFxmlNodeRenderer.java
+++ b/desktop/src/cn/harryh/arkpets/utils/markdown/CoreFxmlNodeRenderer.java
@@ -17,12 +17,14 @@
 public class CoreFxmlNodeRenderer extends AbstractVisitor implements NodeRenderer {
     protected final HtmlNodeRendererContext context;
     private final HtmlWriter writer;
+    private final TextFlowCoordinator textFlow;
     private final Map<ListBlock, Integer> listItemCount;
     private String lastHref;
 
     public CoreFxmlNodeRenderer(HtmlNodeRendererContext context) {
         this.context = context;
         this.writer = context.getWriter();
+        this.textFlow = new TextFlowCoordinator(writer);
         this.listItemCount = new HashMap<>(4);
         this.lastHref = null;
     }
@@ -69,36 +71,27 @@ public void visit(Document document) {
 
     @Override
     public void visit(Heading heading) {
-        writer.tag("TextFlow", switch (heading.getLevel()) {
+        textFlow.openTextFlow();
+
+        textFlow.openText(switch (heading.getLevel()) {
             case 1 -> FxmlPrefabs.H1.getAttrs();
             case 2 -> FxmlPrefabs.H2.getAttrs();
             case 3 -> FxmlPrefabs.H3.getAttrs();
             default -> FxmlPrefabs.H4.getAttrs();
         });
-        writer.line();
-
-        writer.tag("Text", FxmlPrefabs.TEXT.getAttrs());
         visitChildren(heading);
-        writer.tag("/Text");
-        writer.line();
 
-        writer.tag("/TextFlow");
-        writer.line();
+        textFlow.closeTextFlow();
     }
 
     @Override
     public void visit(Paragraph paragraph) {
-        writer.tag("TextFlow");
-        writer.line();
-        writer.tag("Text");
-        writer.line();
+        textFlow.openTextFlow();
 
+        textFlow.openText(getHyperlinkAttachedAttrs(FxmlPrefabs.TEXT.getAttrs()));
         visitChildren(paragraph);
 
-        writer.tag("/Text");
-        writer.line();
-        writer.tag("/TextFlow");
-        writer.line();
+        textFlow.closeTextFlow();
     }
 
     @Override
@@ -160,17 +153,13 @@ public void visit(IndentedCodeBlock indentedCodeBlock) {
 
     @Override
     public void visit(Link link) {
-        writer.tag("/Text");
-        writer.line();
+        textFlow.openTextFlow();
 
         lastHref = link.getDestination();
-        writer.tag("Text", getHyperlinkAttachedAttrs(FxmlPrefabs.TEXT.getAttrs()));
+        textFlow.openText(getHyperlinkAttachedAttrs(FxmlPrefabs.TEXT.getAttrs()));
         visitChildren(link);
+        textFlow.closeText();
         lastHref = null;
-        writer.tag("/Text");
-        writer.line();
-
-        writer.tag("Text");
     }
 
     @Override
@@ -215,29 +204,31 @@ public void visit(Image image) {
 
     @Override
     public void visit(Emphasis emphasis) {
-        writer.tag("/Text");
-        writer.tag("Text", getHyperlinkAttachedAttrs(FxmlPrefabs.EMPHASIS.getAttrs()));
+        textFlow.openText(getHyperlinkAttachedAttrs(FxmlPrefabs.EMPHASIS.getAttrs()));
         visitChildren(emphasis);
-        writer.tag("/Text");
-        writer.tag("Text", getHyperlinkAttachedAttrs(FxmlPrefabs.TEXT.getAttrs()));
+        textFlow.closeText();
     }
 
     @Override
     public void visit(StrongEmphasis strongEmphasis) {
-        writer.tag("/Text");
-        writer.tag("Text", getHyperlinkAttachedAttrs(FxmlPrefabs.STRONG_EMPHASIS.getAttrs()));
+        textFlow.openText(getHyperlinkAttachedAttrs(FxmlPrefabs.STRONG_EMPHASIS.getAttrs()));
         visitChildren(strongEmphasis);
-        writer.tag("/Text");
-        writer.tag("Text", getHyperlinkAttachedAttrs(FxmlPrefabs.TEXT.getAttrs()));
+        textFlow.closeText();
     }
 
     @Override
     public void visit(Text text) {
+        if (!textFlow.isTextFlowContinuing()) {
+            textFlow.openText(getHyperlinkAttachedAttrs(FxmlPrefabs.TEXT.getAttrs()));
+        }
         writer.text(text.getLiteral());
     }
 
     @Override
     public void visit(Code code) {
+        if (!textFlow.isTextFlowContinuing()) {
+            textFlow.openText(getHyperlinkAttachedAttrs(FxmlPrefabs.TEXT.getAttrs()));
+        }
         writer.text(code.getLiteral());
     }
 
@@ -248,24 +239,12 @@ public void visit(HtmlInline htmlInline) {
 
     @Override
     public void visit(SoftLineBreak softLineBreak) {
-        writer.tag("/Text");
-        writer.line();
-        writer.tag("/TextFlow");
-        writer.line();
-        writer.tag("TextFlow");
-        writer.line();
-        writer.tag("Text", FxmlPrefabs.TEXT.getAttrs());
+        textFlow.closeTextFlow();
     }
 
     @Override
     public void visit(HardLineBreak hardLineBreak) {
-        writer.tag("/Text");
-        writer.line();
-        writer.tag("/TextFlow");
-        writer.line();
-        writer.tag("TextFlow");
-        writer.line();
-        writer.tag("Text", FxmlPrefabs.TEXT.getAttrs());
+        textFlow.closeTextFlow();
     }
 
     protected void visitChildren(Node parent) {
@@ -279,17 +258,12 @@ protected void visitChildren(Node parent) {
     private void renderCodeBlock(String literal) {
         writer.tag("VBox", FxmlPrefabs.CODE_BLOCK.getAttrs());
         writer.line();
+        textFlow.openTextFlow();
 
-        writer.tag("TextFlow");
-        writer.line();
-        writer.tag("Text", FxmlPrefabs.TEXT.getAttrs());
+        textFlow.openText(getHyperlinkAttachedAttrs(FxmlPrefabs.TEXT.getAttrs()));
         writer.text(literal);
-        writer.tag("/Text");
-        writer.line();
-        writer.tag("/TextFlow");
-        writer.line();
 
-        writer.line();
+        textFlow.closeTextFlow();
         writer.tag("/VBox");
         writer.line();
     }
diff --git a/desktop/src/cn/harryh/arkpets/utils/markdown/TextFlowCoordinator.java b/desktop/src/cn/harryh/arkpets/utils/markdown/TextFlowCoordinator.java
new file mode 100644
index 00000000..a82f0356
--- /dev/null
+++ b/desktop/src/cn/harryh/arkpets/utils/markdown/TextFlowCoordinator.java
@@ -0,0 +1,120 @@
+/** Copyright (c) 2022-2025, Harry Huang
+ * At GPL-3.0 License
+ */
+package cn.harryh.arkpets.utils.markdown;
+
+import org.commonmark.renderer.html.HtmlWriter;
+
+import java.util.Map;
+
+
+/** The coordinator providing methods for safely rendering the FXML element {@code TextFlow} and {@code Text}.
+ */
+public class TextFlowCoordinator {
+    private final HtmlWriter writer;
+    private TextFlowStatus status;
+    
+    public TextFlowCoordinator(HtmlWriter writer) {
+        this.writer = writer;
+        this.status = TextFlowStatus.CLOSED;
+    }
+
+    /** Opens a {@code TextFlow} element.
+     */
+    public void openTextFlow() {
+        switch (status) {
+            case OPENED -> {
+                // Text flow already opened -> do nothing
+            }
+            case CONTINUING -> {
+                // Active text remaining -> close text
+                writer.tag("/Text");
+                writer.line();
+            }
+            case CLOSED -> {
+                // Text flow not opened yet -> open text flow
+                writer.tag("TextFlow");
+                writer.line();
+            }
+        }
+        status = TextFlowStatus.OPENED;
+    }
+
+    /** Closes a {@code TextFlow} element.
+     */
+    public void closeTextFlow() {
+        switch (status) {
+            case OPENED -> {
+                // Text flow opened -> close text flow
+                writer.tag("/TextFlow");
+                writer.line();
+            }
+            case CONTINUING -> {
+                // Active text remaining -> close text and text flow
+                writer.tag("/Text");
+                writer.line();
+                writer.tag("/TextFlow");
+                writer.line();
+            }
+            case CLOSED -> {
+                // Text flow already closed -> do nothing
+            }
+        }
+        status = TextFlowStatus.CLOSED;
+    }
+
+    /** Opens (or reopens) a new {@code Text} element.
+     * @param attrs The additional attributes for the {@code Text}.
+     */
+    public void openText(Map<String, String> attrs) {
+        switch (status) {
+            case OPENED -> {
+                // Text flow opened -> open text
+                writer.tag("Text", attrs);
+            }
+            case CONTINUING -> {
+                // Active text remaining -> reopen text
+                writer.tag("/Text");
+                writer.line();
+                writer.tag("Text", attrs);
+            }
+            case CLOSED -> {
+                // Text flow closed -> open text flow and text
+                writer.tag("TextFlow");
+                writer.line();
+                writer.tag("Text", attrs);
+            }
+        }
+        status = TextFlowStatus.CONTINUING;
+    }
+
+    /** Closes a {@code Text} element.
+     */
+    public void closeText() {
+        switch (status) {
+            case OPENED, CLOSED -> {
+                // No active text -> do nothing
+            }
+            case CONTINUING -> {
+                // Active text remaining -> close text
+                writer.tag("/Text");
+                writer.line();
+                status = TextFlowStatus.OPENED;
+            }
+        }
+    }
+
+    /** Checks whether the {@code Text} element is opened.
+     * @return {@code true} if the {@code Text} element is opened.
+     */
+    public boolean isTextFlowContinuing() {
+        return status == TextFlowStatus.CONTINUING;
+    }
+
+
+    private enum TextFlowStatus {
+        OPENED,
+        CONTINUING,
+        CLOSED
+    }
+}

From 61a8cd042e3e64ff0c1c62c707f767a8d4319bc8 Mon Sep 17 00:00:00 2001
From: Harry Huang <harryhuang2652@qq.com>
Date: Mon, 17 Feb 2025 12:42:22 +0800
Subject: [PATCH 06/10] refactor(mdRender): optimize table

---
 .../utils/markdown/CoreFxmlNodeRenderer.java  | 152 ++++++++++++++-
 .../arkpets/utils/markdown/FxmlConvertor.java |   2 +-
 .../markdown/FxmlDocumentController.java      |  36 ++++
 .../utils/markdown/TableFxmlNodeRenderer.java | 175 ------------------
 .../utils/markdown/TablesExtension.java       |  32 ----
 5 files changed, 187 insertions(+), 210 deletions(-)
 delete mode 100644 desktop/src/cn/harryh/arkpets/utils/markdown/TableFxmlNodeRenderer.java
 delete mode 100644 desktop/src/cn/harryh/arkpets/utils/markdown/TablesExtension.java

diff --git a/desktop/src/cn/harryh/arkpets/utils/markdown/CoreFxmlNodeRenderer.java b/desktop/src/cn/harryh/arkpets/utils/markdown/CoreFxmlNodeRenderer.java
index f22efe30..3d0eb606 100644
--- a/desktop/src/cn/harryh/arkpets/utils/markdown/CoreFxmlNodeRenderer.java
+++ b/desktop/src/cn/harryh/arkpets/utils/markdown/CoreFxmlNodeRenderer.java
@@ -3,6 +3,7 @@
  */
 package cn.harryh.arkpets.utils.markdown;
 
+import org.commonmark.ext.gfm.tables.*;
 import org.commonmark.node.*;
 import org.commonmark.renderer.NodeRenderer;
 import org.commonmark.renderer.html.HtmlNodeRendererContext;
@@ -19,6 +20,7 @@ public class CoreFxmlNodeRenderer extends AbstractVisitor implements NodeRendere
     private final HtmlWriter writer;
     private final TextFlowCoordinator textFlow;
     private final Map<ListBlock, Integer> listItemCount;
+    private final Map<TableBlock, RowColumnValue> rowColumnCount;
     private String lastHref;
 
     public CoreFxmlNodeRenderer(HtmlNodeRendererContext context) {
@@ -26,6 +28,7 @@ public CoreFxmlNodeRenderer(HtmlNodeRendererContext context) {
         this.writer = context.getWriter();
         this.textFlow = new TextFlowCoordinator(writer);
         this.listItemCount = new HashMap<>(4);
+        this.rowColumnCount = new HashMap<>(4);
         this.lastHref = null;
     }
 
@@ -38,15 +41,31 @@ public Set<Class<? extends Node>> getNodeTypes() {
                 Link.class, ListItem.class, OrderedList.class,
                 Image.class, Emphasis.class, StrongEmphasis.class,
                 Text.class, Code.class, HtmlInline.class,
-                SoftLineBreak.class, HardLineBreak.class
+                SoftLineBreak.class, HardLineBreak.class, TableBlock.class,
+                TableHead.class, TableBody.class, TableRow.class,
+                TableCell.class
         );
     }
 
     @Override
     public void render(Node node) {
-        node.accept(this);
+        if (node instanceof TableBlock tableBlock) {
+            renderBlock(tableBlock);
+        } else if (node instanceof TableHead tableHead) {
+            renderHead(tableHead);
+        } else if (node instanceof TableBody tableBody) {
+            renderBody(tableBody);
+        } else if (node instanceof TableRow tableRow) {
+            renderRow(tableRow);
+        } else if (node instanceof TableCell tableCell) {
+            renderCell(tableCell);
+        } else {
+            node.accept(this);
+        }
     }
 
+    // REGION: BASIC NODES
+
     @Override
     public void visit(Document document) {
         // FXML headers
@@ -247,6 +266,76 @@ public void visit(HardLineBreak hardLineBreak) {
         textFlow.closeTextFlow();
     }
 
+    // REGION: TABLE EXTENSION
+
+    protected void renderBlock(TableBlock tableBlock) {
+        writer.tag("GridPane", FxmlPrefabs.TABLE.getAttrs());
+        writer.line();
+
+        RowColumnValue rc = new RowColumnValue();
+        rowColumnCount.put(tableBlock, rc);
+
+        visitChildren(tableBlock);
+
+        double weightSum = rc.columnWeight.stream().mapToDouble(Double::doubleValue).sum();
+        if (weightSum > 0.0) {
+            writer.tag("columnConstraints");
+            writer.line();
+            rc.columnWeight.forEach(w -> {
+                // Weight data is temporarily stored through the 'minWidth' attribute
+                writer.tag("ColumnConstraints", Map.of(
+                        "minWidth", "%.6f".formatted(w / weightSum)
+                ), true);
+                writer.line();
+            });
+            writer.tag("/columnConstraints");
+            writer.line();
+        }
+
+        rowColumnCount.remove(tableBlock);
+
+        writer.tag("/GridPane");
+        writer.line();
+    }
+
+    protected void renderHead(TableHead tableHead) {
+        visitChildren(tableHead);
+    }
+
+    protected void renderBody(TableBody tableBody) {
+        visitChildren(tableBody);
+    }
+
+    protected void renderRow(TableRow tableRow) {
+        if (tableRow.getParent().getParent() instanceof TableBlock tableBlock) {
+            visitChildren(tableRow);
+            rowColumnCount.get(tableBlock).increaseRow();
+        } else {
+            throw new RuntimeException("Illegal parent of table row");
+        }
+    }
+
+    protected void renderCell(TableCell tableCell) {
+        if (tableCell.getParent().getParent().getParent() instanceof TableBlock tableBlock) {
+            writer.tag("VBox", getCellAttrs(tableCell));
+            writer.line();
+
+            visitChildren(tableCell);
+            textFlow.closeTextFlow();
+
+            writer.tag("/VBox");
+            writer.line();
+
+            RowColumnValue rc = rowColumnCount.get(tableBlock);
+            rc.setColumnWeight(Math.sqrt(tableCell.getWidth() / ((getChildrenLength(tableCell) / 2.0 + 1))));
+            rc.increaseColumn();
+        } else {
+            throw new RuntimeException("Illegal parent of table cell");
+        }
+    }
+
+    // REGION: INTERNAL METHODS
+
     protected void visitChildren(Node parent) {
         Node next;
         for (Node node = parent.getFirstChild(); node != null; node = next) {
@@ -298,6 +387,14 @@ private boolean isInTightList(Paragraph paragraph) {
         return false;
     }
 
+    private int getChildrenLength(Node parent) {
+        int count = 0;
+        for (Node node = parent.getFirstChild(); node != null; node = node.getNext()) {
+            count += 1;
+        }
+        return count;
+    }
+
     private Map<String, String> getAttrs(Node node, String tagName) {
         return getAttrs(node, tagName, Map.of());
     }
@@ -319,6 +416,57 @@ private Map<String, String> getHyperlinkAttachedAttrs(Map<String, String> defaul
         }
     }
 
+    private Map<String, String> getCellAttrs(TableCell tableCell) {
+        if (tableCell.getParent().getParent().getParent() instanceof TableBlock tableBlock) {
+            RowColumnValue rc = rowColumnCount.get(tableBlock);
+            Map<String, String> attrs = new HashMap<>(8);
+            attrs.put("GridPane.rowIndex", String.valueOf(rc.row));
+            attrs.put("GridPane.columnIndex", String.valueOf(rc.column));
+            attrs.put("alignment", switch (tableCell.getAlignment()) {
+                case LEFT -> "CENTER_LEFT";
+                case CENTER -> "CENTER";
+                case RIGHT -> "CENTER_RIGHT";
+            });
+            attrs.putAll(FxmlPrefabs.TABLE_CELL.getAttrs());
+            return attrs;
+        } else {
+            throw new RuntimeException("Illegal parent of table cell");
+        }
+    }
+
+    // REGION: INTERNAL CLASSES
+
+    private static class RowColumnValue {
+        private int row;
+        private int column;
+        private final ArrayList<Double> columnWeight;
+
+        private RowColumnValue() {
+            row = 0;
+            column = 0;
+            columnWeight = new ArrayList<>(8);
+        }
+
+        public void increaseRow() {
+            row += 1;
+            column = 0;
+        }
+
+        public void increaseColumn() {
+            column += 1;
+        }
+
+        public void setColumnWeight(double weight) {
+            if (column > columnWeight.size()) {
+                throw new RuntimeException("Inconsistent column index");
+            } else if (column == columnWeight.size()) {
+                columnWeight.add(weight);
+            } else {
+                columnWeight.set(column, columnWeight.get(column) + weight);
+            }
+        }
+    }
+
 
     private static class AltTextVisitor extends AbstractVisitor {
         private final StringBuilder sb = new StringBuilder();
diff --git a/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlConvertor.java b/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlConvertor.java
index 79930e28..ad4191ac 100644
--- a/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlConvertor.java
+++ b/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlConvertor.java
@@ -5,6 +5,7 @@
 
 import cn.harryh.arkpets.utils.IOUtils;
 import javafx.fxml.FXMLLoader;
+import org.commonmark.ext.gfm.tables.TablesExtension;
 import org.commonmark.node.Node;
 import org.commonmark.parser.Parser;
 import org.commonmark.renderer.html.HtmlRenderer;
@@ -28,7 +29,6 @@ public static String toFxmlString(String markdown) {
                 .build();
         Node document = parser.parse(markdown);
         HtmlRenderer renderer = HtmlRenderer.builder()
-                .extensions(List.of(TablesExtension.create()))
                 .nodeRendererFactory(CoreFxmlNodeRenderer::new).build();
         return renderer.render(document);
     }
diff --git a/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlDocumentController.java b/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlDocumentController.java
index d2a22625..9ab5b8be 100644
--- a/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlDocumentController.java
+++ b/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlDocumentController.java
@@ -3,9 +3,13 @@
  */
 package cn.harryh.arkpets.utils.markdown;
 
+import javafx.application.Platform;
 import javafx.fxml.FXML;
 import javafx.scene.Node;
+import javafx.scene.Parent;
 import javafx.scene.input.MouseEvent;
+import javafx.scene.layout.ColumnConstraints;
+import javafx.scene.layout.GridPane;
 import javafx.scene.layout.VBox;
 
 import java.util.function.Consumer;
@@ -21,6 +25,7 @@ public final class FxmlDocumentController {
 
     public FxmlDocumentController() {
         hyperlinkConsumer = null;
+        Platform.runLater(this::setupWidthListener);
     }
 
     /** This method is used to bind to the {@code onMouseClicked} attribute in the rendered FXML document.
@@ -50,4 +55,35 @@ public void setHyperlinkConsumer(Consumer<String> consumer) {
     public VBox getBodyNode() {
         return body;
     }
+
+    private void setupWidthListener() {
+        if (body != null) {
+            body.maxWidthProperty().addListener((observable, oldValue, newValue) -> {
+                if (newValue != null && newValue.doubleValue() > 0.0) {
+                    updateAllGridPanes(body, newValue.doubleValue());
+                }
+            });
+            if (body.getMaxWidth() > 0.0) {
+                updateAllGridPanes(body, body.getMaxWidth());
+            }
+        }
+    }
+
+    private void updateAllGridPanes(Parent node, double containerWidth) {
+        for (Node child : node.getChildrenUnmodifiable()) {
+            if (child instanceof GridPane gridPane) {
+                // Update the `maxWidth` of all columns according to the container width
+                for (ColumnConstraints column : gridPane.getColumnConstraints()) {
+                    // Weight data is temporarily stored through the 'minWidth' attribute
+                    double percentage = column.getMinWidth();
+                    if (percentage > 0.0) {
+                        column.setMaxWidth(containerWidth * percentage);
+                    }
+                }
+            }
+            if (child instanceof Parent parent) {
+                updateAllGridPanes(parent, containerWidth);
+            }
+        }
+    }
 }
diff --git a/desktop/src/cn/harryh/arkpets/utils/markdown/TableFxmlNodeRenderer.java b/desktop/src/cn/harryh/arkpets/utils/markdown/TableFxmlNodeRenderer.java
deleted file mode 100644
index c3f3d8cb..00000000
--- a/desktop/src/cn/harryh/arkpets/utils/markdown/TableFxmlNodeRenderer.java
+++ /dev/null
@@ -1,175 +0,0 @@
-/** Copyright (c) 2022-2025, Harry Huang
- * At GPL-3.0 License
- */
-package cn.harryh.arkpets.utils.markdown;
-
-import org.commonmark.ext.gfm.tables.*;
-import org.commonmark.node.*;
-import org.commonmark.renderer.NodeRenderer;
-import org.commonmark.renderer.html.HtmlNodeRendererContext;
-import org.commonmark.renderer.html.HtmlWriter;
-
-import java.util.HashMap;
-import java.util.Map;
-import java.util.Set;
-
-
-/** The modded node renderer that renders all the table nodes to FXML used by JavaFX.
- * This implementation is adapted from {@link org.commonmark.ext.gfm.tables.internal.TableHtmlNodeRenderer} class.
- */
-public class TableFxmlNodeRenderer implements NodeRenderer {
-    private final HtmlNodeRendererContext context;
-    private final HtmlWriter writer;
-    private final Map<TableBlock, RowColumnValue> rowColumnCount;
-
-    public TableFxmlNodeRenderer(HtmlNodeRendererContext context) {
-        this.context = context;
-        this.writer = context.getWriter();
-        this.rowColumnCount = new HashMap<>(4);
-    }
-
-    @Override
-    public Set<Class<? extends Node>> getNodeTypes() {
-        return Set.of(TableBlock.class, TableHead.class, TableBody.class, TableRow.class, TableCell.class);
-    }
-
-    @Override
-    public void render(Node node) {
-        if (node instanceof TableBlock tableBlock) {
-            renderBlock(tableBlock);
-        } else if (node instanceof TableHead tableHead) {
-            renderHead(tableHead);
-        } else if (node instanceof TableBody tableBody) {
-            renderBody(tableBody);
-        } else if (node instanceof TableRow tableRow) {
-            renderRow(tableRow);
-        } else if (node instanceof TableCell tableCell) {
-            renderCell(tableCell);
-        }
-    }
-
-    protected void renderBlock(TableBlock tableBlock) {
-        writer.tag("GridPane", FxmlPrefabs.TABLE.getAttrs());
-        writer.line();
-
-        rowColumnCount.put(tableBlock, new RowColumnValue());
-        renderChildren(tableBlock);
-        rowColumnCount.remove(tableBlock);
-
-        writer.tag("/GridPane");
-        writer.line();
-    }
-
-    protected void renderHead(TableHead tableHead) {
-        if (tableHead.getParent() instanceof TableBlock tableBlock) {
-            renderChildren(tableHead);
-            rowColumnCount.get(tableBlock).increaseRow();
-        } else {
-            throw new RuntimeException("Illegal parent of table head");
-        }
-    }
-
-    protected void renderBody(TableBody tableBody) {
-        if (tableBody.getParent() instanceof TableBlock tableBlock) {
-            renderChildren(tableBody);
-            rowColumnCount.get(tableBlock).increaseRow();
-        } else {
-            throw new RuntimeException("Illegal parent of table body");
-        }
-    }
-
-    protected void renderRow(TableRow tableRow) {
-        if (tableRow.getParent().getParent() instanceof TableBlock tableBlock) {
-            renderChildren(tableRow);
-            rowColumnCount.get(tableBlock).increaseRow();
-        } else {
-            throw new RuntimeException("Illegal parent of table row");
-        }
-    }
-
-    protected void renderCell(TableCell tableCell) {
-        if (tableCell.getParent().getParent().getParent() instanceof TableBlock tableBlock) {
-            writer.tag("HBox", getCellAttrs(tableCell));
-            writer.line();
-
-            if (allChildrenAreText(tableCell)) {
-                writer.tag("TextFlow");
-                writer.tag("Text", FxmlPrefabs.TEXT.getAttrs());
-                renderChildren(tableCell);
-                writer.tag("/Text");
-                writer.tag("/TextFlow");
-            }
-
-            writer.tag("/HBox");
-            writer.line();
-            rowColumnCount.get(tableBlock).increaseColumn();
-        } else {
-            throw new RuntimeException("Illegal parent of table cell");
-        }
-    }
-
-    private Map<String, String> getCellAttrs(TableCell tableCell) {
-        if (tableCell.getParent().getParent().getParent() instanceof TableBlock tableBlock) {
-            RowColumnValue rc = rowColumnCount.get(tableBlock);
-            Map<String, String> attrs = new HashMap<>(8);
-            attrs.put("GridPane.rowIndex", String.valueOf(rc.row));
-            attrs.put("GridPane.columnIndex", String.valueOf(rc.column));
-            attrs.put("alignment", switch (tableCell.getAlignment()) {
-                case LEFT -> "CENTER_LEFT";
-                case CENTER -> "CENTER";
-                case RIGHT -> "CENTER_RIGHT";
-            });
-            attrs.putAll(FxmlPrefabs.TABLE_CELL.getAttrs());
-            return attrs;
-        } else {
-            throw new RuntimeException("Illegal parent of table cell");
-        }
-    }
-
-    private void renderChildren(Node parent) {
-        Node node = parent.getFirstChild();
-        while (node != null) {
-            Node next = node.getNext();
-            context.render(node);
-            node = next;
-        }
-    }
-
-    private boolean allChildrenAreText(Node parent) {
-        Node node = parent.getFirstChild();
-        while (node != null) {
-            Node next = node.getNext();
-            if (!(node instanceof Text ||
-                    node instanceof Code ||
-                    node instanceof Link ||
-                    node instanceof HtmlInline ||
-                    node instanceof Emphasis ||
-                    node instanceof StrongEmphasis
-            )) {
-                return false;
-            }
-            node = next;
-        }
-        return true;
-    }
-
-
-    private static class RowColumnValue {
-        private int row;
-        private int column;
-
-        private RowColumnValue() {
-            row = 0;
-            column = 0;
-        }
-
-        public void increaseRow() {
-            row += 1;
-            column = 0;
-        }
-
-        public void increaseColumn() {
-            column += 1;
-        }
-    }
-}
diff --git a/desktop/src/cn/harryh/arkpets/utils/markdown/TablesExtension.java b/desktop/src/cn/harryh/arkpets/utils/markdown/TablesExtension.java
deleted file mode 100644
index 9cadf889..00000000
--- a/desktop/src/cn/harryh/arkpets/utils/markdown/TablesExtension.java
+++ /dev/null
@@ -1,32 +0,0 @@
-/** Copyright (c) 2022-2025, Harry Huang
- * At GPL-3.0 License
- */
-package cn.harryh.arkpets.utils.markdown;
-
-import org.commonmark.Extension;
-import org.commonmark.ext.gfm.tables.internal.TableBlockParser;
-import org.commonmark.parser.Parser;
-import org.commonmark.renderer.html.HtmlRenderer;
-
-
-/** Extension for <a href="https://github.github.com/gfm/#tables-extension-">GFM tables</a> using "|" pipes.
- * This implementation is adapted from {@link org.commonmark.ext.gfm.tables.TablesExtension} class.
- */
-public class TablesExtension implements Parser.ParserExtension, HtmlRenderer.HtmlRendererExtension {
-    private TablesExtension() {
-    }
-
-    public static Extension create() {
-        return new TablesExtension();
-    }
-
-    @Override
-    public void extend(Parser.Builder parserBuilder) {
-        parserBuilder.customBlockParserFactory(new TableBlockParser.Factory());
-    }
-
-    @Override
-    public void extend(HtmlRenderer.Builder rendererBuilder) {
-        rendererBuilder.nodeRendererFactory(TableFxmlNodeRenderer::new);
-    }
-}

From db75027c3398d37080dc485866184df94d54c076 Mon Sep 17 00:00:00 2001
From: Harry Huang <harryhuang2652@qq.com>
Date: Mon, 17 Feb 2025 16:43:37 +0800
Subject: [PATCH 07/10] feat(mdRender): support image

---
 .../utils/markdown/CoreFxmlNodeRenderer.java  | 53 +++++++++++++++----
 1 file changed, 43 insertions(+), 10 deletions(-)

diff --git a/desktop/src/cn/harryh/arkpets/utils/markdown/CoreFxmlNodeRenderer.java b/desktop/src/cn/harryh/arkpets/utils/markdown/CoreFxmlNodeRenderer.java
index 3d0eb606..4096062f 100644
--- a/desktop/src/cn/harryh/arkpets/utils/markdown/CoreFxmlNodeRenderer.java
+++ b/desktop/src/cn/harryh/arkpets/utils/markdown/CoreFxmlNodeRenderer.java
@@ -10,6 +10,7 @@
 import org.commonmark.renderer.html.HtmlWriter;
 
 import java.util.*;
+import java.util.regex.Pattern;
 
 
 /** The modded node renderer that renders all the core nodes to FXML used by JavaFX.
@@ -70,12 +71,14 @@ public void render(Node node) {
     public void visit(Document document) {
         // FXML headers
         writer.raw(
-                "<?xml version=\"1.0\" encoding=\"UTF-8\"?>\n" +
-                        "<?import javafx.scene.control.*?>\n" +
-                        "<?import javafx.scene.layout.*?>\n" +
-                        "<?import javafx.scene.shape.*?>\n" +
-                        "<?import javafx.scene.text.*?>\n" +
-                        "<?import java.lang.*?>\n"
+                """
+                        <?xml version="1.0" encoding="UTF-8"?>
+                        <?import javafx.scene.control.*?>
+                        <?import javafx.scene.layout.*?>
+                        <?import javafx.scene.shape.*?>
+                        <?import javafx.scene.text.*?>
+                        <?import java.lang.*?>
+                        """
         );
 
         // Use VBox to wrap the whole document
@@ -150,7 +153,7 @@ public void visit(FencedCodeBlock fencedCodeBlock) {
 
     @Override
     public void visit(HtmlBlock htmlBlock) {
-        // TODO Not implemented
+        renderHtml(htmlBlock.getLiteral());
     }
 
     @Override
@@ -218,7 +221,22 @@ public void visit(OrderedList orderedList) {
 
     @Override
     public void visit(Image image) {
-        // TODO Not implemented
+        textFlow.openTextFlow();
+
+        AltTextVisitor altTextVisitor = new AltTextVisitor();
+        image.accept(altTextVisitor);
+        String altText = altTextVisitor.getAltText();
+
+        if (lastHref == null) {
+            lastHref = image.getDestination();
+        }
+        textFlow.openText(getHyperlinkAttachedAttrs(FxmlPrefabs.HYPERLINK.getAttrs()));
+        writer.text("! ");
+        writer.text(altText);
+        textFlow.closeText();
+        lastHref = null;
+
+        textFlow.closeTextFlow();
     }
 
     @Override
@@ -253,7 +271,7 @@ public void visit(Code code) {
 
     @Override
     public void visit(HtmlInline htmlInline) {
-        // TODO Not implemented
+        renderHtml(htmlInline.getLiteral());
     }
 
     @Override
@@ -344,6 +362,18 @@ protected void visitChildren(Node parent) {
         }
     }
 
+    private void renderHtml(String literal) {
+        if (Pattern.matches("^ *<br */?> *$", literal)) {
+            // <br> -> line break
+            textFlow.closeTextFlow();
+        } else if(Pattern.matches(" *<hr */?> *$", literal)) {
+            // <hr> -> separator
+            writer.tag("Separator", Map.of(), true);
+            writer.line();
+        }
+        // Other -> not implemented
+    }
+
     private void renderCodeBlock(String literal) {
         writer.tag("VBox", FxmlPrefabs.CODE_BLOCK.getAttrs());
         writer.line();
@@ -474,18 +504,21 @@ private static class AltTextVisitor extends AbstractVisitor {
         private AltTextVisitor() {
         }
 
-        String getAltText() {
+        public String getAltText() {
             return sb.toString();
         }
 
+        @Override
         public void visit(Text text) {
             sb.append(text.getLiteral());
         }
 
+        @Override
         public void visit(SoftLineBreak softLineBreak) {
             sb.append('\n');
         }
 
+        @Override
         public void visit(HardLineBreak hardLineBreak) {
             sb.append('\n');
         }

From 81a54703b5e44a13566d2ef14d1fa517d53d40b9 Mon Sep 17 00:00:00 2001
From: Harry Huang <harryhuang2652@qq.com>
Date: Mon, 17 Feb 2025 16:45:45 +0800
Subject: [PATCH 08/10] refactor(mdRender): codeblock using textarea

---
 .../utils/markdown/CoreFxmlNodeRenderer.java  | 51 ++++---------------
 .../markdown/FxmlDocumentController.java      | 21 +++++++-
 .../arkpets/utils/markdown/FxmlPrefabs.java   |  1 +
 3 files changed, 30 insertions(+), 43 deletions(-)

diff --git a/desktop/src/cn/harryh/arkpets/utils/markdown/CoreFxmlNodeRenderer.java b/desktop/src/cn/harryh/arkpets/utils/markdown/CoreFxmlNodeRenderer.java
index 4096062f..277e3dd7 100644
--- a/desktop/src/cn/harryh/arkpets/utils/markdown/CoreFxmlNodeRenderer.java
+++ b/desktop/src/cn/harryh/arkpets/utils/markdown/CoreFxmlNodeRenderer.java
@@ -9,6 +9,7 @@
 import org.commonmark.renderer.html.HtmlNodeRendererContext;
 import org.commonmark.renderer.html.HtmlWriter;
 
+import java.nio.charset.StandardCharsets;
 import java.util.*;
 import java.util.regex.Pattern;
 
@@ -140,15 +141,7 @@ public void visit(BulletList bulletList) {
 
     @Override
     public void visit(FencedCodeBlock fencedCodeBlock) {
-        String literal = fencedCodeBlock.getLiteral();
-        Map<String, String> attrs = new LinkedHashMap<>();
-        String info = fencedCodeBlock.getInfo();
-        if (info != null && !info.isEmpty()) {
-            int space = info.indexOf(" ");
-            String language = space == -1 ? info : info.substring(0, space);
-            attrs.put("class", "language-" + language);
-        }
-        renderCodeBlock(literal);
+        renderCodeBlock(fencedCodeBlock.getLiteral());
     }
 
     @Override
@@ -164,13 +157,7 @@ public void visit(ThematicBreak thematicBreak) {
 
     @Override
     public void visit(IndentedCodeBlock indentedCodeBlock) {
-        writer.tag("VBox", FxmlPrefabs.BLOCK_QUOTE.getAttrs());
-        writer.line();
-
-        visitChildren(indentedCodeBlock);
-
-        writer.tag("/VBox");
-        writer.line();
+        renderCodeBlock(indentedCodeBlock.getLiteral());
     }
 
     @Override
@@ -375,15 +362,15 @@ private void renderHtml(String literal) {
     }
 
     private void renderCodeBlock(String literal) {
-        writer.tag("VBox", FxmlPrefabs.CODE_BLOCK.getAttrs());
+        writer.tag("TextArea", FxmlPrefabs.CODE_BLOCK.getAttrs());
         writer.line();
-        textFlow.openTextFlow();
 
-        textFlow.openText(getHyperlinkAttachedAttrs(FxmlPrefabs.TEXT.getAttrs()));
-        writer.text(literal);
+        writer.tag("userData");
+        writer.raw(Base64.getEncoder().encodeToString(literal.getBytes(StandardCharsets.UTF_8)));
+        writer.tag("/userData");
+        writer.line();
 
-        textFlow.closeTextFlow();
-        writer.tag("/VBox");
+        writer.tag("/TextArea");
         writer.line();
     }
 
@@ -405,18 +392,6 @@ private void renderListBlock(ListBlock listBlock) {
         writer.line();
     }
 
-    private boolean isInTightList(Paragraph paragraph) {
-        Node parent = paragraph.getParent();
-        if (parent != null) {
-            Node gramps = parent.getParent();
-            if (gramps instanceof ListBlock) {
-                ListBlock list = (ListBlock) gramps;
-                return list.isTight();
-            }
-        }
-        return false;
-    }
-
     private int getChildrenLength(Node parent) {
         int count = 0;
         for (Node node = parent.getFirstChild(); node != null; node = node.getNext()) {
@@ -425,14 +400,6 @@ private int getChildrenLength(Node parent) {
         return count;
     }
 
-    private Map<String, String> getAttrs(Node node, String tagName) {
-        return getAttrs(node, tagName, Map.of());
-    }
-
-    private Map<String, String> getAttrs(Node node, String tagName, Map<String, String> defaultAttributes) {
-        return context.extendAttributes(node, tagName, defaultAttributes);
-    }
-
     private Map<String, String> getHyperlinkAttachedAttrs(Map<String, String> defaultAttrs) {
         if (lastHref != null && !lastHref.isBlank()) {
             Map<String, String> attrs = new HashMap<>(8);
diff --git a/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlDocumentController.java b/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlDocumentController.java
index 9ab5b8be..87e76e22 100644
--- a/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlDocumentController.java
+++ b/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlDocumentController.java
@@ -7,11 +7,14 @@
 import javafx.fxml.FXML;
 import javafx.scene.Node;
 import javafx.scene.Parent;
+import javafx.scene.control.*;
 import javafx.scene.input.MouseEvent;
 import javafx.scene.layout.ColumnConstraints;
 import javafx.scene.layout.GridPane;
 import javafx.scene.layout.VBox;
 
+import java.nio.charset.StandardCharsets;
+import java.util.Base64;
 import java.util.function.Consumer;
 
 
@@ -25,7 +28,10 @@ public final class FxmlDocumentController {
 
     public FxmlDocumentController() {
         hyperlinkConsumer = null;
-        Platform.runLater(this::setupWidthListener);
+        Platform.runLater(() -> {
+            setupWidthListener();
+            updateAllCodeBlock(body);
+        });
     }
 
     /** This method is used to bind to the {@code onMouseClicked} attribute in the rendered FXML document.
@@ -86,4 +92,17 @@ private void updateAllGridPanes(Parent node, double containerWidth) {
             }
         }
     }
+
+    private void updateAllCodeBlock(Parent node) {
+        for (Node child : node.getChildrenUnmodifiable()) {
+            if (child instanceof TextArea textArea) {
+                if (textArea.getUserData() instanceof String string) {
+                    textArea.setText(new String(Base64.getDecoder().decode(string), StandardCharsets.UTF_8));
+                }
+            }
+            if (child instanceof Parent parent) {
+                updateAllCodeBlock(parent);
+            }
+        }
+    }
 }
diff --git a/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlPrefabs.java b/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlPrefabs.java
index a761f574..7ae34e00 100644
--- a/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlPrefabs.java
+++ b/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlPrefabs.java
@@ -43,6 +43,7 @@ public enum FxmlPrefabs {
     TEXT(Map.of(
     )),
     CODE_BLOCK(Map.of(
+            "editable", "false",
             "style", "-fx-background-color:#2481;-fx-background-radius:7.5px;" +
                     "-fx-border-color:#2484;-fx-border-width:1px;-fx-border-radius:7.5px;" +
                     "-fx-padding:10px;-fx-font-family:monospace;-fx-font-size:13px;"

From 32a70f6e3c5bc5f1e541d42378c3c39104409b58 Mon Sep 17 00:00:00 2001
From: Harry Huang <harryhuang2652@qq.com>
Date: Mon, 17 Feb 2025 20:15:09 +0800
Subject: [PATCH 09/10] feat(mdRender): support strikethrough and autolink

---
 .../utils/markdown/CoreFxmlNodeRenderer.java  | 23 ++++++++++++++-----
 .../arkpets/utils/markdown/FxmlConvertor.java |  8 ++++++-
 .../markdown/FxmlDocumentController.java      |  9 ++++++++
 .../arkpets/utils/markdown/FxmlPrefabs.java   |  3 +++
 4 files changed, 36 insertions(+), 7 deletions(-)

diff --git a/desktop/src/cn/harryh/arkpets/utils/markdown/CoreFxmlNodeRenderer.java b/desktop/src/cn/harryh/arkpets/utils/markdown/CoreFxmlNodeRenderer.java
index 277e3dd7..b20663ce 100644
--- a/desktop/src/cn/harryh/arkpets/utils/markdown/CoreFxmlNodeRenderer.java
+++ b/desktop/src/cn/harryh/arkpets/utils/markdown/CoreFxmlNodeRenderer.java
@@ -3,6 +3,7 @@
  */
 package cn.harryh.arkpets.utils.markdown;
 
+import org.commonmark.ext.gfm.strikethrough.Strikethrough;
 import org.commonmark.ext.gfm.tables.*;
 import org.commonmark.node.*;
 import org.commonmark.renderer.NodeRenderer;
@@ -43,15 +44,17 @@ public Set<Class<? extends Node>> getNodeTypes() {
                 Link.class, ListItem.class, OrderedList.class,
                 Image.class, Emphasis.class, StrongEmphasis.class,
                 Text.class, Code.class, HtmlInline.class,
-                SoftLineBreak.class, HardLineBreak.class, TableBlock.class,
-                TableHead.class, TableBody.class, TableRow.class,
-                TableCell.class
+                SoftLineBreak.class, HardLineBreak.class, Strikethrough.class,
+                TableBlock.class, TableHead.class, TableBody.class,
+                TableRow.class, TableCell.class
         );
     }
 
     @Override
     public void render(Node node) {
-        if (node instanceof TableBlock tableBlock) {
+        if (node instanceof Strikethrough strikethrough) {
+            renderStrikethrough(strikethrough);
+        } else if (node instanceof TableBlock tableBlock) {
             renderBlock(tableBlock);
         } else if (node instanceof TableHead tableHead) {
             renderHead(tableHead);
@@ -164,7 +167,7 @@ public void visit(IndentedCodeBlock indentedCodeBlock) {
     public void visit(Link link) {
         textFlow.openTextFlow();
 
-        lastHref = link.getDestination();
+        lastHref = context.urlSanitizer().sanitizeLinkUrl(link.getDestination());
         textFlow.openText(getHyperlinkAttachedAttrs(FxmlPrefabs.TEXT.getAttrs()));
         visitChildren(link);
         textFlow.closeText();
@@ -215,7 +218,7 @@ public void visit(Image image) {
         String altText = altTextVisitor.getAltText();
 
         if (lastHref == null) {
-            lastHref = image.getDestination();
+            lastHref = context.urlSanitizer().sanitizeImageUrl(image.getDestination());
         }
         textFlow.openText(getHyperlinkAttachedAttrs(FxmlPrefabs.HYPERLINK.getAttrs()));
         writer.text("! ");
@@ -271,6 +274,14 @@ public void visit(HardLineBreak hardLineBreak) {
         textFlow.closeTextFlow();
     }
 
+    // REGION: MISC EXTENSION
+
+    protected void renderStrikethrough(Strikethrough strikethrough) {
+        textFlow.openText(getHyperlinkAttachedAttrs(FxmlPrefabs.STRIKETHROUGH.getAttrs()));
+        visitChildren(strikethrough);
+        textFlow.closeText();
+    }
+
     // REGION: TABLE EXTENSION
 
     protected void renderBlock(TableBlock tableBlock) {
diff --git a/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlConvertor.java b/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlConvertor.java
index ad4191ac..371cbff1 100644
--- a/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlConvertor.java
+++ b/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlConvertor.java
@@ -5,6 +5,8 @@
 
 import cn.harryh.arkpets.utils.IOUtils;
 import javafx.fxml.FXMLLoader;
+import org.commonmark.ext.autolink.AutolinkExtension;
+import org.commonmark.ext.gfm.strikethrough.StrikethroughExtension;
 import org.commonmark.ext.gfm.tables.TablesExtension;
 import org.commonmark.node.Node;
 import org.commonmark.parser.Parser;
@@ -25,7 +27,11 @@ public class FxmlConvertor {
      */
     public static String toFxmlString(String markdown) {
         Parser parser = Parser.builder()
-                .extensions(List.of(TablesExtension.create()))
+                .extensions(List.of(
+                        AutolinkExtension.create(),
+                        StrikethroughExtension.create(),
+                        TablesExtension.create()
+                ))
                 .build();
         Node document = parser.parse(markdown);
         HtmlRenderer renderer = HtmlRenderer.builder()
diff --git a/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlDocumentController.java b/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlDocumentController.java
index 87e76e22..a113bbbb 100644
--- a/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlDocumentController.java
+++ b/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlDocumentController.java
@@ -49,6 +49,15 @@ private void handleHyperlinkClick(MouseEvent event) {
     }
 
     /** Sets the consumer that accepts the URL of the hyperlink the user clicked.
+     * <p>
+     * Remember to verify the security of the URL. The URL may be:
+     * <ul>
+     *     <li>Web "http://" link</li>
+     *     <li>Web "https://" link</li>
+     *     <li>Email "mailto:" link</li>
+     *     <li>Relative file link</li>
+     *     <li>Other unknown link</li>
+     * </ul>
      * @param consumer A string consumer.
      */
     public void setHyperlinkConsumer(Consumer<String> consumer) {
diff --git a/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlPrefabs.java b/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlPrefabs.java
index 7ae34e00..17f640bc 100644
--- a/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlPrefabs.java
+++ b/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlPrefabs.java
@@ -40,6 +40,9 @@ public enum FxmlPrefabs {
     STRONG_EMPHASIS(Map.of(
             "style", "-fx-font-weight:bold;-fx-font-style:normal;"
     )),
+    STRIKETHROUGH(Map.of(
+            "style", "-fx-strikethrough:true;"
+    )),
     TEXT(Map.of(
     )),
     CODE_BLOCK(Map.of(

From 39709737eb4dd601e289684040fba7704b47e40a Mon Sep 17 00:00:00 2001
From: Harry Huang <harryhuang2652@qq.com>
Date: Tue, 18 Feb 2025 20:31:36 +0800
Subject: [PATCH 10/10] chore: cleanup

---
 desktop/src/cn/harryh/arkpets/utils/FXMLHelper.java           | 2 +-
 .../harryh/arkpets/utils/markdown/CoreFxmlNodeRenderer.java   | 2 +-
 .../src/cn/harryh/arkpets/utils/markdown/FxmlConvertor.java   | 4 ----
 .../cn/harryh/arkpets/utils/markdown/TextFlowCoordinator.java | 2 +-
 4 files changed, 3 insertions(+), 7 deletions(-)

diff --git a/desktop/src/cn/harryh/arkpets/utils/FXMLHelper.java b/desktop/src/cn/harryh/arkpets/utils/FXMLHelper.java
index fb96e179..7fa84efe 100644
--- a/desktop/src/cn/harryh/arkpets/utils/FXMLHelper.java
+++ b/desktop/src/cn/harryh/arkpets/utils/FXMLHelper.java
@@ -26,7 +26,7 @@ private FXMLHelper() {
      * @return A record containing the controller and the FXML object hierarchy.
      * @throws IOException If an I/O exception occurs during loading.
      */
-    public static <T extends Application> LoadFXMLResult<T> loadFXML( URL location)
+    public static <T extends Application> LoadFXMLResult<T> loadFXML(URL location)
             throws IOException {
         FXMLLoader fxml = new FXMLLoader(location);
         Node content = Objects.requireNonNull(fxml.load());
diff --git a/desktop/src/cn/harryh/arkpets/utils/markdown/CoreFxmlNodeRenderer.java b/desktop/src/cn/harryh/arkpets/utils/markdown/CoreFxmlNodeRenderer.java
index b20663ce..a99fbff6 100644
--- a/desktop/src/cn/harryh/arkpets/utils/markdown/CoreFxmlNodeRenderer.java
+++ b/desktop/src/cn/harryh/arkpets/utils/markdown/CoreFxmlNodeRenderer.java
@@ -364,7 +364,7 @@ private void renderHtml(String literal) {
         if (Pattern.matches("^ *<br */?> *$", literal)) {
             // <br> -> line break
             textFlow.closeTextFlow();
-        } else if(Pattern.matches(" *<hr */?> *$", literal)) {
+        } else if (Pattern.matches(" *<hr */?> *$", literal)) {
             // <hr> -> separator
             writer.tag("Separator", Map.of(), true);
             writer.line();
diff --git a/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlConvertor.java b/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlConvertor.java
index 371cbff1..088e07a0 100644
--- a/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlConvertor.java
+++ b/desktop/src/cn/harryh/arkpets/utils/markdown/FxmlConvertor.java
@@ -3,7 +3,6 @@
  */
 package cn.harryh.arkpets.utils.markdown;
 
-import cn.harryh.arkpets.utils.IOUtils;
 import javafx.fxml.FXMLLoader;
 import org.commonmark.ext.autolink.AutolinkExtension;
 import org.commonmark.ext.gfm.strikethrough.StrikethroughExtension;
@@ -13,7 +12,6 @@
 import org.commonmark.renderer.html.HtmlRenderer;
 
 import java.io.ByteArrayInputStream;
-import java.io.File;
 import java.io.IOException;
 import java.util.List;
 
@@ -46,8 +44,6 @@ public static String toFxmlString(String markdown) {
     public static FxmlDocumentController toFxmlController(String markdown) {
         String fxml = toFxmlString(markdown);
         try {
-            // TODO Debug only
-            IOUtils.FileUtil.writeString(new File("temp.fxml"), "UTF-8", fxml, false);
             FxmlDocumentController controller = new FxmlDocumentController();
             FXMLLoader loader = new FXMLLoader();
             loader.setClassLoader(FxmlConvertor.class.getClassLoader());
diff --git a/desktop/src/cn/harryh/arkpets/utils/markdown/TextFlowCoordinator.java b/desktop/src/cn/harryh/arkpets/utils/markdown/TextFlowCoordinator.java
index a82f0356..5f4678ca 100644
--- a/desktop/src/cn/harryh/arkpets/utils/markdown/TextFlowCoordinator.java
+++ b/desktop/src/cn/harryh/arkpets/utils/markdown/TextFlowCoordinator.java
@@ -13,7 +13,7 @@
 public class TextFlowCoordinator {
     private final HtmlWriter writer;
     private TextFlowStatus status;
-    
+
     public TextFlowCoordinator(HtmlWriter writer) {
         this.writer = writer;
         this.status = TextFlowStatus.CLOSED;