{"id":25483337,"url":"https://github.com/fennifith/MarkdownToJupyter","last_synced_at":"2025-11-07T04:30:35.844Z","repository":{"id":57304659,"uuid":"147549637","full_name":"fennifith/MarkdownToJupyter","owner":"fennifith","description":"NodeJS script to execute \u0026 convert code blocks in markdown files to a JupyterLab Notebook.","archived":false,"fork":false,"pushed_at":"2018-09-12T15:22:54.000Z","size":12,"stargazers_count":1,"open_issues_count":3,"forks_count":0,"subscribers_count":2,"default_branch":"master","last_synced_at":"2025-02-14T13:18:34.859Z","etag":null,"topics":["cli","jupyter","jupyter-notebook","nodejs"],"latest_commit_sha":null,"homepage":"https://www.npmjs.com/package/mtjc","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/fennifith.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2018-09-05T16:41:40.000Z","updated_at":"2018-09-07T11:16:43.000Z","dependencies_parsed_at":"2022-09-17T15:22:34.911Z","dependency_job_id":null,"html_url":"https://github.com/fennifith/MarkdownToJupyter","commit_stats":null,"previous_names":["theandroidmaster/markdowntojupyter"],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fennifith%2FMarkdownToJupyter","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fennifith%2FMarkdownToJupyter/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fennifith%2FMarkdownToJupyter/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/fennifith%2FMarkdownToJupyter/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/fennifith","download_url":"https://codeload.github.com/fennifith/MarkdownToJupyter/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":239517097,"owners_count":19652073,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cli","jupyter","jupyter-notebook","nodejs"],"created_at":"2025-02-18T17:31:01.422Z","updated_at":"2025-11-07T04:30:35.797Z","avatar_url":"https://github.com/fennifith.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"The Markdown to Jupyter Conversion tool (MTJC) is a fairly simple script that converts a markdown file with code blocks to the JSON format used by [Jupyter](https://jupyter.org/) to create [Notebooks](https://jupyter-notebook.readthedocs.io/en/stable/).\n\nMTJC separates the provided markdown file into \"cells\", looking for headers and code blocks to split the content at. Each header and any following text, list, or whatever will be placed in the same block until either another header or a code block (\"```\") is encountered.\n\nWhen a code block is encountered, it writes the code to a file in .temp (relative to the folder it is run in), passes it to the relevant program to run, and stores the result.\n\nFor demonstration purposes, here is a sample [markdown file](./test-python.md) and the [notebook](./test-python.ipynb) output from the program as a result.\n\n## Limitations\n\n- Currently, this script can only process Python. I plan to change this, but as I have no use for any of the other possible languages myself, it is not high on my agenda.\n- This script assumes that all output from a Python script will be sent to stdout. It is not currently capable of processing image data such as the charts and graphs that Jupyter Notebooks are capable of displaying.\n- Code blocks are run individually. A variable set in one will not carry over to another. See issue [#3](https://jfenn.me/redirects/?t=github\u0026d=MarkdownToJupyter/issues/3) for progress.\n\n## Installation\n\nAssuming that you have already installed [npm](https://www.npmjs.com/), in the command line, type either one of the following:\n\n### NPM\n\n```bash\nnpm install -g mtjc\n```\n\n### From Source\n\n```bash\ngit clone https://github.com/TheAndroidMaster/MarkdownToJupyter\ncd MarkdownToJupyter\nnpm install\n```\n\n## Usage\n\n```\nmtjc \u003cfile.md\u003e\n```\n\nOr, to specify a path for the output file...\n\n```\nmtjc \u003cfile.md\u003e \u003coutput.ipynb\u003e\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffennifith%2FMarkdownToJupyter","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Ffennifith%2FMarkdownToJupyter","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Ffennifith%2FMarkdownToJupyter/lists"}