MarkAPL is a converter that converts Markdown into valid HTML5. It is written in Dyalog.
Markdown aims to make the process of writing for the web much easier by improving readability and, as a consequence, maintainability.
This is an example on the Wikipedia comparing Markdown with HTML.
With MarkAPL you can either use variables or files or any combination of the two to convert Markdown into HTML5.
Note that the original design of Markdown has proven to be an excellent idea but too limited for widespread use. Therefore extensions were implemented. Over time two approaches have proven to be particularly successful: Markdown Extra and PanDoc.
For several years it seemed that the segmentation of the different implementations would be a problem, but over time the implementations got closer. There is also the CommonMark initiative which aims to standardize Markdown. MarkAPL tries to be compliant with Commonmark within reason.
MarkAPL aims to implement most concepts and also adds a couple of enhancements that might be useful, be it in general or just for APLers.
Today Markdown is used by many of the big names on the web. Examples are Git, SourceForge, Stack Overflow and Trello. Many wikis allow Markdown at least optionally for input.
The following table highlights the features supported in MarkAPL:
|Calling APL functions||X|
|Code blocks (indented)||X||X||X|
|Code blocks (fenced)||X||X||X|
|Line breaks (two spaces)||X||X||X|
|Line breaks ()||X||X|
|Line breaks (
|"loose" / "tight" lists||X||X||X|
|Markdown inside HTML||X||X|
|Table of contents (TOC)||X||X|
Note that marking up code blocks by indenting was deliberately not implemented in MarkAPL.
A full documentation is available as an HTML page generated from Markdown with MarkAPL, as you would expect. This document is comprehensive and is therefore quite long: more than 30 pages.
There is also a cheat sheet available for the impatient APLer.
Markdown editor "Meddy"
Note that there is an editor available that uses MarkAPL as converter: Meddy.
The editor is quite basic (but comes with Undo/Redo and a powerful Search/Replace) but it supports all MarkAPL features.