Execute codeblocks inside of markdown
Project description
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.
License
darkmark
is distributed under the terms of the MIT license.
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | a1d970f6b95634be81a0532bf15c750a8d076706778db147397ca47603787b75 |
|
MD5 | 8387e24308b7fe1c9687baf3d64a814f |
|
BLAKE2b-256 | 12390d0d9123bf75f680384f760f1ac62807ab105642fff8c00117b4d20192ba |
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
Algorithm | Hash digest | |
---|---|---|
SHA256 | be2f61479b3ac16cbfcf93007c49c413fbe601c2997d1f24099df48e8d9fb1cc |
|
MD5 | 62d46b82568fa0dee95d2c52699578a1 |
|
BLAKE2b-256 | d65024df2a3bd9033f850287db92424566040fccfbd5c778cd5eec3e55fb9606 |