mkdocs-content-tabs 1.0.5

A simple plugin that converts Obsidian content tabs and converts them into mkdocs supported content tabs.

mkdocs-content-tabs

This repository is modified from mkdocs-callouts.

The plugin converts Obsidian tabs(obsidian-tab-panels or obsidian-html-tabs) into content tabs supported by MkDocs.

Setup

Install the plugin using pip:

pip install mkdocs-content-tabs

Activate the plugin in mkdocs.yml, note that some markdown_extensions are required for this plugin to function correctly:

markdown_extensions:
  - nl2br
  - admonition
  - pymdownx.details
  - pymdownx.superfences

plugins:
  - search
  - content-tabs

Note: If you have no plugins entry in your config file yet, you'll likely also want to add the search plugin. MkDocs enables it by default if there is no plugins entry set, but now you have to enable it explicitly.

Usage

mkdocs-content-tabs converts the following:

  ~~~ tabs
    === c++
    ``` cpp
    std::cout << "hello, c++!" << std::endl;
    ```

    === python
    ``` python
    print("hello, python!")
    ```

    === text
    this is a test.
  ~~~

and turns it into:

=== "c++"
``` cpp
std::cout << "hello, c++!" << std::endl;
```
=== "python"
``` python
print("hello, python!")
```

=== "text"
this is a test.