Teleprompter for text and Markdown files
NinjaPrompter is a teleprompter for iPhone that supports scripts in plain text and Markdown files (.txt and .md), as well as import from Google Docs. Headings, bold, and italic in a Markdown file come in as formatting, and the file itself stays unchanged.
How do I import a .txt or .md file?
Tap Import file in the library, pick one file, check the review screen, then tap Save.
- Pick the file. Import file opens the Files picker, where you choose one file. Note that NinjaPrompter doesn't yet support sharing files from another app's Share sheet.
- Review it. Before anything is saved, the review screen shows a title you can edit (it starts as the file name, without .txt or .md), any Conversion notes, and a preview of the text.
- Save. Tap Save, and the script opens.
Conversion notes are short messages on the review screen about Markdown the app couldn't turn into script formatting, for example "A Markdown table was kept as literal text." A .txt file never has any, and they don't stop you from saving.
If you tap Cancel, or the file can't be imported, nothing is saved.
Which files can I import?
NinjaPrompter imports a file that ends in .txt or .md, is about 1 MB or smaller, and is saved as UTF-8 text. The text also has to fit in 100,000 characters, the most a script can hold. For a .md file, the count comes after conversion, so Markdown symbols and link addresses don't count.
If a file you choose can't be imported, an Import not completed screen says why, with a Try again button.
| The file | What to do |
|---|---|
| Ends in another extension, such as .docx, .rtf, or .markdown | Save the text as a .txt or .md file. A .markdown file only needs renaming to .md. |
| Is larger than about 1 MB | Choose a smaller file. |
| Has more than 100,000 characters after conversion | Shorten it, or split it into smaller files. The app doesn't cut text off for you. |
| Isn't saved as UTF-8, or as UTF-16 with a byte order mark | Save it as UTF-8 in your text editor. |
| Has no text, only blank lines or spaces | Add text. |
| Can't be read, for example because it hasn't finished downloading | Make sure it's downloaded, then tap Try again. |
What does a .txt file keep?
Everything, as you typed it: every line break, blank line, and symbol, with no formatting. A # or ** stays on screen as typed, because the app reads a .txt as plain text, not Markdown. For headings, bold, or italic, use a .md file.
What carries over from a Markdown file?
NinjaPrompter imports headings, bold, and italic from a .md file as formatting. The table shows how common Markdown converts.
| In the .md file | In the script |
|---|---|
Headings: # Title to ###### Title, or a line underlined with === or --- |
A heading of that level, without the symbols |
**bold**, *italic*, _italic_ |
Bold or italic text, without the symbols |
Links, such as [text](link) or [text][ref] |
The link text, without the address. [ref]: lines are dropped, and an address typed on its own stays as text |
| Inline code and fenced code blocks | The code as written, without the backticks or fence lines |
| Lists | One item per line, with its number or bullet kept as text |
| Images | A text note, [Image: alt text] or [Image], with a conversion note. No image is loaded |
| HTML and tables | Kept as written, with a conversion note |
Headings, bold, and italic are saved with the script, and you can switch them on in Reading settings. The podcast script template for a teleprompter uses headings to keep the parts of an episode apart.
Which line breaks does a .md file keep?
A .md file keeps blank lines and starts each heading and list item on a new line. Other lines with no blank line between them join into one line, as Markdown does. To keep a line break inside a paragraph, end the line with a backslash (\). Or save the file as .txt, which keeps every line break but no formatting.
Do pause marks work in a .txt or .md file?
Yes. Pause and pace marks such as //, [pause], and [slower] come in exactly as you typed them, in a .txt or a .md file, and work as they do in any script. That page also says how the prompter treats other bracketed text, such as the image notes above.
To try it, save one of the sample teleprompter scripts as a .txt file and import it.
Can I refresh a script from its file?
No. The app reads the file once, when you import it, and keeps its name but no link to it. The script screen shows the file name and says, "This is a local copy. Import the file again to bring in changes."
Importing the same file again saves a new script, and the earlier one stays in your library as it was. Scripts from Google Docs are different: you can refresh them from the Doc.
Is importing a .txt or .md file free?
Yes. Importing a file works during the 7-day trial, on the free plan, and with a subscription. On the free plan, saving an import switches your active script to it and locks the current one, and you can switch once a week. The support page explains the trial and the free plan.