Skip to main content

Execute codeblocks inside of markdown

Project description

DarkMark

darkmark

Runs codeblocks marked with the darkmark, and inserts the results.

DarkMark uses tree-sitter to identify codeblocks. Currently it only supports python codeblocks in markdown files and runs them with ipython. Handy for writing docs/blog posts so you can stay right in your markdown editor of choice and get the outputs in line. No need to jump into a whole other tool just to do live execution.


Installation

pip install darkmark
❯ darkmark --help

 Usage: darkmark [OPTIONS] COMMAND [ARGS]...

 run code blocks in markdown

╭─ Options ──────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ --install-completion        [bash|zsh|fish|powershell|pwsh]  Install completion for the specified shell.       │
│                                                              [default: None]                                   │
│ --show-completion           [bash|zsh|fish|powershell|pwsh]  Show completion for the specified shell, to copy  │
│                                                              it or customize the installation.                 │
│                                                              [default: None]                                   │
│ --help                                                       Show this message and exit.                       │
╰────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯
╭─ Commands ─────────────────────────────────────────────────────────────────────────────────────────────────────╮
│ run                                                                                                            │
│ sexp                                                                                                           │
│ tui                                                                                                            │
│ watch                                                                                                          │
╰────────────────────────────────────────────────────────────────────────────────────────────────────────────────╯

Usage

Mark your codeblocks with the darkmark.

```python {.python .darkmark}
r = requests.get('https://waylonwalker.com')
r.status_code
```

Then run darkmark <file>.md and darkmark will insert the results of the codeblock.

``` {.console .darkmark_output}
200
```

Automatic imports

Automatic imports are provided by pyflyby.

Supported Languages

Currently the only language supported is python.

  • python

Example

Running darkmark watch <file.md> updates the file on save.

darkmark.webm

License

darkmark is distributed under the terms of the MIT license.

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

darkmark-0.2.0.tar.gz (13.0 kB view details)

Uploaded Source

Built Distribution

darkmark-0.2.0-py3-none-any.whl (7.9 kB view details)

Uploaded Python 3

File details

Details for the file darkmark-0.2.0.tar.gz.

File metadata

  • Download URL: darkmark-0.2.0.tar.gz
  • Upload date:
  • Size: 13.0 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: python-httpx/0.24.1

File hashes

Hashes for darkmark-0.2.0.tar.gz
Algorithm Hash digest
SHA256 a1d970f6b95634be81a0532bf15c750a8d076706778db147397ca47603787b75
MD5 8387e24308b7fe1c9687baf3d64a814f
BLAKE2b-256 12390d0d9123bf75f680384f760f1ac62807ab105642fff8c00117b4d20192ba

See more details on using hashes here.

File details

Details for the file darkmark-0.2.0-py3-none-any.whl.

File metadata

  • Download URL: darkmark-0.2.0-py3-none-any.whl
  • Upload date:
  • Size: 7.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: python-httpx/0.24.1

File hashes

Hashes for darkmark-0.2.0-py3-none-any.whl
Algorithm Hash digest
SHA256 be2f61479b3ac16cbfcf93007c49c413fbe601c2997d1f24099df48e8d9fb1cc
MD5 62d46b82568fa0dee95d2c52699578a1
BLAKE2b-256 d65024df2a3bd9033f850287db92424566040fccfbd5c778cd5eec3e55fb9606

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