Suggestion: Turn comments at top of selection into markdown for a card

[jflam]

Consider code that looks like:

# 1. define an add() method
# 1. invoke the add() method

def add(x, y):
    return x + y

add(3, 4)

This would generate the card with the text in the comments converted into Markdown and rendered for display (as a numbered list in this case).

[grosskc]

I like this idea, but I recommend that # is used for a normal comment, and #' is used to denote a selection of text to be rendered as markdown, a la:

#' # Beginning Python
#' 1. define an add() method
#' 2. invoke the add() method

# define add
def add(x, y):
    return x+y

# do the computation
add(3, 4)

The first three lines above would be rendered in markdown, but regular comments above would not.