https://github.com/mortoray/mdl

My markdown language for documents: blogs, ebooks, and print
https://github.com/mortoray/mdl

Last synced: about 1 month ago
JSON representation

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

• Host: GitHub
• URL: https://github.com/mortoray/mdl
• Owner: mortoray
• Created: 2019-03-03T15:06:11.000Z (almost 6 years ago)
• Default Branch: master
• Last Pushed: 2023-10-22T08:45:38.000Z (about 1 year ago)
• Last Synced: 2023-10-22T10:32:35.944Z (about 1 year ago)
• Language: Python
• Size: 188 KB
• Stars: 16
• Watchers: 3
• Forks: 0
• Open Issues: 2
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# 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](https://mortoray.com/) or follow me on [Mastadon](https://peoplemaking.games/@mortoray)

I actively use this generator/parser for:

- **[Edaqa's Kitchen](https://edaqaskitchen.com):** Healthy modern recipes. I use it for the text part of recipes.

- **[Edaqa's Room](https://edaqasroom.com):** Online escape rooms. I use MCL for the primary game script as well as the document language for [the grimoire](https://edaqasroom.com/grimoire/directory).

- **[Musing Mortoray](https://mortoray.com):** 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

```