pandoc-glfm is a pandoc filter for adding some GitLab Flavored Markdown features to pandoc:

• tip (note, tip, important, caution, warning) with title

  > [!tip] My title
  > My tip

• task lists (with disabled tasks)

  * [x] Finished task
  * [ ] To do task
  * [~] Disabled task

• tables using the <br> line separator

  | Name | Details |
  | ---  | ---     |
  | Item1 | This text is on one line |
  |       | This item has:<br><br>- Item2<br>- Item3 |

pandoc-glfm requires python, a programming language that comes pre-installed on linux and Mac OS X, and which is easily installed on Windows.

Install pandoc-glfm using the bash command

$ pipx install pandoc-glfm

To upgrade to the most recent release, use

$ pipx upgrade pandoc-glfm

pipx is a script to install and run python applications in isolated environments from the Python Package Index, PyPI. It can be installed using instructions given here.

If you have any difficulties with pandoc-glfm, please feel welcome to file an issue on github so that we can help.

Install hatch, then run

$ hatch run pip install pre-commit
$ hatch run pre-commit install

to install pre-commit before working on your changes.

When your changes are ready, run

$ hatch test
$ hatch fmt --check
$ hatch run lint:check
$ hatch run docs:build
$ hatch build -t wheel

for running the tests, checking the style, building the documentation and building the wheel.