I have a simple need - to have markdown work flawlessly on both MacOS and IOS. There are many flavours of markdown and I like to use Multimarkdown (MMD) as it is the most comprehensive. My use cases are:
- To be able to have inline images with the text1
- In preview, to be able to navigate to other markdown notes by clicking local2 or wiki links
- To support the same style of metadata (and hide it in preview) - either YAML style (separated by dashes) or MMD style (top of document with a blank line)
There are lots of markdown editors, but many either have their own flavour or support CommonMark (e.g. Typora) and don't have the full coverage of Multimarkdown but even this doesn't support Wiki links. Wiki Links are often a feature of individual editors.
|Editor||Local links||Wiki links||styles on image links||MMD meta||YAML meta||IOS||MacOS||Flavour|
|Marked 2||Yes||Yes 4||Yes||Yes||Yes||No||Yes||MMD|
TextMate - uses Marked 2 for preview
My current set up is to use either DevonThink or Marked 2 on MacOS with MMD style metadata and 1Writer on IOS. My markdown documents are in the iCloud 1Writer folder and indexed into DevonThink.
Update June 2022: IA Writer now supports wikilnks but local links remain a problem.
I find html embedded in markdown ugly and it makes the document difficult to read. Multimarkdown has a good solution using reference links with styles -
[image ref]: \path_to\image.jpg style="float:left; width=50%;"↩
Local is where the link reference is
[document name](\path_to\document_name.md)not a http reference ↩
Shows as greyed block in preview ↩
Documents have to be in a Devonthink database replicated to Devonthink to go ↩