I’m searching for a tool useful for collaboration.

Features:

  • history like git
  • own content and history: git & markdown?
  • external annotation to files. to describe, for example, the wiki language of a file
  • content includes images and pdfs
  • bundles of content based on files
  • start local server/desktop/app for advanced editing
  • edit via freemind
  • fallback to edit
  • copy-paste from/to different sources
  • view/edit source markdown
    • https://stackedit.io/editor
  • browse local files in markdown
  • allow includes
  • micro-languages
    • code syntax highlight
    • tables - see http://www.tablesgenerator.com/markdown_tables , http://stackoverflow.com/questions/19950648/how-to-write-lists-inside-a-markdown-table
    • graphs -
    • mindmaps
    • math
  • sections/include sections - for example define sections that will be included in a table cell. See the table below.
  • fallback to html
  • export/automatic export in
    • pdf
    • epub
    • standard markdown (besides the original file in any wiki)
  • Sync with other systems. Sync means automatic import/export in other formats
    • bookmarks (chrome, edge, firefox) & pinboard.io & deli.cio.us
    • freemind

Candidates

  • google docs
  • dropbox
  • wiki in git
    • bitbucket - https://www.quora.com/What-are-the-differences-between-BitBucket-and-GitHub
    • github
    • gitlab
    • gitbucket - self hosted scala solution - https://github.com/gitbucket/gitbucket
  • other tools - http://mashable.com/2013/06/24/markdown-tools
  • slack https://slack.com/
Pro Cons
Wiki - bitbucket - fast navigation between pages
- page oriented		 - cannot upload images
- cannot use other type of docs
- free version - limited number of users: 5
- max 1M image size
- image not stored in wiki
- hard to edit tables
Google - slow navigation between pages
 - slow transition between pages
- history per file
- cannot export history outside google
- document oriented
slack - informal
- ergonomic way to add code		 - category: chat
- cannot build-up information since there are several parallel multiple topics
- search is broken since you must select first the channel. keep only one channel
gitter - ergonomic - category: chat

Markdown tools

Online Editors

  • html source to markdown - https://www.browserling.com/tools/html-to-markdown
  • rich doc copy paste to markdown - http://raisercostin.org/markitdown.medusis.com/www/ (down - http://markitdown.medusis.com/)
  • table editor - http://www.tablesgenerator.com/markdown_tables
  • 2 pane editor - https://stackedit.io/editor
  • https://ozh.github.io/ascii-tables/
  • https://html-online.com/editor/
  • http://johnmacfarlane.net/babelmark2/
  • markdownify html source - http://heckyesmarkdown.com/
  • css to display a html page as markdown - http://mrcoles.com/demo/markdown-css/

References

  • Other nice extensive analysis - http://moduscreate.com/editing-markdown-for-github/
  • A huge list of markdown tools - http://mashable.com/2013/06/24/markdown-tools . Recommends HarooPad