---
name: "Pandoc::Selector"
section: "3pm"
platform: "linux"
package: "libpandoc-elements-perl"
version: "0.38-7"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/Pandoc::Selector"
---

# Pandoc::Selector(3pm)

Pandoc document selector language

## NAME

Pandoc::Selector - Pandoc document selector language

## SYNOPSIS

```
  my $selector = Pandoc::Selector->new('Code.perl|CodeBlock.perl');
  # check whether an element matches
  $selector->match($element);
  # use as element method
  $element->match('Code.perl|CodeBlock.perl')
```

## DESCRIPTION

Pandoc::Selector provides a language to select elements of a Pandoc document. It borrows ideas from CSS Selectors \<https://www.w3.org/TR/selectors-3/\>, XPath \<https://www.w3.org/TR/xpath/\> and similar languages.

The language is being developed together with this implementation.

## EXAMPLES

```
  Header#main
  Code.perl
  Code.perl.raw
  :inline
```

## SELECTOR GRAMMAR

Whitespace between parts of the syntax is optional and not included in the following grammar. A **Selector** is a list of one or more **expression lists** separated by pipes (`"|"`). For instance the selector `"Subscript|Superscript"` selects both Subscript elements and Superscript elements.

```
  Selector        ::= ExpressionList ( '|' ExpressionList )*
```

An **expression list** is a list of one or more **expressions**:

```
  ExpressionList  ::= Expression ( Expression )*
```

An **expression** is any of **name expression**, **id expression**, **class** **expression**, and **type expression**.

```
  Expression      ::= NameExpression
                      | IdExpression
                      | ClassExpression
                      | TypeExpression
  NameExpression  ::= Name
  Name            ::= [A-Za-z]+
  IdExpression    ::= '#' [\p{L}\p{N}_-]+
  ClassExpression ::= '.' [\p{L}\p{N}_-]+
  TypeExpression  ::= ':' Name
```

## SEE ALSO

See example filter `"select"` to select parts of a document.