marquedown 0.9.0

Extending Markdown further by adding a few more useful notations.

Marquedown

Extending Markdown further by adding a few more useful notations. It can be used in place of markdown as it also uses and applies it.

Examples

Blockquote with citation

This is currently limited to the top scope with no indentation. Surrounding dotted lines are optional.

Example

Marquedown

......................................................
> You have enemies? Good. That means you've stood up
> for something, sometime in your life.
-- Winston Churchill
''''''''''''''''''''''''''''''''''''''''''''''''''''''

HTML

<blockquote>
    <p>
        You have enemies? Good. That means you've stood up
        for something, sometime in your life.
    </p>
    <cite>Winston Churchill</cite>
</blockquote>

Embed video

YouTube

Marquedown

![dimweb](https://youtu.be/VmAEkV5AYSQ "An embedded YouTube video")

HTML

<iframe
    src="https://www.youtube.com/embed/VmAEkV5AYSQ"
    title="An embedded YouTube video" frameborder="0"
    allow="accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture"
    allowfullscreen>
</iframe>

BBCode HTML tags

These tags allow you to put Marquedown inside HTML tags. This is done by finding and replacing them with their represented HTML after all other Marquedown has been rendered.

Tags and classes

The naming scheme is the same as in CSS, e.g. tag.class1.class2 If tag is omitted, it is treated to be div

ID:s

ID:s are supported using #beans at the end of the tag, ex. [p#beans]

Example

Marquedown

[section]
[.bingo]
A regular **paragraph** written in Marquedown, but *within* other HTML tags.
[//]

[tag.class1.class2] [/tag]

HTML

<section>
<div class="bingo">
    <p>
        A regular <strong>paragraph</strong> written in Marquedown, but <em>within</em> other HTML tags.
    </p>
</div></section>

<tag class="class1 class2"> </tag>

Label list

Example

Marquedown

(| email: [[e-mail]](mailto:[e-mail])
(| matrix: [@jon:webby.net](https://matrix.to/#/@jon:webby.net)
(| runescape: jonathan_superstar1777

HTML

<ul class="labels">
    <li class="label label-email">
        <a href="mailto:[e-mail]">
            [e-mail]
        </a>
    </li>
    <li class="label label-matrix">
        <a href="https://matrix.to/#/@jon:webby.net">
            @jon:webby.net
        </a>
    </li>
    <li class="label label-runescape">
        jonathan_superstar1777
    </li>
</ul>

QR codes

QR codes can be generated and referenced automatically via the render command. If you want to generate QR codes with marquedown.marquedown, you can follow the example below.

Example

Marquedown

![qr:monero-wallet](monero:abcdefghijklmnopqrstuvwxyz)

Python

from marquedown import marquedown

with open('document.mqd', 'r') as f:
    document = f.read()

with open('public/document.html', 'w') as f:
    rendered = marquedown(document, qrgen='public/qr:qr')
    f.write(rendered)

The string provided to qrgen is two paths separated by a colon.

1. Where to save the generated images
2. What directory to reference in the HTML src parameter

The generated HTML

<img src="qr/qr-0-monero-wallet.png" alt="monero-wallet">

Commands

render: Render documents

You can render an entire directory and its subdirectories of Markdown or Marquedown documents. This can be used to automate rendering pages for your website.

Do python -m marquedown render --help for list of options.

Example

For a few of my websites hosted on GitLab, I have it set up to run this on push:

# Render document
python -m marquedown render -i "./mqd" -o "./public" -t "./templates/page.html"

# This is for the GitLab Pages publication
mkdir .public
cp -r public .public
mv .public public