Capable Markdown global page shows no results, even though issues do have .md attachments

What you are seeing

The Capable Markdown global page shows no results, even though issues do have .md attachments.


#Why it happens

The page is driven by a search index that is only written while the app is licensed, and only when a .md file is added to or removed from an issue. An unlicensed site, or one where no .md file has changed since install, has nothing in the index.


#What to do

Check the licence in Jira > Apps > Manage apps. Once licensed, the index fills as .md files are added or removed; an issue's existing files appear the next time a .md file on that issue is added or removed.


#Settings involved

Setting

Where

What it does

Project filter

Apps > Capable Markdown > project selector

Limits the list to the projects you pick. If that leaves nothing, a Clear filters button appears.


#Limits that apply here

Limit

Value

What happens

Global page results per fetch

50 issues

The Capable Markdown page loads 50 issues at a time; 'Show more' fetches the next page.


#A few things that catch people out

  • Without an active licence the whole panel and the whole global page are replaced by a licence card. Existing documents cannot be read through the app, though the .md files remain downloadable from Jira's attachment list.

  • The issue panel reads attachments directly, so a document can show on the issue while the global page still misses it.



Found it? Good.