Skip to content
/ mdl Public

My markdown language for documents: blogs, ebooks, and print

Notifications You must be signed in to change notification settings

mortoray/mdl

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

MDL - Mortoray's Document Language

My multi-purpose markdown language. MDL combines a document language, similar to markdown, with a structured header language, similar to YAML.

I use this tool on a day-to-day basis for my own work. It is fairly stable, though I can't guarantee I won't add anything that changes the formatting, or accepts a new syntax. As I use it on more sites, it becomes ever more stable.

Follow the development at mortoray.com or follow me on Mastadon

I actively use this generator/parser for:

  • Edaqa's Kitchen: Healthy modern recipes. I use it for the text part of recipes.
  • Edaqa's Room: Online escape rooms. I use MCL for the primary game script as well as the document language for the grimoire.
  • Musing Mortoray: Technical Blog. I'm using the document language to write articles and publish in multiple formats.

Running

There is an entry point defined on the module that that reads MDL files and emits either HTML or Markdown.

python -m mdl --help

Example:

python -m mdl README.mdl --write markdown README.md

Be aware that not all emitters will support all of the doc-tree at any given time. It's all in flux now.

Python 3.10

NOTE: Uncertain if this is still needed/up-to-date

sudo apt install python3.10-distutils python3.10-dev

About

My markdown language for documents: blogs, ebooks, and print

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published