Known UX Issues

When the user selects Open, asciitor requests the supported AsciiDoc, Markdown, and plain-text MIME types through Android’s OpenDocument contract. AndroidX sends the MIME list as Intent.EXTRA_MIME_TYPES with / as the intent’s primary type because an Android intent accepts only one primary MIME type.

Some Android file pickers do not fully honor the extra MIME-type list, and some document providers assign broad or inaccurate MIME types. On those devices, unsupported files can remain visible and selectable instead of being hidden or disabled.

asciitor mitigates this by validating the selected filename before reading it. Only .adoc, .asciidoc, .md, .markdown, and .txt files are accepted; other selections produce an explanatory message.

Exact extension filtering would require replacing the system picker with an app-owned file browser. The system picker is retained because it provides familiar navigation and storage-provider access without broader storage permissions. Revisit this decision only if the rejected-selection experience becomes a significant usability problem.