Skip to content
Convert Markdown to HTML5 from within Dyalog APL
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Permalink
Type Name Latest commit message Commit time
Failed to load latest commit information.
APLSource
Files Links & images with special attributes improved plus bug fixes Oct 17, 2018
Make
Tests URL's fixed. CSS problem fixed. Mar 7, 2018
images
.gitattributes
.gitignore
BlackOnWhite_print.css
BlackOnWhite_screen.css
LICENSE
LeanPubExtensions.html Bug fix for LeanPub extension & Include APLTreeUtils fixed Feb 20, 2019
LeanPubExtensions.md
MarkAPL.dws Bug fix: link text for aut-bookmark links always started with a # char May 7, 2019
MarkAPL.html
MarkAPL.md
MarkAPL_CheatSheet.html
MarkAPL_CheatSheet.md Bug fix: link text for aut-bookmark links always started with a # char May 7, 2019
MarkAPL_for_Programmers.html
MarkAPL_for_Programmers.md
MarkAPL_print.css Links & images with special attributes improved plus bug fixes Oct 17, 2018
MarkAPL_screen.css
QuickIntro.html
QuickIntro.md Docs\ removed and problem in Leanpub extensions fixed Feb 18, 2019
README.html Bug fix for LeanPub extension & Include APLTreeUtils fixed Feb 20, 2019
README.md Docs\ removed and problem in Leanpub extensions fixed Feb 18, 2019
Styles.html
Styles.md
acre.config
publish.config Bug fix: link text for aut-bookmark links always started with a # char May 7, 2019

README.md

MarkAPL

Overview

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:

Name Standard Extra Pandoc MarkAPL
Abbreviations X X
Automated links X X X X
Blockquotes X X X X
Calling APL functions X
Code blocks (indented) X X X
Code blocks (fenced) X X X
Definition lists X X X X
Footnotes X X X X
Headers X X X X
HTML blocks X X X X
HR X X X X
Images X X X X
Inline markup X X X X
Line breaks (two spaces) X X X
Line breaks () X X
Line breaks (<<br>>) X
Links X X X X
Link references X X X X
Lists X X X X
"loose" / "tight" lists X X X
Markdown inside HTML X X
Paragraphs X X X X
Tables X X X X
Table footers X
Table of contents (TOC) X X
Sub TOC X
Smart typography X X
Special attributes X X X
LeanPub extensions X

Note that marking up code blocks by indenting was deliberately not implemented in MarkAPL.

Documentation

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.

You can’t perform that action at this time.