Skip to main content

A markdown generation library for Python.

Project description

Welcome to SnakeMD

SnakeMD is your ticket to generating Markdown in Python. To prove it to you, we've generated this entire README using SnakeMD. See readme.py for how it was done. To get started, download and install SnakeMD:

pip install snakemd

In the remainder of this document, we'll show you all of the things this library can do. For more information, check out the official documentation here.

Table of Contents

Below you'll find the table of contents, but these can also be generated programatically for every Markdown document as follows:

def _table_of_contents(doc: Document):
    doc.add_table_of_contents(range(2, 4))
  1. Table of Contents
  2. Paragraphs
  3. Links
  4. Images
  5. Lists
    1. Ordered List
    2. Unordered List
    3. Checklist
    4. Nested Lists
  6. Tables
  7. Code Blocks
  8. Quotes
  9. Horizontal Rule
  10. Raw

Paragraphs

Paragraphs are the most basic feature of any Markdown file. As a result, they are very easy to create using SnakeMD.

SnakeMD Source

def _paragraph(doc: Document):
    doc.add_paragraph("I think. Therefore, I am.")

Markdown Source

I think. Therefore, I am.

Rendered Result

I think. Therefore, I am.

Links

Links are targets to files or web pages and can be embedded in paragraphs in a variety of ways, such as with the insert_link() method.

SnakeMD Source

def _insert_link(doc: Document):
    doc.add_paragraph(
        "Learn to program with The Renegade Coder (@RenegadeCoder94)."
    ).insert_link("The Renegade Coder", "https://therenegadecoder.com").insert_link(
        "@RenegadeCoder94", "https://twitter.com/RenegadeCoder94"
    )

Markdown Source

