---
foo: bar
Another-Key: another value
Key-with-long-value: >
  can be given with this form. Greater than sign, followed by
  a block of intended lines.
A-further-key: some other value.
---
# Rest of markdown document

foo: bar
Another-Key: another value
Key-with-long-value: >
  can be given with this form. Greater than sign, followed by
  a block of intended lines.
A-further-key: some other value.
# Rest of markdown document

>>> import markdown2
>>> text = """---
... foo: bar
... ---
... 
... *hi*
... """
>>> html = markdown2.markdown(text, extras=["metadata"])
>>> html
u'<p><em>hi</em></p>\n'
>>> html.metadata
{u'foo': u'bar'}