Skip to content

kelexine/azubimark

Repository files navigation

Project/File: README.md - Version 1.0.0

AzubiMark

GitHub repo size GitHub stars GitHub forks LICENSE GitHub last commit Platform Minimum SDK

AzubiMark is a modern, beautiful, and feature-rich Markdown viewer for Android, designed with Material You to provide an immersive and enjoyable reading experience. It is built to be fast, efficient, and easy to use, supporting a wide range of Markdown features to make your documents look their best.

🌟 Features

  • Stunning Material You Design: A modern and adaptive UI that embraces the latest Android design principles with dynamic theming.
  • Comprehensive Markdown Support:
    • Tables: Renders structured data with ease.
    • Task Lists: Keep track of your to-dos with interactive checkboxes.
    • Strikethrough: Emphasize changes and completed items.
    • Syntax Highlighting: Code blocks come alive with beautiful and accurate highlighting for numerous languages.
  • Built-in File Browser: Navigate your device's storage to find and open Markdown files without leaving the app.
  • Dynamic Theme Switcher: Seamlessly switch between Light, Dark, and Material You themes to match your preference.
  • Open Files from Anywhere: Launch .md and .markdown files directly from your file manager, email, or any other app.

📸 Screenshots

(Coming Soon!)

🚀 Getting Started

To get started with AzubiMark, you can either build the app from the source or wait for the official release.

Prerequisites

  • Android Studio: Make sure you have the latest version of Android Studio installed.
  • Android Version: Requires Android 8.0 (API 26) or higher.
  • Git: You'll need Git to clone the repository.

Building from Source

  1. Clone the repository:
    git clone https://github.com/kelexine/azubimark.git
  2. Open in Android Studio:
    • Launch Android Studio.
    • Select File > Open and navigate to the cloned repository directory.
  3. Sync Gradle:
    • Let Android Studio sync the project and download the required dependencies.
  4. Run the App:
    • Connect your Android device or start an emulator.
    • Click the Run button in Android Studio to build and install the app.

🛠️ Tech Stack & Dependencies

  • UI:
    • Jetpack Compose & ViewBinding: For building a modern and interactive UI.
    • Material 3 (Material You): To deliver a beautiful and dynamic user experience.
  • Markdown Processing:
    • Markwon: A powerful library for parsing and rendering Markdown.
    • Prism4j: For elegant and efficient syntax highlighting.
  • Core Components:
    • AppCompat & ConstraintLayout: For compatibility and flexible layouts.
    • AndroidX DocumentFile API: For seamless file access and management.
  • Kotlin: The project is written entirely in Kotlin, following modern best practices.

🤝 Contributing

Contributions are always welcome! Whether you want to fix a bug, add a new feature, or improve the documentation, your help is greatly appreciated. Please feel free to open an issue or submit a pull request.

📜 License

This project is licensed under the MIT License. See the LICENSE file for more details.

👨‍💻 Author

Franklin Kelechi (kelexine)

Thank you for your interest in AzubiMark! I hope you enjoy using it as much as I enjoyed building it.

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Packages

No packages published

Contributors 4

  •  
  •  
  •  
  •  

Languages