• Write in markdown.
  • Edit the documents locally (macOS) using an editor such as Atom, Sublime, IntelliJ.
  • Team members can comment on lines.
  • Good search and folder organisation.

I currently use Quip, but I prefer writing documents in Markdown using a local (macOS) text editor - such as Atom, Sublime, IntelliJ.

  • 1
    "local" means on what OS? How much are you willing to spend if it comes to paid solutions? How do you expect collaboration (multiple users edit the same file at the same time) to work with a local solution? How shall a Markdown document deal with comments, which are not in the format's specification?
    – Izzy
    Jun 29, 2017 at 10:31
  • @lzzy re: conflicts: Good question. Maybe when I save, it tries to get a lock on the file, if it fails - it asks me if I want to see conflicts (simple git conflict view).
    – vaughan
    Jul 4, 2017 at 19:19
  • re: comments: Tricky. Maybe insert an <div> with an id that links to the comment. Comments only viewable in the web interface.
    – vaughan
    Jul 4, 2017 at 19:20
  • Ah. I vaguely remember there was something with using HTML-comments for "special stuff" (i.e. wrapping it inside <!-- {stuff-here} -->), so it would not be processed with the "normal output". Yeah, that should be possible then. But merging might get nasty for the "technically challenged" when it comes to conflicts.
    – Izzy
    Jul 4, 2017 at 19:24
  • 1
    @andselisk Yeh that could work. Perhaps a good markdown commenting solution is all that is needed. Or perhaps using a github issues page to discuss the contents. Like a code review, but linked to an html element in the markdown file, rather than a commit/line.
    – vaughan
    Jul 5, 2017 at 15:10

1 Answer 1


Did you try Madoko?

You can connect to your local documents offline via the npm package madoko.

Also, there's a video introduction from Microsoft Research, do a search for it.

Your Answer

By clicking “Post Your Answer”, you agree to our terms of service and acknowledge you have read our privacy policy.

Not the answer you're looking for? Browse other questions tagged or ask your own question.