Learn to program with [The Renegade Coder](https://therenegadecoder.com) ([@RenegadeCoder94](https://twitter.com/RenegadeCoder94)).

Rendered Result

Learn to program with The Renegade Coder (@RenegadeCoder94).

Images

Images can be added by embedding Inline elements in a paragraph.

SnakeMD Source

def _image(doc: Document):
    logo = "https://therenegadecoder.com/wp-content/uploads/2020/05/header-logo-without-tag-300x75.png"
    doc.add_block(Paragraph([Inline("Logo", image=logo)]))

Markdown Source

![Logo](https://therenegadecoder.com/wp-content/uploads/2020/05/header-logo-without-tag-300x75.png)

Rendered Result

Logo

Lists

SnakeMD can make a variety of Markdown lists. The three main types of lists are ordered, unordered, and checked.

Ordered List

Ordered lists are lists in which the order of the items matters. As a result, we number them.

SnakeMD Source

def _ordered_list(doc: Document):
    doc.add_ordered_list(["Deku", "Bakugo", "Uraraka", "Tsuyu"])

Markdown Source

1. Deku
2. Bakugo
3. Uraraka
4. Tsuyu

Rendered Result

  1. Deku
  2. Bakugo
  3. Uraraka
  4. Tsuyu

Unordered List

Unordered lists are lists in which the order of the items does not matter. As a result, we bullet them.

SnakeMD Source

def _unordered_list(doc: Document):
    doc.add_unordered_list(["Crosby", "Malkin", "Lemieux"])

Markdown Source

- Crosby
- Malkin
- Lemieux

Rendered Result

  • Crosby
  • Malkin
  • Lemieux

Checklist

Checklists are lists in which the items themselves can be checked on and off. This feature is new as of v0.10.0.

SnakeMD Source

def _checklist(doc: Document):
    doc.add_checklist(["Pass the puck", "Shoot the puck", "Score a goal"])

Markdown Source

- [ ] Pass the puck
- [ ] Shoot the puck
- [ ] Score a goal

Rendered Result

  • Pass the puck
  • Shoot the puck
  • Score a goal

Nested Lists

Nested lists are complex lists that contain lists. Currently, SnakeMD does not support any convenience methods to generate nested lists, but they can be created manually using the MDList object.

SnakeMD Source

def _nested_list(doc: Document):
    doc.add_block(
        MDList(
            [
                "Apples",
                Inline("Onions", bold=True),
                MDList(["Sweet", "Red"]),
                Paragraph(["This is the end of the list!"]),
            ]
        )
    )

Markdown Source

- Apples
- **Onions**
  - Sweet
  - Red
- This is the end of the list!

Rendered Result

  • Apples
  • Onions
    • Sweet
    • Red
  • This is the end of the list!

Tables

Tables are sets of rows and columns which can display text in a grid. To style any of the contents of a table, consider using Paragraph or Inline.

SnakeMD Source

def _table(doc: Document):
    doc.add_table(
        ["Height (cm)", "Weight (kg)", "Age (y)"],
        [["150", "70", "21"], ["164", "75", "19"], ["181", "87", "40"]],
        [Table.Align.LEFT, Table.Align.CENTER, Table.Align.RIGHT],
        0,
    )

Markdown Source

| Height (cm) | Weight (kg) | Age (y) |
| :---------- | :---------: | ------: |
| 150         | 70          | 21      |
| 164         | 75          | 19      |
| 181         | 87          | 40      |

Rendered Result

Height (cm) Weight (kg) Age (y)
150 70 21
164 75 19
181 87 40

Code Blocks

Code blocks are a form of structured text for sharing code snippets with syntax highlighting.

SnakeMD Source

def _code(doc: Document):
    doc.add_code("x = 5", lang="py")

Markdown Source

```py
x = 5
```

Rendered Result

x = 5

Quotes

Quotes are blocks of text that represent quotes from people.

SnakeMD Source

def _quote(doc: Document):
    doc.add_quote("How Now Brown Cow")

Markdown Source

> How Now Brown Cow

Rendered Result

How Now Brown Cow

Horizontal Rule

Horizontal Rules are visible dividers in a document.

SnakeMD Source

def _horizontal_rule(doc: Document):
    doc.add_horizontal_rule()

Markdown Source

***

Rendered Result


Raw

If at any time SnakeMD doesn't meet your needs, you can always add your own text using a raw block. These can be used to insert any preformatted text you like, such as HTML tags, Jekyll frontmatter, and more.

SnakeMD Source

def _raw(doc: Document):
    doc.add_raw("4<sup>2</sup> = 16<br />How cool is that?")

Markdown Source

4<sup>2</sup> = 16<br />How cool is that?

Rendered Result

42 = 16
How cool is that?

Project details


Download files

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

Source Distribution

snakemd-2.2.1.tar.gz (22.5 kB view details)

Uploaded Source

Built Distribution

snakemd-2.2.1-py3-none-any.whl (22.1 kB view details)

Uploaded Python 3

File details

Details for the file snakemd-2.2.1.tar.gz.

File metadata

  • Download URL: snakemd-2.2.1.tar.gz
  • Upload date:
  • Size: 22.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.4.0 CPython/3.9.20 Linux/6.5.0-1025-azure

File hashes

Hashes for snakemd-2.2.1.tar.gz
Algorithm Hash digest
SHA256 7f6b1df0aa69911da69e10354fc1020c0846c3668d8ebe27255d53c05c9f8cb9
MD5 54baf062f3782668c02a40a11d5a4c84
BLAKE2b-256 9d8d5cd70cc3a418755458accf83a1e73c5bb779ef30dd8d636273eeb9447d31

See more details on using hashes here.

File details

Details for the file snakemd-2.2.1-py3-none-any.whl.

File metadata

  • Download URL: snakemd-2.2.1-py3-none-any.whl
  • Upload date:
  • Size: 22.1 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: poetry/1.4.0 CPython/3.9.20 Linux/6.5.0-1025-azure

File hashes

Hashes for snakemd-2.2.1-py3-none-any.whl
Algorithm Hash digest
SHA256 4025333af18aaaf4816b54eea35d1a1334e97f39040e1fcd756fceccb1cac74e
MD5 53b3bd5ce3fbdad53a797a0e5ec72f9e
BLAKE2b-256 da84bdbc84cca4893eed273c5d06d57cfd88f583a2a5990e4fce2401020f653e

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page