mex
akhil.cc/mexdown
go get akhil.cc/mexdown
mex

akhil.cc/mexdown

A lightweight integrating markup language

by Akhil Indurti

v0.0.0-20200224200706-35d07eac3818 (see all)License:MIT
go get akhil.cc/mexdown
Readme

mexdown

Documentation Build Status Blog post

mexdown is a lightweight integrating markup language. It offers a syntax similar to markdown's, but its distinguishing feature is in integrating commands to generate a document.

These commands are processed through directives. Simply append a command to a block of raw text, like so:

```dot -Tsvg
digraph g{
  rankdir=LR;
  "A" -> "B" -> "C"
  "B" -> "D"
}
```

dot is a command installed with Graphviz that reads a graph's description into standard input, and writes its SVG representation to standard output. This SVG can be embedded into an HTML document, so the following mexdown source file

# Title About Graphs

The following graph illustrates my point:
```dot -Tsvg
digraph g{
  rankdir=LR;
  "A" -> "B" -> "C"
  "B" -> "D"
}
```

when run through mexdown's html backend either via the command line,

$ mexdown html graphs.xd

or programmatically with Go,

file := parser.MustParse(src)
out, err := html.Gen(file).Output()

produces the following HTML document

A graph embedded in an HTML document

Directives enable a powerful way to control document generation, without building in new language features into markdown itself. As long as the command reads from STDIN and writes to STDOUT, you can

  • Embed mathematical equations.
  • Write literate programs.
  • Generate hyperlinked source-code documentation.
  • Create a table of contents.
  • Embed interactive widgets based off descriptions.
  • Use it in other creative ways!

The language itself is backend-independent, and the grammar was written with this in mind. For example, the grammar doesn't dictate the formatting of list items, the escaping of raw text, or the command language used for the directives.

Supported Backends

Currently, the only implemented backend is HTML. However, the next candidates are

  • PDF
  • Postscript
  • Latex
  • Google Docs/Slides
  • Pandoc

Anyone can implement their own backend, since it only needs the AST, as defined in akhil.cc/mexdown/ast.

Contributing

Please file issues on Github's issue tracker. There is still a lot of work that needs to be done before creating a release. Thank you for taking the time to contribute!

GitHub Stars

12

LAST COMMIT

2yrs ago

MAINTAINERS

0

CONTRIBUTORS

2

OPEN ISSUES

1

OPEN PRs

0
VersionTagPublished
v0.0.0-20200224200706-35d07eac3818
2yrs ago
v0.0.0-20190110005201-97f7e68f14fc
3yrs ago
No alternatives found
No tutorials found
Add a tutorial