miku-docx2md-java

miku-docx2md-java is the Java straight-conversion runtime, CLI, and Maven plugin for miku-docx2md.

The tool converts local .docx files to Markdown. The Java version keeps the Node.js / TypeScript upstream vocabulary and observable CLI behavior traceable, while packaging the converter as a Maven-built executable jar.

Usage

Build:

mvn test
mvn package
sh scripts/smoke-maven-plugin.sh

Run:

java -jar miku-docx2md/target/miku-docx2md-0.9.0.jar ./sample.docx --out ./sample.md

Summary output:

java -jar miku-docx2md/target/miku-docx2md-0.9.0.jar ./sample.docx --out ./sample.md --summary --summary-out ./sample.summary.txt

Image assets:

java -jar miku-docx2md/target/miku-docx2md-0.9.0.jar ./sample.docx --out ./sample.md --assets-dir ./sample.assets

Debug comments:

java -jar miku-docx2md/target/miku-docx2md-0.9.0.jar ./sample.docx --out ./sample.md --debug

Batch directory conversion:

java -jar miku-docx2md/target/miku-docx2md-0.9.0.jar \
  --input-directory ./docx \
  --output-directory ./markdown \
  --recursive

Maven plugin single-file conversion:

mvn -N jp.igapyon:miku-docx2md-maven-plugin:0.9.0:convert \
  -Dmiku-docx2md.inputFile=path/to/input.docx \
  -Dmiku-docx2md.outputFile=path/to/output.md

Maven plugin directory conversion:

mvn -N jp.igapyon:miku-docx2md-maven-plugin:0.9.0:convert-directory \
  -Dmiku-docx2md.inputDirectory=path/to/docx \
  -Dmiku-docx2md.outputDirectory=path/to/markdown \
  -Dmiku-docx2md.recursive=false

Current Scope

• Java source / target compatibility: 1.8
• Build tool: Maven
• Test framework: JUnit Jupiter
• Primary verification: mvn test
• Runtime package: executable fat jar under miku-docx2md/target/
• Distribution package: miku-docx2md/target/miku-docx2md-0.9.0-dist.zip
• Maven plugin: miku-docx2md-maven-plugin

The Java port covers the runtime core, CLI path, Maven plugin path, document XML, relationships, styles, numbering, Markdown rendering, image asset extraction, summary text, file output, and Java-side batch conversion. Browser UI behavior from upstream is out of scope for this Java repository.

GitHub Release asset workflow support is provided by .github/workflows/release-cli-runtime.yml. It builds from v* tags or manual tag_name dispatch and uploads the runtime jar plus sources jar.

The Maven plugin full-coordinate smoke check is provided by scripts/smoke-maven-plugin.sh. It installs the local reactor artifacts, then exercises the convert and convert-directory goals through the plugin coordinate.

Upstream And Sister Reference

• Upstream Node.js / TypeScript repository: https://github.com/igapyon/miku-docx2md
• Local upstream checkout used for this conversion: ../miku-docx2md
• Upstream snapshot checked locally: branch tiga0508wfj, commit 0667817331d617b5c8eec5a529a6b430a4d7b91f
• Sister Java project: https://github.com/igapyon/miku-xlsx2md-java
• Local sister checkout used as the Java shape reference: ../miku-xlsx2md-java
• Closest local sister checkout for Maven plugin and batch CLI shape: workplace/miku-xlsx2md-java-devel

See docs/ for upstream class, CLI, and test mapping.

Repository Operation

workplace/ is a local scratch area for upstream clones, generated comparison outputs, extracted archives, and temporary verification artifacts. Only workplace/.gitkeep is tracked.

.mvn/jvm.config is tracked for repository-local Maven JVM settings.

License

Apache License 2.0. See LICENSE.