{ "info": { "author": "Scott Frazer", "author_email": "scott.d.frazer@gmail.com", "bugtrack_url": null, "classifiers": [ "Development Status :: 5 - Production/Stable", "Environment :: Console", "Intended Audience :: Developers", "License :: OSI Approved :: MIT License", "Natural Language :: English", "Programming Language :: Python :: 2.7", "Programming Language :: Python :: 3.4", "Programming Language :: Python :: 3.5", "Programming Language :: Python :: 3.6", "Programming Language :: Python :: 3.7", "Topic :: Text Processing", "Topic :: Utilities" ], "description": "# Markdown TOC Generator\n\n`mdtoc` is a command-line utility to generate table of contents within [Markdown](https://daringfireball.net/projects/markdown/) (.md) files.\n\n\n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n \n
SupportsPython 2.7 | 3.4 | 3.5 | 3.6 | 3.7
Latest Release\n \n \"latest\n \n
Package Status\n \n \"status\"
License\n \n \"license\"\n \n
\n\n## Install\n\nInstall via `pip install mdtoc`.\n\n## Basic Usage\n\nAdd these delimiters to your Markdown file:\n\n```\n\n\n```\n\nThen, from the command line, run:\n\n```bash\n$ mdtoc /path/to/myfile.md\n```\n\nThis will overwrite the target file `/path/to/myfile.md` in-place with the table of contents replacing the text _in between_ the delimiters marked above. (The delimiters themselves are invisible comments when rendered.) If you want to write to a new file, use `--outfile`. If you want to write just the TOC to stdout, use `--stdout`.\n\n## Technical Details\n\n`mdtoc` parses Markdown \"atx-style\" headers only: 1-6 hash characters (`#`) at the start of the line followed by the header. It does *not* currently detect \"setext-style\" (underlined) headers.\n\nThe [Daring Fireball page](https://daringfireball.net/projects/markdown/syntax#header) is the closest thing that exists to an original, canonical syntax specification for Markdown. (The page is created and hosted by John Gruber, the initial developer of Markdown as a language.) However, this page leaves a good amount of ambiguity. Because of that, **`mdtoc` also incorporates rules from [GitHub-flavored Markdown](https://github.github.com/gfm/#atx-heading)**, which gives a fuller specification:\n\n> An ATX heading consists of a string of characters, parsed as inline content, between an opening sequence of 1\u20136 unescaped # characters and an optional closing sequence of any number of unescaped `#` characters. The opening sequence of `#` characters must be followed by a space or by the end of line. The optional closing sequence of `#`s must be preceded by a space and may be followed by spaces only. The opening # character may be indented 0-3 spaces. The raw contents of the heading are stripped of leading and trailing spaces before being parsed as inline content. The heading level is equal to the number of # characters in the opening sequence.\n\n**Please consider the [GitHub-flavored Markdown](https://github.github.com/gfm/#atx-heading) rules to be the definitive empirical rulebook used by this tool.** If you find a violation of that, pull requests are appreciated.\n\nYou can also check live examples in `tests/examples.md`. This doc serves as touch-and-feel proof of GitHub's take on Markdown formatting, as well including some novel examples that even GitHub's page itself does not cover.\n\nOne break from GitHub is that this tool counts tabs as spaces, for all intents and purposes. This is different from the GitHub specification, which defines a space strictly as `U+0020`.\n\nTwo other small notes:\n\n- `mdtoc` will ignore comments prefaced with `#` that occur in Markdown code blocks (\\`\\`\\`).\n- `mdtoc` does *not* check for congruency/continuity of header levels. If a level-3 header comes directly after a level-1 header, that is on you and will be rendered as-is.\n\n## Full Command-Line Help Doc\n\n```\n$ mdtoc --help\nusage: mdtoc [-h] [--version] [--check-links] [--outfile OUTFILE | --stdout]\n markdown_file\n\nGenerates table of contents for Markdown files.\n\nThe algorithm searches for the text blocks\nbetween the delimiters:\n\n\n... anything ...\n\n\nThe contents of the block are then replaced\nby a table of contents.\n\npositional arguments:\n markdown_file relative or abs. path of the Markdown\n (.md) file to overwrite\n\noptional arguments:\n -h, --help show this help message and exit\n --version show program's version number and exit\n --check-links find all hyperlinks and ensure that\n they point to something valid\n --outfile OUTFILE instead of overwriting the input file,\n write to this file instead\n --stdout don't write or overwrite any file;\n just print the TOC to stdout\n\nCreated by Scott Frazer (https://github.com/scottfrazer).\n```\n\n\n", "description_content_type": "text/markdown", "docs_url": null, "download_url": "", "downloads": { "last_day": -1, "last_month": -1, "last_week": -1 }, "home_page": "http://github.com/scottfrazer/mdtoc", "keywords": "Markdown,table of contents,toc", "license": "MIT", "maintainer": "", "maintainer_email": "", "name": "mdtoc", "package_url": "https://pypi.org/project/mdtoc/", "platform": "", "project_url": "https://pypi.org/project/mdtoc/", "project_urls": { "Homepage": "http://github.com/scottfrazer/mdtoc" }, "release_url": "https://pypi.org/project/mdtoc/1.3/", "requires_dist": [ "xtermcolor", "requests (<3.0.0)" ], "requires_python": "", "summary": "Adds table of contents to Markdown files", "version": "1.3" }, "last_serial": 4954641, "releases": { "0.2": [ { "comment_text": "", "digests": { "md5": "3bfcb1834be04d2faf043c7778367465", "sha256": "2ba6095c262b43c5f4279d7017b9364fb32dba8e0aba13880767bcf3714766c8" }, "downloads": -1, "filename": "mdtoc-0.2-py3-none-any.whl", "has_sig": false, "md5_digest": "3bfcb1834be04d2faf043c7778367465", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 6901, "upload_time": "2019-02-27T13:50:47", "url": "https://files.pythonhosted.org/packages/51/c9/40b6bd870fc2d739c2edb1f0094a48af27bee3b59fd94a102aa3b2e07107/mdtoc-0.2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "b63421d22c79f38a198fb486d6b76e73", "sha256": "f9d2695a65f7a0ad3e9d01f17355c9a212fda738ada882010c4986c223740f26" }, "downloads": -1, "filename": "mdtoc-0.2.tar.gz", "has_sig": false, "md5_digest": "b63421d22c79f38a198fb486d6b76e73", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6703, "upload_time": "2019-02-27T13:50:48", "url": "https://files.pythonhosted.org/packages/a1/9a/33ded3b66681f75807a529e9e36885e84f06ea1a1ddf081339a3310286f7/mdtoc-0.2.tar.gz" } ], "1.0": [ { "comment_text": "", "digests": { "md5": "2687758b632ae4a121994f5551f6cdf1", "sha256": "e1564c02e5eac814a0d01e6ab4f3adbef4167a31e213aa6956883c7285b7e7ff" }, "downloads": -1, "filename": "mdtoc-1.0.tar.gz", "has_sig": false, "md5_digest": "2687758b632ae4a121994f5551f6cdf1", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 2743, "upload_time": "2015-12-10T15:12:54", "url": "https://files.pythonhosted.org/packages/f6/99/a4a2f1f8523ddaf7a20bda1db32feeaa6898449b2828493639cbc1f08770/mdtoc-1.0.tar.gz" } ], "1.1": [ { "comment_text": "", "digests": { "md5": "d16854ec20fca1a028c4e02d5971cfea", "sha256": "2b2ce5c2bb481b394ab7e1812f801338b55485f5535d3dc3bc2f272917eba33d" }, "downloads": -1, "filename": "mdtoc-1.1-py3-none-any.whl", "has_sig": false, "md5_digest": "d16854ec20fca1a028c4e02d5971cfea", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 6900, "upload_time": "2019-02-27T13:52:31", "url": "https://files.pythonhosted.org/packages/db/09/cd4d268bf7a75a14d6dc21921a6b7a3708a7ea0be9ceeed12e9f99e2923c/mdtoc-1.1-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "f83edaab8fb5f796ed11edab532cf69c", "sha256": "3d6e643a09c681b11c48de759bb6b8c3664020e1baabc5d0077f4db92e36c809" }, "downloads": -1, "filename": "mdtoc-1.1.tar.gz", "has_sig": false, "md5_digest": "f83edaab8fb5f796ed11edab532cf69c", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 6710, "upload_time": "2019-02-27T13:52:32", "url": "https://files.pythonhosted.org/packages/0c/3f/a625c7e1b8b1e84cd9cbf5bb05e29df6cb61f3326c7fcf5ca1fe684eb844/mdtoc-1.1.tar.gz" } ], "1.2": [ { "comment_text": "", "digests": { "md5": "6f404a4f596b973ec0cbf280d4ca9f9a", "sha256": "c358f95af69ebc927dc4763175ca288a054ff192f6a4e1ee9768bf1dfef3a69d" }, "downloads": -1, "filename": "mdtoc-1.2-py3-none-any.whl", "has_sig": false, "md5_digest": "6f404a4f596b973ec0cbf280d4ca9f9a", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 8852, "upload_time": "2019-03-18T15:45:42", "url": "https://files.pythonhosted.org/packages/96/4e/199ba8116161fc81a62a8a465522aaa0cae09ec9a86ba953dfa39acc3701/mdtoc-1.2-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "eafd5791099c4edb24a5b826e8766189", "sha256": "95adee66a51d33b1293047bb8696427690d8fc727c57eb55a4518dd67649f027" }, "downloads": -1, "filename": "mdtoc-1.2.tar.gz", "has_sig": false, "md5_digest": "eafd5791099c4edb24a5b826e8766189", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7133, "upload_time": "2019-03-18T15:45:43", "url": "https://files.pythonhosted.org/packages/35/0e/1274bf9aa6d99c1d3b478a1fb1447591010e4ae6389d7a8369f1adb3217c/mdtoc-1.2.tar.gz" } ], "1.3": [ { "comment_text": "", "digests": { "md5": "b395082f0ab3e09fbc9bdfb2172ef83f", "sha256": "2c807d32cf9f85740c10c3621c0f455e5d646089e7703c9fe4f3ba9d84d14b8e" }, "downloads": -1, "filename": "mdtoc-1.3-py3-none-any.whl", "has_sig": false, "md5_digest": "b395082f0ab3e09fbc9bdfb2172ef83f", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 8871, "upload_time": "2019-03-18T15:47:28", "url": "https://files.pythonhosted.org/packages/95/83/41aab7eb45cb79bd81e1974affe12caf92f905be115da6a2af84ac4cdc74/mdtoc-1.3-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "9ee0d65476a94b26c754322d9ea53656", "sha256": "ea6899a990ee64109094346fae927eececdd4b5e0dfefb42fb9bc1fda6a87d89" }, "downloads": -1, "filename": "mdtoc-1.3.tar.gz", "has_sig": false, "md5_digest": "9ee0d65476a94b26c754322d9ea53656", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7158, "upload_time": "2019-03-18T15:47:30", "url": "https://files.pythonhosted.org/packages/7f/2b/cacefaf25af104eaf05292968aa156fc753332e2cd3d741cecd9eceeb343/mdtoc-1.3.tar.gz" } ] }, "urls": [ { "comment_text": "", "digests": { "md5": "b395082f0ab3e09fbc9bdfb2172ef83f", "sha256": "2c807d32cf9f85740c10c3621c0f455e5d646089e7703c9fe4f3ba9d84d14b8e" }, "downloads": -1, "filename": "mdtoc-1.3-py3-none-any.whl", "has_sig": false, "md5_digest": "b395082f0ab3e09fbc9bdfb2172ef83f", "packagetype": "bdist_wheel", "python_version": "py3", "requires_python": null, "size": 8871, "upload_time": "2019-03-18T15:47:28", "url": "https://files.pythonhosted.org/packages/95/83/41aab7eb45cb79bd81e1974affe12caf92f905be115da6a2af84ac4cdc74/mdtoc-1.3-py3-none-any.whl" }, { "comment_text": "", "digests": { "md5": "9ee0d65476a94b26c754322d9ea53656", "sha256": "ea6899a990ee64109094346fae927eececdd4b5e0dfefb42fb9bc1fda6a87d89" }, "downloads": -1, "filename": "mdtoc-1.3.tar.gz", "has_sig": false, "md5_digest": "9ee0d65476a94b26c754322d9ea53656", "packagetype": "sdist", "python_version": "source", "requires_python": null, "size": 7158, "upload_time": "2019-03-18T15:47:30", "url": "https://files.pythonhosted.org/packages/7f/2b/cacefaf25af104eaf05292968aa156fc753332e2cd3d741cecd9eceeb343/mdtoc-1.3.tar.gz" } ] }