source-code on S Anand

How to extend Markdown with custom blocks

Fri, 08 Jan 2021 09:37:48 +0000

One problem I’ve had in Markdown is rendering a content in columns.

On Bootstrap, the markup would look like this:

<div class="row">
  <div class="col">...</div>
  <div class="col">...</div>
</div>

How do we get that into Markdown without writing HTML?

On Python, the attribute lists extension lets you add a class. For example:

This is some content
{: .row}

… renders <p class="row">This is some content</p>.

But I can’t do that to multiple paragraphs. Nor can I next content, i.e. add a .col inside the .row.

Enter markdown-customblocks. It’s a Python module that extends Python Markdown. This lets me write:

::: row
::: col
Content in column 1
::: col
Content in column 2
::: row
::: col
Content in column 1
::: col
Content in column 2

This translates to:

<div class="row">
  <div class="col">Content in column 1</div>
  <div class="col">Content in column 2</div>
</div>

Better yet, we can create our own custom HTML block types. For example, this code:

from markdown import Markdown
from customblocks import CustomBlocksExtension

def audio(ctx, src, type="audio/mp3"):
    return f'''<audio src="{src}" type="{type}">
      {ctx.content}
    </audio>'''

md = Markdown(extensions=[
    CustomBlocksExtension(generators={
        'audio': audio
    }),
])

… lets you convert this piece of Markdown:

md.convert("""
::: audio src="mymusic.ogg" type="audio/ogg"
    Your browser does not support `audio`.
""")

… into this HTML:

<audio src="mymusic.ogg" type="audio/ogg">
  Your browser does not support <code>audio</code>.
</audio>

markdown-customblocks is easily the most useful Python module I discovered last quarter.

Google code search hacks

Wed, 04 Oct 2006 12:00:00 +0000

Jason Kottke finds interesting code search hacks, ranging from the WinZip key generation algorithm to programmers who want a new job.

Krugle

Wed, 12 Jul 2006 12:00:00 +0000

Krugle is a code search engine.

Comments

sheikh 14 Dec 2006 3:08 pm: Thank you anand, It was very useful

Microsoft not opening more source code

Thu, 10 Feb 2005 12:00:00 +0000

Why is Microsoft not opening more source code?

Apparently inappropriate code comments is one of the reasons according to this story. I wonder what kind of things developers put in comments that would be so bad for the rest of us to see?

Comments

sathish 10 Feb 2005 12:00 pm: checking if the contact name is coming properly..
Venkat 10 Feb 2005 12:00 pm: GMaP is cool! Better than mappy. Do we have something like this for India?

New commenting system 2

Tue, 01 Feb 2005 12:00:00 +0000

My new commenting system is based on the principle of “scribbling on the margin”. If you’re interested, have a look at the source code for this page. It is as clear as mud, so best of luck!

Comments

Ammadio 1 Feb 2005 12:00 pm: Where do these comments get stored
Navneet 1 Feb 2005 12:00 pm: Nice commenting system. A couple of points though…It took me a while to figure out how to post the comment :). Maybe a note on that somewhere would help.. Also the text colour when I’m typing in the comment is almost invisible.
S Anand 1 Feb 2005 12:00 pm: I fixed those two. Is it OK? Anything else?
TOPFRAME 1 Feb 2005 12:00 pm: Good to see you back, Anand. :)

Microsoft will reveal Windows source

Tue, 06 Aug 2002 12:00:00 +0000

At last, Microsoft will be revealing its Windows source. Parts of it.

I opted out of many popup ads

Mon, 14 Jan 2002 12:00:00 +0000

I opted out of many popup ads. Not that I particularly mind them… I just wanted to test out the code.

Windows CE source code

Sat, 11 Aug 2001 12:00:00 +0000

I’d missed this earlier. Microsoft has released its Windows CE source code to the public!

Cracking DVDs

Fri, 16 Mar 2001 12:00:00 +0000

Two MIT students have written a 7-line program that unscrambles protected DVDs. It’s downloadable. The legal issue is whether source code deserves protection on par with freedom of expression.