https://github.com/tfc/pandoc-drawio-filter

Embedd drawio images into markdown files for direct processing in pandoc
https://github.com/tfc/pandoc-drawio-filter

drawio latex markdown pandoc pandoc-filter pdf

Last synced: about 1 month ago
JSON representation

Embedd drawio images into markdown files for direct processing in pandoc

• Host: GitHub
• URL: https://github.com/tfc/pandoc-drawio-filter
• Owner: tfc
• License: mit
• Created: 2021-12-20T15:27:34.000Z (almost 3 years ago)
• Default Branch: master
• Last Pushed: 2022-12-21T00:22:06.000Z (almost 2 years ago)
• Last Synced: 2024-07-18T05:36:58.968Z (2 months ago)
• Topics: drawio, latex, markdown, pandoc, pandoc-filter, pdf
• Language: Nix
• Homepage:
• Size: 12.7 KB
• Stars: 6
• Watchers: 2
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

README

        
# pandoc-drawio-filter

This repository contains the python package `pandoc-drawio-filter` with the tool

`pandoc-drawio`, which helps [`pandoc`](https://pandoc.org/) convert `.drawio`

files to PDF before embedding them when referenced as images in markdown.

## Usage

Make sure that you have the following command line tools in your `PATH`

environment:

- [`drawio`](https://github.com/jgraph/drawio-desktop)

- (plus the usual tools that you use with `pandoc`, like TeX etc.)

- `xvfb` if you intend to run this in some container that has no X service

Write markdown documents as usual, with drawio images like this:

```

![my pretty drawio image](my-image.drawio)

```

Then, run pandoc like this:

```sh

pandoc -F pandoc-drawio my-document.md -o my-document.pdf

```

## Python Package Management

I currently only use the [`nix`](https://nixos.org) package manager for

everything.

It may be the case that the `setup.py` can be easily extended in order to upload

the package to the usual python package infrastructure.

I am happy to accept pull requests as i have neither the expertise nor the

bandwidth.