Filter Info > Filter Kind > Block plug-in

The Block plug-in is displayed when you choose Block in the Filter Kind pop-up menu in the Filter Info pane.

This plug-in is used by the default Block and Change filters.

This plug-in looks for two bits of text: one marking the start of the block you're interested in, and another marking the end. If the start text is left blank, the start of the input text is used, and similarly if the end text is left blank, the end of the input text is used.

If the start and/or end text appears more than once in the input text, you can disclose additional options. Drag to the left the small dot to the right of the fields to reveal these extra options.

These extra options enable you to choose whether to search from the start or the end of the input text, and search for a specific occurrence of the text, e.g. start from the 3rd occurrence from the end of the text. By default, the filter will find the first occurrence from the start of the input.

Note that the end text is constrained by the start text — it won't find a match for the end text before the start text.

This filter outputs the text between the start and end markers, without including them. This text can detect changes via the checkbox in the Options page. If either marker can not be found, it results in a failure.