Skip to content

usamaiqb/mark-reader

Repository files navigation

MarkReader

CI License: GPL v3

A lightweight, offline markdown and code file reader for Android with syntax highlighting and a built-in editor.

Features

Viewing

  • 📄 Markdown Rendering - Full CommonMark support including headings, bold, italic, blockquotes, tables, and fenced code blocks
  • 🎨 Syntax Highlighting - Code files highlighted for dozens of languages via Prism4j (Kotlin, Python, JavaScript, Java, C/C++, HTML, CSS, JSON, YAML, and more)
  • 🌓 Material You - Dynamic color, dark and light themes, edge-to-edge display

Editing

  • ✏️ Built-in Editor - Edit markdown files with a live preview tab; edit code files with syntax-aware display
  • 🔧 Formatting Toolbar - Quick access to bold, italic, headings, code blocks, links, and lists while editing
  • 💾 Save & Export - Save edited files in place or export to a new location with Save As
  • 🆕 Create New Files - Start a new markdown or code file from scratch

App

  • 📂 Open from Anywhere - Open files directly from any file manager via the standard share/open intent
  • 🔒 Privacy First - No ads, no tracking, no analytics
  • 📡 Offline - All processing happens locally on your device, no internet required

Screenshots

Home Screen Markdown Viewer Code Viewer Editor Dark Theme Settings

Download

F-Droid

F-Droid submission is currently in progress. Once approved, MarkReader will be available on F-Droid at com.markreader.

GitHub Releases

Download the latest APK from the Releases page.

Requirements

  • Android 7.0 (Nougat) or higher

Permissions

MarkReader requires no special permissions. Files are opened through Android's standard content URI system — no storage permission needed.

Building from Source

Prerequisites

  • Android Studio Meerkat (2024.3.1) or later
  • JDK 17
  • Android SDK with API level 35

Build Steps

  1. Clone the repository:
git clone https://github.com/usamaiqb/mark-reader.git
cd mark-reader
  1. Open in Android Studio or build from command line:
./gradlew assembleRelease
  1. The APK will be in app/build/outputs/apk/release/

Signed Builds

To build a signed release APK, create a keystore.properties file in the project root:

storeFile=path/to/your.keystore
storePassword=your_store_password
keyAlias=your_key_alias
keyPassword=your_key_password

Privacy

MarkReader:

  • ✅ Does NOT collect any personal data
  • ✅ Does NOT require internet access
  • ✅ Does NOT contain ads or tracking
  • ✅ Does NOT share data with third parties
  • ✅ All file processing happens locally on your device

For full details, see the Privacy Policy.

Contributing

Contributions are welcome! Please open an issue or pull request on GitHub.

License

This project is licensed under the GNU General Public License v3.0 - see the LICENSE file for details.

Support

Acknowledgments

Built with:

Changelog

See CHANGELOG.md for version history and changes.


Made with ❤️ for the open source community

About

Offline markdown and code reader with syntax highlighting

Resources

License

Stars

Watchers

Forks

Packages

 
 
 

Contributors