When comparing Markdown vs Hypothesis, the Slant community recommends Hypothesis for most people. In the question“What are the best web annotation tools?” Hypothesis is ranked 1st while Markdown is ranked 3rd. The most important reason people chose Hypothesis is:
Hypothesis is completely free and open source, its source code is hosted in GitHub.
Ranked in these QuestionsQuestion Ranking
Pros
Pro Human-readable
Designed to be easy for a human to enter with a simple text editor, and easy to read in its raw form.
Pro Widely used
Markdown is quickly becoming the writing standard for academics, scientists, writers, and many more. Websites like GitHub and reddit use Markdown to style their comments.
Pro De facto standard
Markdown is ubiquitous. It's supported by nearly everything. The markup available in the common subset of all the many dialects isn't that rich, but it's usually enough to get the job done.
Pro Multi-directional
You can convert HTML to Markdown or Markdown to HTML. You can use tools like pandoc to convert to other formats as well.
Pro Revision friendly
It is easy to track changes for markdown documents as compared to other formats like doc, html, etc. You only need to place your markdown documents under some version control system.
Pro Open Source
Hypothesis is completely free and open source, its source code is hosted in GitHub.
Pro Everything can be searched through
Searchable stream of annotations, replies, and email notifications.
Pro Private or public
You can work in private groups and then publish, keep annotations private, or make it public from scratch.
Pro Tags
You can sort by tags, which makes it far more powerful.
Pro Lets you see public & private annotations on that webpage
Helpful to see what people thought or see useful references they might have left. Useful for group collaborations as well (research groups, book clubs, class study groups, etc)
Pro Chrome browser extension works on Brave browser
Most (maybe all) Chromium-based browsers let you use Chrome browser extensions.
Pro Chrome browser extension
Has browser extension for Chrome, which makes the job of annotating web pages even easier.
Pro Unique URLs for each annotation
You can link directly to an annotation.
Cons
Con Lacks a coherent standard
Lacks a coherent standard, just many semi-compatible dialects (MultiMarkdown, etc). This inconsistency can cause problems if the person writing the Markdown is using a different dialect from the one that will be used to render it.
Con Bad support for table
It has poor support for table, while table is an important part of article.
Con Bad support for larger documents
Works good for single file documents like READMEs.
Lack support for cross-references, TOCs, document index etc.
Con It doesn't support semantic markup
It's unstructured.
Con No browser extensions apart from Chrome
Allegedly, one can use bookmarklet instead, but in Firefox it works only for some of websites.
Con Seems under development
Too many rough edges and/or bugs as you use it. For example, you have to keep logging in every time you want to add a page using the chrome extension. There are ways to add annotations on the mobile too, but way too buggy. Hopefully they fix these problems soon. Very good idea; poorly implemented.
Con Annotations are for text only, not images
