Skip to main content

Pelican plugin for embedding external content using Cards

Project description


Embedly-cards is a Pelican plugin providing restucturedText directives to allow easy embedding of external content using Cards.

ReST and markdown live examples can also be viewed from a Pelican-built website.


Embed content within a page or blog post easily, simply by specifying the URL of the target page. Content is automatically recognised, extracted, and formatted as a ‘card’; this may contain a short article preview, embedded video, picture etc.

To preview a card, they can be generated online using Almost any site is compatible, including YouTube, Flickr, Google+, Maps, Wordpress etc.


Embedly-cards can be installed using pip

$ pip install embedly-cards

or manually from the source code

$ python install

Once installed, simply add it to your configuration file:

    # ...

If you are planning on embedding content in markdown .md files, you must also add it to the MD_EXTENSIONS options, like so:

from embedly_cards import EmbedlyCardExtension
MD_EXTENSIONS = ['codehilite(css_class=highlight)',
                 # ...


If creating the MD_EXTENSIONS variable for the first time, ensure that the Pelican 'codehilite(css_class=highlight)' and 'extra' markdown extensions are included in the list.


For example, to embed a YouTube video in ReStructuredText:

.. embedly-card::

or in markdown:


Or to embed an article/webpage in ReStructuredText:

.. embedly-card::

or in markdown:



The card-chrome (ReST) or chrome (markdown) option, if provided, specifies whether or not to preserve the border around the card. By default, the border will be removed automatically if supports it; however to force the border to remain, you may pass :card-chrome: 1 (ReST),

.. embedly-card::
    :card-chrome: 1

or chrome=1 (markdown):


Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for embedly_cards, version 0.2.0
Filename, size File type Python version Upload date Hashes
Filename, size embedly_cards-0.2.0-py2-none-any.whl (7.0 kB) File type Wheel Python version 2.7 Upload date Hashes View
Filename, size embedly_cards-0.2.0.tar.gz (16.6 kB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page