Mak is
a universal notepad

Instant & Intuitive
Organize Ideas
Customizable
Gist Sync
FAQ

Open mak.ink

Instant & Intuitive

Mak is designed to be instant and intuitive.

Clean

Mak is nothing but a piece of paper.

All you need is to type.

Markdown

Of course!

Say hello to the Super GFM Power.

Auto-saving

Click, start typing, close the tab.

Everything remains the same.

Blazing Fast

Start typing in 1 sec with 1 click, anytime and anywhere1.

No download or setup needed.

Works Offline

You can still use Mak even there’s no Internet connection2.

Why not just take a break?

Intuitive

Shortcuts, drag-and-drop, print PDF...

You know what to do. Just try it.

1~1 second loading time with Service Worker and caching strategy enabled, which are available in all modern browsers.
2Using Service Worker. Mak has to be opened at least once in the browser. Also some features like Gist Syncing require Internet access.

Organize Ideas

People are walking checklists.
Mak provides the most flexible way for managing both your small ideas and big plans.

To-do List

To-do List

To-do list in Markdown syntax:

- [X] Pick up rental car
- [ ] Finish essay
- [ ] Dinner w/ Jon

...and they’re clickable!


We have multiple work-in-progress drafts.
Unlike a normal file system, Mak organizes files flatly. No folders. It’s just a list of files.

Files

Files

A file is a URL with a hashtag (#).
You can easily access & edit files via URLs: https://mak.ink#hello

URL=“Uniform Resource Locator”


Links

Markdown links [title](url) are clickable.

With links, you can navigate between files easily.

There’re several preset files in Mak, which are read-only:
#list, #preferences, #profile and #sample. You can access via links or go: command.

Link materials together

Writing an essay, a novel or a diary?
Try spliting your ideas into files!

If you don’t want to move your hands away from the keyboard, hit Ctrl+Enter when focusing on a link,
or just use the go: command to navigate between files:

Forget about sticky notes

Close the temporary Notepads in your taskbar.
And uninstall your to-do list Apps.

Customizable

You can configure Mak via multiple ways.
The easiest choice is to open the #preferences file:

Preferences

Night Mode

Switch between light/dark themes.


Preview

Side by side or a separated window.


Font Size

Line Number

Print & Export

Mak recognizes [](set:option) as links too, just click on them to apply.
And similar to the go: command, you can also use the set: command to apply settings:

Both settings and content you’re editing will be synced automatically between tabs and stored in your browser.

https://mak.ink?dark&split&gist=30c93213bf556dc671f9df983a932b2a

Mix

Combine file (#filename)
and options (?option) in URL.

Note that options in URL are scoped to that file.
Use set to change global settings.

Gist Sync

Gist1 is a code snippet service provided by GitHub. It’s the easist way to share code snippets or documents with others.
“With gists, you can share single files, parts of files, and full applications with other people.”

You can use Gist to sync your files over the Internet2 completely inside Mak.

Sync

Push / pull, 100% inside Mak.

Everything under your control.

Versioning

Gist saves the every single change you’ve made.

https://gist.github.com/your-gist-id/revisions

Share

Share or view your document via Mak:


You can either handle Gists via the status bar:

Or use set: commands in Mak to manipulate Gists:
set:login, set:logout, set:pull, set:push


Once your Gist has been loaded (?gist=id), Mak saves it as a file (#id).

If you “push” a non-gist file, Mak will suggest to create a Gist.
By default, all Gists created in Mak are private and you can always change it to public later.

If you try to push to a Gist that you don’t have the permission, Mak will suggest to fork that Gist.

Note that everyone can READ a Gist (via gist.github.com) if he/she has the Gist ID (so you can view any Gist even you’re not logged in).

1The https://gist.github.com website might be not accessible in some countries / regions. But in Mak Gist fetching and publishing features are still usable via its API.
2You need to login to GitHub to enable all these features.

FAQ

Privacy and Security

Mak itself only stores your data inside the browser cache locally (localStorage).
Mak does NOT collect any log from your device or GitHub account.

If you’re using Gist Sync, Mak will create private Gists by default, and will never sync in the background without your permission.

Gist is a product from GitHub. Gist downloading / uploading only happens between your browser and GitHub’s API server.

Caching

Normally the browser will not clean up your local cache. But if you accidentally did that, all your documents will be lost.
Please manually backup (set:export) or sync (Gist) your documents as frequently as possible.

Is This Project Free?

Yes. This project was a HCI experiment at the beginning, and there’re no further plans by now.
It’s also a free software and will be open sourced under the MIT license soon.

Donation

Thanks a lot! How about giving me a star / comment or a tweet?

Why Gist?

Gist is a perfect product. And it’s one of the best tools I’ve ever used.

Gist encourages people to create and share notes and code snippets.
It’s easy to read, write, embed in your website, or discuss with people.

It has versioning too, it’s an important feature for text editors. And Gist is completely free.

Most Importantly, it’s super light-weighted and has the very same design philosophy like Mak.
In some word, Mak is just an interface based on Gist.

Any Alternatives?

There’re many awesome products. Notion, Typora, Left, Write.as, Caret and Tempad are both good tools I love.
Give them a try and find the one fits you well!

A Mobile App?

Sorry but actually I don’t have much time to build the mobile version.
For iOS users I would recommend you the default Notes App by Apple (or Bear for Markdown).

Who Are You?

I’m a Web developer and designer. You can follow me on GitHub and Twitter.
If you have any suggestions for Mak, feel free to open an issue.


Enjoy your writing

And create something wonderful :)

Text powers the editor.

Mak is an Inns project.Copyright © 2022, inns.studio. All rights reserved.