Custom paragraph markers

We have a number of pages which use shortcodes to produce headers and formatting. For example:

<div>
 <h2> Frequently asked questions </h2>
 [faqentry title="What is your question?"]<p>This is my answer</p>[/faqentry]
 [faqentry title="What is your question?"]<p>This is my answer</p>[/faqentry]
 [faqentry title="What is your question?"]<p>This is my answer</p>[/faqentry]
</div>

The [faqentry] shortcode produces a nice box, includes a <h3> tag and outputs the content. However Yoast doesn’t know this and instead says “1 subheading is followed by more than the recommended maximum of 300 words. Try to insert another subheading.” when we have a handful of these together. It clearly is aggregating all of the FAQ entries as there is no <h#> tag.

Is there a Yoast option/filter where we can mark certain shortcodes as producing headings or as new paragraphs so that we don’t have this error and can go ‘green’ on our readability analysis? Unfortunately every one of our pages ‘needs improvement’ with this area due to a FAQ area on every page.

• This topic was modified 8 years, 3 months ago by michaelkrieger.