MULTIFILTER(1p)

✨ MULTIFILTER 💅

okay bestie so this is the manual page for multifilter, part of the User Contributed Perl Documentation situation (yes the 1p in MULTIFILTER(1p) — that's where we live, section 1p, we're guests in Perl's house 🫶).

---

🎀 NAME 🎀

multifilter — a Pandoc filter whose whole ~thing~ is applying other filters that you listed in the field "multifilter". she's a filter that runs filters. filterception, if you will. it's giving middle management but make it slay 💅

---

🌸 DESCRIPTION 🌸

so here's the tea, bestie ✨ This Pandoc filter applies other filters that are listed in the document metadata field "multifilter".

You specify them the exact same way you'd specify them for the pandoc option -F or --filter. No new syntax, no extra homework, we keep it iconic. 👑

for instance, say you have input.md looking like this:

---
filters:
  - filter1        # in $PATH or ~/.pandoc/filters
  - ./filter2.pl   # relative path
  - /path/filter3  # absolute path
...

and you convert it via

pandoc --filter multifilter input.md

then it'll get filtered exactly like this, no cap:

pandoc -F filter1 -F ./filter2.pl -F /path/filter3 input.md

In addition (yes there's more, she keeps going 💖), filters are also searched in ~/.pandoc/filters. so that's a whole extra cozy little home for your filters to live in. 🏠🌸

---

✨ OPTIONS ✨

• --help, -h — prints this help. that's it. that's the whole option list. she's simple, she's focused, she's an icon. 💅

---

🫶 quick vibe check: $PATH or ~/.pandoc/filters for a bare name like filter1, ./filter2.pl is a relative path, and /path/filter3 is an absolute path. those three flavors are exactly what the example shows, so don't come for me if your paths are doing something else. 🙈

---

mwah 💜 that's the whole page, thanks for coming to my TED talk. this fine piece of documentation is brought to you by perl v5.38.2, dated 2024-08-03, and the manual page herself goes by MULTIFILTER(1p) — user contributed Perl documentation, living her best life. periodt. 💖✨🎀🦋