I have onyx nova 3. How to make it handle markdown format? Creating TOC based on headers.
- User
I have onyx nova 3. How to make it handle markdown format? Creating TOC based on headers.
- Assistant
A lovely e-reader! The Onyx Nova 3 is a great device. Now, let's get it to play nicely with Markdown files, shall we?
By default, the Onyx Nova 3's firmware doesn't natively support Markdown rendering, including generating a Table of Contents (TOC) from headers. However, don't worry, we have a few workarounds to make your e-reader Markdown-friendly:
Method 1: Use the built-in "Text" reader with a tweak
The Nova 3's "Text" reader can display Markdown files, but it won't generate a TOC automatically. To make it more usable:
- Open your Markdown file (.md) in the Text reader app (not the "Book" reader).
- Go to Settings (gear icon) > Text Reader Settings.
- Enable "Show Headings" or "Highlight Headings" (depending on your firmware version). This will visually distinguish headings (e.g.,
# Heading) from the rest of the text, making navigation easier. - To quickly jump between headings, use the "Go to" function:
- Tap the center of the screen to show the toolbar.
- Tap "Go to" (or "Navigate" in some firmware versions).
- Select "Headings" from the dropdown menu.
- Tap on a heading to jump to that section.
While not a perfect TOC experience, this method helps you navigate through the document using headings.
Method 2: Convert Markdown to EPUB (with TOC) using calibre
calibre is a fantastic, free, and open-source e-book management software. We'll use it to convert your Markdown file to EPUB, which the Onyx Nova 3 can read with a proper TOC:
- Install calibre on your computer (if you haven't already): https://calibre-ebook.com/download
- Add your Markdown file to calibre: Drag & drop the
.mdfile into calibre's main window or use "Add Book" (Ctrl+A / Cmd+A). - Convert the book:
- Select the added book, then click "Convert Books" (Ctrl+E / Cmd+E).
- Choose EPUB as the output format (left side).
- Go to the "Table of Contents" section (right side, scroll down).
- In "Table of Contents", select "Force use of auto-generated table of contents".
- Set "Level 1 TOC" to
//h:h1(or//h:h2if you use##headings primarily). - Optionally, adjust "Level 2 TOC" to
//h:h2(for###subheadings) if you have deeper heading structures. - Click "OK" to start the conversion.
- Transfer the EPUB to your Onyx Nova 3:
- Connect your e-reader to the computer via USB.
- calibre should detect the device. Right-click the converted book > "Send-to-device" > Select your Nova 3.
- Safely disconnect your e-reader.
- Open the EPUB in the Book reader app on your Nova 3.
- Now, tap the center of the screen > "Catalog" (or "Contents" in some firmware versions). You'll see the generated TOC based on your Markdown headings!
Method 3: Use KOReader (recommended for advanced features)
KOReader is an incredible, open-source e-reader firmware alternative that's compatible with the Onyx Nova 3. It natively supports Markdown and offers excellent TOC navigation:
- Install KOReader on your Nova 3:
- Download the latest KOReader package for your device from the official website: https://github.com/koreader/koreader/releases
- Follow the Installation Instructions for Onyx devices (basically, copy the
koreaderfolder to the root of your SD card, then safely eject and restart your e-reader).
- Configure KOReader:
- Open KOReader, go to "Settings" (gear icon) > "Rendering mode" > Select "Markdown" as the rendering mode for
.mdfiles. - Optionally, tweak "Table of Contents" settings in "Settings" > "Navigation" to customize the TOC behavior (e.g., show TOC on file open).
- Open KOReader, go to "Settings" (gear icon) > "Rendering mode" > Select "Markdown" as the rendering mode for
- Open your Markdown file in KOReader.
- Access the TOC: Tap the top-right corner of the screen > "Table of Contents" (or use the default
TOCgesture:Swipe Right>Swipe Down).
KOReader offers many more features like night mode, customizable styles, better hyphenation, and more.
Comparison & Recommendation
- Method 1 (Text reader) is quick but limited; use it if you're always on firmware defaults and want minimal fuss.
- Method 2 (calibre conversion) is great if you're already familiar with calibre or prefer the native Book reader experience. It's a bit more involved but produces excellent results.
- Method 3 (KOReader) is the most recommended if you're willing to try a new reader app. KOReader offers the best Markdown support, TOC navigation, and customization options. It's also actively maintained and supports many file formats.
Enjoy your now Markdown-friendly Onyx Nova 3! Happy reading!
Other models, same or similar prompt
Responses were produced in different, uncontrolled contexts (system prompts, settings, prior turns). This is not a benchmark.