https://github.com/rlespinasse/drawio-export
Export Draw.io diagrams using docker
https://github.com/rlespinasse/drawio-export
docker drawio drawio-batch drawio-tools hacktoberfest
Last synced: 4 months ago
JSON representation
Export Draw.io diagrams using docker
- Host: GitHub
- URL: https://github.com/rlespinasse/drawio-export
- Owner: rlespinasse
- License: mit
- Created: 2020-04-05T18:27:36.000Z (about 6 years ago)
- Default Branch: v4.x
- Last Pushed: 2025-03-18T16:57:54.000Z (over 1 year ago)
- Last Synced: 2025-03-31T17:20:29.789Z (about 1 year ago)
- Topics: docker, drawio, drawio-batch, drawio-tools, hacktoberfest
- Language: Shell
- Homepage: https://hub.docker.com/r/rlespinasse/drawio-export
- Size: 270 KB
- Stars: 67
- Watchers: 2
- Forks: 11
- Open Issues: 4
-
Metadata Files:
- Readme: README.adoc
- Contributing: CONTRIBUTING.md
- Funding: .github/FUNDING.yml
- License: LICENSE
- Code of conduct: CODE_OF_CONDUCT.md
- Security: SECURITY.md
Awesome Lists containing this project
README
= Draw.io Export
Export Draw.io diagrams using docker
== Features
* Recursive export
* Partial export (newer, or based on git reference)
* Additional export formats with link extraction
== Supported Export formats
* **draw.io** export formats : jpg, pdf, png, svg, and xml
* **drawio-exporter** additional formats
** adoc - Export in png and create an additional asciidoc file (with support external links).
** md - Export in png and create an additional markdown file (with support external links).
== Additional fonts
Check installed fonts list from https://github.com/rlespinasse/docker-drawio-desktop-headless[drawio-desktop-headless] docker base image.
NOTE: Want a new font package, modify the https://github.com/rlespinasse/docker-drawio-desktop-headless[drawio-desktop-headless] project.
== Installation
[source,bash]
----
docker pull rlespinasse/drawio-export
----
== Usage
.Print the available options
[source,bash]
----
docker run -it rlespinasse/drawio-export --help
----
.Simple run with default options
[source,bash]
----
$ cd directory-with-drawio-files
$ docker run -it -v $(pwd):/data rlespinasse/drawio-export
+ export file : ./file1.drawio
- export page 1 : Page-1
\ generate pdf file
- export page 2 : Page-2
\ generate pdf file
----
== Build on top of
* https://github.com/rlespinasse/docker-drawio-desktop-headless[**rlespinasse/drawio-export-headless**] as base docker image to use Draw.io Desktop for its command lines,
* https://github.com/rlespinasse/drawio-exporter[**drawio-exporter**] as backend for export capabilities.
== Used by
* GitHub Action https://github.com/rlespinasse/drawio-export-action[**drawio-export-action**] : which is build on top of **drawio-export** docker image.
== Contributing
Pull requests are welcome.
For major changes, please open an issue first to discuss what you would like to change.
Please make sure to update tests as appropriate.