Table Of Contents [Toggle]

Get it on F-Droid Get it on Google Play Get it on GitHub

Markor is a TextEditor for Android. This project aims to make an editor that is versatile, flexible, and lightweight. Markor utilizes simple markup formats like Markdown and todo.txt for note-taking and list management. Markor is versatile at working with text, it can also be used for keeping bookmarks, copying to clipboard, fast opening a link from text and lots of more. Created files are interoptable with any other plaintext software on any platform.Markor is using open formats and is free software, openly developed and accepts community contributions.

 
 
 
 
 
 
 
 
 

Features

📝 Create notes and manage your to-do list using simple markup formats
🌲 Work completely offline - whenever, wherever
👌 Compatible with any other plaintext software on any platform – edit with notepad or vim, filter with grep, convert to PDF or create a zip archive

🖍 Syntax Highlighting and format related actions – quick insert pictures and to-do
👀 Convert, preview, and share documents as HTML and PDF

📚 Notebook: Store all documents on a common filesystem folder
📓 QuickNote: Fast accessible for keeping notes
☑️ To-Do: Write down your to-do
🖍 Formats: Markdown, todo.txt, csv, ics, ini, json, toml, txt, vcf, yaml

📋 Copy to clipboard: Copy any text, including text shared into Markor
💡 Notebook is the root folder of documents and can be changed to any location on filesystem. QuickNote and ToDo are textfiles

🎨 Highly customizeable, dark theme available
💾 Auto-Save with options for undo/redo
👌 No ads or unnecessary permissions
🌎 Language selection – use other language than on the system

🔃 Markor is an offline app. It works with sync apps, but they have to do syncing respectively. Sync clients known to work in combination include BitTorrent Sync, Dropbox, FolderSync, OwnCloud, NextCloud, Seafile, Syncthing, Syncopoli

What Markor users say

This is an incredible app. Being able to designate a file as a quick entry (grocery list file in my case) and a todo file (my todo.txt file) plus a share receiver that lets you choose recent files, make a new file, or whatever you like to add the text is outstanding. I didn’t know it did any of this when I downloaded it, I just wanted a good markdown editor and it is great at that. The other stuff was a surprise and perfectly fits my workflow.
– Scott M.

Privacy

The app doesn’t use the internet connection unless external resources (e.g. display image by URL) are referenced in user generated content. The app is working completly offline, no internet connection required! No personal data will be requested or shared with the author or third parties (i.e. calendar or contacts). Files can be shared to other apps from inside the app by pressing the share button. Files are stored locally in a user selectable folder, defaulting to the device public documents folder.

Android Permissions

  • WRITE/READ_EXTERNAL_STORAGE
    Read and write files from/to device storage.
  • INTERNET
    In user generated content data can be loaded from the internet.
  • INSTALL_SHORTCUT
    Install shortcut to launchers to open a file/folder in Markor.
  • RECORD_AUDIO
    Markor allows to attach voice notes to the text. The permission is only used when clicking the “attach audio” button/menu to start the audio record dialog. Audio recording is always started and stopped by the user (button press).

Contribute to the project

  • How to get started
    See Android contribution guide
  • Development (Source code)
    The project is always open for contributions and welcomes merge requests. Take a look at our issue tracker for open issues, especially those tagged with good first issue and help wanted. The project uses AOSP Java Code Style. Additionally: Use _camelCase instead of mCamelCase for class members. Use Android Studios auto reformat feature before sending a MR.
  • Localization
    Translate on Crowdin (free).

Project posts

Frequently asked questions (FAQ / Help)

General

How do I save a file?

Markor automatically saves text when you leave Markor or close a file. Additionally there is save button in the top menu.

How do I save files to SD Cards?

Browse to the start folder of your SD Card and press the + button (using file browser or the menu option). Now press the plus button and follow the steps in the dialog. Afterwards Markor’s file browser won’t strike out filenames anymore and files are writable. Showcase

Special files and directories

What is Notebook?

The root folder of your files! Markor starts with this folder at the main screen and allows you to browse files. You can work at any (accessible) file & location with Markor.

What is ToDo?

Your main to-do list file in todo.txt format. You can access it by swiping once at the main screen, by selecting todo.txt at Notebook, or by using the dedicated launcher. You can also open it from Notebook or other apps! You will also have the option to create a to-do task when sharing text into Markor when the text is just one line. The location of this file is freely choosable and independent from the Notebook directory.

What is QuickNote?

The fastest and easiest way to take notes! QuickNote is a file in Markdown format with a freely choosable file location. You can access it by swiping twice at the main screen, by selecting QuickNote at Notebook, or by using the dedicated launcher. The location of this file is freely choosable and independent from the Notebook directory.

Format: Markdown

What is Markdown?

A general purpose markup format for documents of all kinds. As Markdown gets converted to HTML prior displaying a rendered view, you can also include HTML in the text, thus you can do everything web browsers can do.

CommonMark is the specification that the markdown parser used in Markor implements.

Resources 
CommonMark tutorialLearn Markdown in 10 minutes
CommonMark helpQuick reference and interactive tutorial for learning Markdown.
CommonMark SpecCommonMark Markdown Specification
daringfireballSyntax documentation the Markdown creator


Most Markdown applications use URL encoding for links, so does Markor. This means replace every space with %20. This ensures that your Markdown content is compatible with most other Markdown applications.

Markor has a dedicated button for adding links and file references, which automatically applies this appropiate format. Take a look at this video to find out where the file reference button is located and how to use it.

Example: [alt](my cool file.md)[alt](my%20cool%20file.md).

Can I use Markor in class to write down equations? (Math)

Yes, Markor has advanced functionalities for math! Enable the feature by checking Settings»Format»Markdown»Math.

Markor’s markdown-reference.md template (available from new file dialog) showcases some examples.
Learn more about available functions and symbols here: 1, 2

Format: todo.txt

What is todo.txt?

Todo.txt is a simple text format for todo. Each line of text is a task. The idea comes from Gina Trapani.

Resources 
HomepageTodo.txt’s home
FormatSyntax documentation
User DocumentationUser documentation

Done tasks are marked by a x in begining of the line and can optionally be moved to a done/archive file.

Showcase


What is a context / category?

With contexts you can mark a situation or place. Context is part of todo.txt format and has the alias category (@) at Markor.
Examples: @home @work

What is a project / tag?

With projects you can group tasks by a specific project. You can also use it simply for tagging your todo. Context is part of todo.txt format and has the alias tag (+) at Markor.
Examples: +video +download +holidayPlanning

How to remove a category/tag from a task?

Go to the word and remove the +/@ symbol in front.