Tags & Codes Reference
Complete guide to all tags, control codes, keyboard shortcuts, and BANA formatting rules.
Getting Started
BWTA converts documents into braille. Upload a file, choose your translation options, then open the editor to review and refine the output.
To upload a file:
- Click the upload area on the home page, or drag and drop a file onto it.
- Choose your braille code, grade, and math notation (if applicable).
- Click Open Editor to translate and edit.
Supported formats:
- PDF, DOCX, TXT, HTML, Markdown, EPUB
- Images (PNG, JPG) — OCR extraction
Maximum file size: 50 MB.
Translation Options
After uploading a file you can configure how it will be translated:
- Braille Code —UEB (Unified English Braille, the current international standard) or EBAE (English Braille American Edition, the legacy US standard).
- Grade —Grade 1 (uncontracted, letter-for-letter) or Grade 2 (contracted, uses abbreviations for common words).
- Math Notation (shown when math is detected) —Nemeth Code or UEB Math.
Your selections are saved in your browser and will be remembered the next time you visit.
The Editor
The editor shows your source document and braille output side by side:
- Left pane (Format) — Your source document with tags that control structure and formatting. Edit the text, add headings, lists, emphasis, and braille control codes. Tags are highlighted in blue, math in purple, and control codes in amber.
- Right pane (Braille) — The formatted braille output displayed in simulated braille font. Shows page breaks and page numbers matching your page size settings. You can also edit the braille directly.
- Settings sidebar — Configure page size, page numbering, braille code (UEB/EBAE), grade, and math notation. Click Apply Settings to re-translate with new settings.
Changes in the left pane automatically update the braille on the right. The toolbar provides download buttons for BRF, eBraille, Markdown, and EPUB exports.
Format Pane (Left Side)
The format pane shows your source document with tags that control braille formatting. Select text and apply formatting with keyboard shortcuts:
| Shortcut | Action |
|---|---|
| Ctrl+1–6 | Heading 1–6 |
| Ctrl+P | Paragraph |
| Ctrl+B | Bold |
| Ctrl+I | Italic |
| Ctrl+L | List Item |
| Ctrl+M | Math |
| Ctrl+Z | Undo |
| Ctrl+Shift+Z | Redo |
Use the tag buttons in the toolbar to insert or toggle tags. Right-click for options including Remove Tag and Insert Code (for braille control codes like page breaks and grade changes).
See the Tags & Codes Reference for a complete guide to all tags and control codes.
Braille Pane (Right Side)
The braille pane shows the formatted braille output in a simulated braille font. It displays page breaks and page numbers according to your page size settings.
You can edit the braille directly by clicking into a segment and typing. Use the arrow keys to navigate — up/down moves by line, left/right by character.
Page settings (in the sidebar):
- Page size — LETTER (32 cells × 25 lines) or WIDE (40 cells × 25 lines), or custom
- Page numbering — position (bottom-right, bottom-left, top-right, top-left, or none)
Exporting
From the editor toolbar, click Export to download your work:
- BRF — Braille Ready Format. The standard file format for braille embossers. Includes page layout and numbering.
- eBraille (.ebrl) — A ZIP archive containing the braille content in HTML format. Used for digital braille reading.
- Markdown — The tagged source document in Markdown format.
- EPUB — The source document as an accessible e-book.
Saving & Loading
Saving requires an account. Click Sign In in the header to register or log in.
To save your work:
- Open the editor with a translated document.
- Click Save in the toolbar.
- Give your work a name (or keep the auto-generated one).
To load a saved work:
- Sign in to your account.
- Open the user menu (your name in the header).
- Select My Works to see your saved documents.
- Click a work to open it in the editor.
Keyboard Shortcuts
| Shortcut | Action | Mode |
|---|---|---|
| Ctrl+1–6 | Heading 1–6 | Format |
| Ctrl+B | Bold | Format |
| Ctrl+I | Italic | Format |
| Ctrl+L | List Item | Format |
| Ctrl+Q | Blockquote | Format |
| Ctrl+Z | Undo | All |
| Ctrl+Shift+Z | Redo | All |
| f d s | Dots 1 2 3 | Braille |
| j k l | Dots 4 5 6 | Braille |
FAQ & Tips
Can I use BWTA without an account?
Yes. You can upload, translate, edit, and export without signing in. An account is only needed to save and load works.
My PDF didn't parse correctly. What can I do?
Scanned PDFs (image-only) may not extract text well. Try exporting the document to DOCX or TXT from the original application before uploading.
What braille tables does BWTA use?
BWTA uses liblouis, the open-source braille translation library, with official UEB and EBAE tables.
How do I report a bug or request a feature?
Use the button in the bottom-left corner of any page to submit bug reports, feature requests, or general feedback.