Skip to content

Commit

Permalink
Improve documentation
Browse files Browse the repository at this point in the history
- Continue fixing issue #36: add feature comparsion table
  • Loading branch information
frnmst committed Dec 17, 2022
1 parent ac7675c commit 420beea
Show file tree
Hide file tree
Showing 3 changed files with 264 additions and 0 deletions.
3 changes: 3 additions & 0 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -72,6 +72,9 @@ after md-toc and similar tools were created:
- [pre-commit](https://pre-commit.com/)
[hook](https://docs.franco.net.eu.org/md-toc/pre_commit_hook.html)

And more! See the
[feature comparison table](https://docs.franco.net.eu.org/md-toc/features.html)

## Examples

You can use md-toc in your blog, documentation based on markdown,
Expand Down
260 changes: 260 additions & 0 deletions docs/features.rst
Original file line number Diff line number Diff line change
@@ -0,0 +1,260 @@
Features
========

=== ===============
Key Meaning
=== ===============
✓ implemented
/ partial support
✘ not implemented
? unknown
P feature planned
=== ===============

.. note:: This feature table might not be up to date or accurate! Do your own
research. If you find a mistake you are welcome to open an issue
or pull request.

.. list-table:: Feature comparison
:header-rows: 1

* - Feature
- md-toc
- `github-markdown-toc <https://github.com/ekalinin/github-markdown-toc>`_
- `markdown-toc <https://github.com/jonschlinkert/markdown-toc>`_
- `remark-toc <https://github.com/remarkjs/remark-toc>`_
- `markdown-it-table-of-contents <https://github.com/cmaas/markdown-it-table-of-contents>`_
- `gfm-toc <https://github.com/waynerv/github-markdown-toc>`_
- `md-toc-creator <https://github.com/mcb2003/md-toc-creator>`_
- `mdformat-toc <https://github.com/hukkin/mdformat-toc>`_
- `git-toc <https://github.com/PrzemekWirkus/git-toc>`_
* - Works offline
- ✓
- ✘
- ✓
- ✓
- ✓
- ✓
- ✓
- ✓
- ✓
* - Inplace & stdout
- ✓
- ✓
- ✓
- ?
- ?
- ✓
- ✓
- ✘
- ✘
* - Indented & non-indented list
- ✓
- ✘
- ✘
- ?
- ✘
- ✘
- ✓
- ?
- ✘
* - Ordered & unordered list
- ✓
- ✘
- ✘
- ✓
- ✓
- ✘
- ✘
- ?
- ✘
* - Anchor links & plain text list
- ✓
- ✘
- ✘
- ?
- ?
- ✘
- ✓
- ✓
- ✘
* - Max header level in TOC
- ✓
- ✘
- ?
- ✓
- ✓
- ✘
- ✘
- ✓
- ✘
* - Min header level in TOC
- ✘
- ✘
- ✘
- ✘
- ✓
- ✘
- ✘
- ✓
- ✘
* - Skip first n lines
- ✓
- ✘
- ?
- ?
- ✘
- ✘
- ✘
- ✘
- ✘
* - Reads from stdin
- ✓
- ✓
- ✓
- ?
- ?
- ✘
- ?
- ✘
- ✘
* - List marker selection
- ✓
- ✘
- ✓
- ?
- ?
- ✘
- ?
- ?
- ✘
* - Newline marker selection
- ✓
- ✘
- ?
- ?
- ?
- ?
- ?
- ?
- ✘
* - Include headings regex pattern
- ✘
- ✘
- ?
- ✓
- ✘
- ✘
- ✘
- ✘
- ✘
* - Skip headings regex pattern
- ✘
- ✘
- ?
- ✓
- ✘
- ✘
- ✘
- ✘
- ✘
* - Skip headings before TOC marker
- ✘
- ✓
- ?
- ?
- ?
- ?
- ?
- ?
- ?
* - Non-markdown output
- ✘ [P]
- ✘
- ✓
- ?
- ✓
- ✘
- ✘
- ?
- ✘
* - Universal anchor links
- ✘
- ?
- ✘
- ✘
- ✘
- ✘
- ✘
- ✓
- ✘
* - Remote markdown files
- ✘
- ✓
- ✘
- ✘
- ✘
- ✘
- ✘
- ✘
- ✘
* - Last TOC update string
- ✘
- ✓
- ?
- ?
- ?
- ?
- ?
- ?
- ?
* - Provides CLI
- ✓
- ✓
- ✓
- ✘
- ✘
- ✓
- ✓
- ✘
- ✓
* - Provides API
- ✓
- ✘
- ✓
- ?
- ✓
- ?
- ?
- ✓
- ?
* - Tries to follow markdown specs literally
- ✓
- ?
- ?
- ?
- ?
- ✘
- ✘
- /
- ✘
* - pre-commit hook
- ✓
- ?
- ?
- ?
- ?
- ?
- ?
- ?
- ?
* - Active project
- ✓
- ✓
- ✓
- ✓
- ✓
- ✘
- ✘
- ✓
- ✓
1 change: 1 addition & 0 deletions docs/index.rst
Original file line number Diff line number Diff line change
Expand Up @@ -6,6 +6,7 @@ md-toc documentation

install
api
features
markdown_specification
rules/index
pre_commit_hook
Expand Down

0 comments on commit 420beea

Please sign in to comment.