Markup

Markup systems

Most of these were invented in the old days for the difficulty of writing good-looking documents. Back then a text editor was something thatedited files that, basically, represented typewriter output. A fixed alphabet, no italics, and so forth. Of course thie was inadequate for a lot of documents,

markdown
- Does not have a mechanism for including another file into a document.
  - answers on stackoverflow discussing despair and ways of evading the problems. Most seem to say use a different markup system.
- https://www.oberlo.ca/blog/markdown-editors
multimarkdown
- An extension on markdown.
- Does have a mechanism for including another file and, apparently, a lot more.
- Cheat sheet
asciidoc
- Implemented by aciidoctor for Linux, Windosws, and MacOS
- Does have a mechanism for including another file into a document.
- asciidov on wikipedia
- markdown vs asciidoctor Also lists a numner of other markup systems.
- documentatino
- I've Been Using The AsciiDoc Intellij Plugin For a Month. Here's My Review.
retext (what is this?)
Scribble -- part of the Racket programming language.
- No, you don't have to program to use it.
- I found it too slow to use for a loarge document on my old netbook, but
  - Its internal algorithms have been improved substantially since then
  - It is quite fast enough on a modern computer.
- It is available for both Windows and Linux.
- It is oriented toward making manuals.
- It can include other files into a document, but only to make them into another chapter or subsectin.
  - I have received code alleged to remove this restriction, but have not tried it out yet.
Pollen -- a Scribble variant. Also based on the Racket programming language.
- More flexible. Requires more specific work by the author(s) to make a beautiful document.
mt3 -- one I wrote for my novel, before others were widely available.
- has only the features absolutely needed for my novel.
- It does not have a Windows version, and to make one I'd have to get a Windows computer.
TeX.
- One of the oldest ones around. Tex was devised by Donald Knuth to typeset his series of books on the art of computer programming. Its specialty is presenting mathematical formulas elegantly. In widespread use by mathematicians for historical reasons. A lot of other markup systesm use TeX to generate pdf's.

HTML
TikZ -- A way of doing diagrams in TeX.