textual-markdown


Nametextual-markdown JSON
Version 0.1.1 PyPI version JSON
download
home_page
SummaryMarkdown viewer widgets for Textual
upload_time2022-12-17 09:37:08
maintainer
docs_urlNone
authorWill McGugan
requires_python>=3.7,<4.0
licenseMIT
keywords
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            # Textual Markdown Browser

This project is an experiment to see how far I could take the idea of a "Markdown browser" in the terminal, using the [Textual](https://github.com/Textualize/textual) framework.

Markdown in the terminal is not unusual, [Rich](https://github.com/Textualize/rich) has a decent Markdown renderer, but its output is essentially static. Textual Markdown creates a more dynamic Markdown document you can interact with: there are working links, srollablr code fences, and tables.

Links must be relative only and on the filesystem for now. These could be made to load from the network for a more browser like experience. It is also relatively easy to intercept links and handle them programatically. Opening up custom hypertext like applications.

And finally, there is a TOC (Table Of Contents) extracted from the Markdown, which can be used to navigate the document.

## Video

A short video of me playing with the demo Markdown.

https://user-images.githubusercontent.com/554369/208234316-be4e6626-c601-4dca-b8d1-59af9b4d08cd.mov


## Screenshots

![Screenshot 2022-12-17 at 08 41 58](https://user-images.githubusercontent.com/554369/208233944-542b1fec-daaf-4c4b-81d1-2d9eec61e727.png)


![Screenshot 2022-12-17 at 08 42 33](https://user-images.githubusercontent.com/554369/208233987-9667dd87-5ef3-45c3-91fc-166f069e14cb.png)

![Screenshot 2022-12-17 at 08 42 38](https://user-images.githubusercontent.com/554369/208233988-f0733761-6794-41f9-893f-f0258b23b988.png)

## Try it out

You can install `textual-markdown` from PyPI in the usual way:

```
pip install textual-markdown
```

Here's how you hopen a Markdown file:

```
python -m textual_markdown README.md
```

## Disclaimer

At time of writing, there is less than a weeks work in this. Which means you may (likely) find bugs. 

## The future

Some (or all) of this repo will be rolled in to [Textual](https://github.com/Textualize/textual). It may also become a project in its own right. If there is enough interest.

            

Raw data

            {
    "_id": null,
    "home_page": "",
    "name": "textual-markdown",
    "maintainer": "",
    "docs_url": null,
    "requires_python": ">=3.7,<4.0",
    "maintainer_email": "",
    "keywords": "",
    "author": "Will McGugan",
    "author_email": "willmcgugan@gmail.com",
    "download_url": "https://files.pythonhosted.org/packages/9e/b4/2c0af9032e8ae65d588d0f6de4b271a4ae03a115062c857b560794214332/textual_markdown-0.1.1.tar.gz",
    "platform": null,
    "description": "# Textual Markdown Browser\n\nThis project is an experiment to see how far I could take the idea of a \"Markdown browser\" in the terminal, using the [Textual](https://github.com/Textualize/textual) framework.\n\nMarkdown in the terminal is not unusual, [Rich](https://github.com/Textualize/rich) has a decent Markdown renderer, but its output is essentially static. Textual Markdown creates a more dynamic Markdown document you can interact with: there are working links, srollablr code fences, and tables.\n\nLinks must be relative only and on the filesystem for now. These could be made to load from the network for a more browser like experience. It is also relatively easy to intercept links and handle them programatically. Opening up custom hypertext like applications.\n\nAnd finally, there is a TOC (Table Of Contents) extracted from the Markdown, which can be used to navigate the document.\n\n## Video\n\nA short video of me playing with the demo Markdown.\n\nhttps://user-images.githubusercontent.com/554369/208234316-be4e6626-c601-4dca-b8d1-59af9b4d08cd.mov\n\n\n## Screenshots\n\n![Screenshot 2022-12-17 at 08 41 58](https://user-images.githubusercontent.com/554369/208233944-542b1fec-daaf-4c4b-81d1-2d9eec61e727.png)\n\n\n![Screenshot 2022-12-17 at 08 42 33](https://user-images.githubusercontent.com/554369/208233987-9667dd87-5ef3-45c3-91fc-166f069e14cb.png)\n\n![Screenshot 2022-12-17 at 08 42 38](https://user-images.githubusercontent.com/554369/208233988-f0733761-6794-41f9-893f-f0258b23b988.png)\n\n## Try it out\n\nYou can install `textual-markdown` from PyPI in the usual way:\n\n```\npip install textual-markdown\n```\n\nHere's how you hopen a Markdown file:\n\n```\npython -m textual_markdown README.md\n```\n\n## Disclaimer\n\nAt time of writing, there is less than a weeks work in this. Which means you may (likely) find bugs. \n\n## The future\n\nSome (or all) of this repo will be rolled in to [Textual](https://github.com/Textualize/textual). It may also become a project in its own right. If there is enough interest.\n",
    "bugtrack_url": null,
    "license": "MIT",
    "summary": "Markdown viewer widgets for Textual",
    "version": "0.1.1",
    "split_keywords": [],
    "urls": [
        {
            "comment_text": "",
            "digests": {
                "md5": "54a091be76c4dbd9f3189f36d3793cb9",
                "sha256": "0f95689b46abb1b4ed876298c039c5846b22f90bca0eeb0212332064fa30c972"
            },
            "downloads": -1,
            "filename": "textual_markdown-0.1.1-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "54a091be76c4dbd9f3189f36d3793cb9",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.7,<4.0",
            "size": 8261,
            "upload_time": "2022-12-17T09:37:07",
            "upload_time_iso_8601": "2022-12-17T09:37:07.443296Z",
            "url": "https://files.pythonhosted.org/packages/ac/e5/36d846aa1cea93a381acc9c8b63d25a3425affd33c95c81b65d287d1eb55/textual_markdown-0.1.1-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": "",
            "digests": {
                "md5": "c2ea534a8fa500b2f58acea694317a60",
                "sha256": "105d752dad210304be58b593653721139793523a3ad87c650cb901011d107c47"
            },
            "downloads": -1,
            "filename": "textual_markdown-0.1.1.tar.gz",
            "has_sig": false,
            "md5_digest": "c2ea534a8fa500b2f58acea694317a60",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.7,<4.0",
            "size": 7354,
            "upload_time": "2022-12-17T09:37:08",
            "upload_time_iso_8601": "2022-12-17T09:37:08.781080Z",
            "url": "https://files.pythonhosted.org/packages/9e/b4/2c0af9032e8ae65d588d0f6de4b271a4ae03a115062c857b560794214332/textual_markdown-0.1.1.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2022-12-17 09:37:08",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "lcname": "textual-markdown"
}
        
Elapsed time: 0.02687s