# Publisher for MkDocs
[](https://opensource.org/license/mit/)
[](https://pypi.org/project/mkdocs-publisher/)
[](https://www.python.org)
[](https://pypistats.org/search/mkdocs-publisher)
[](https://github.com/mkusz/mkdocs-publisher/commits/main)
[](https://github.com/pre-commit/pre-commit)

Publisher for [MkDocs](https://www.mkdocs.org/) is a set of plugins that helps with content creation and publication.
## Features
- [pub-meta](https://mkdocs-publisher.github.io/setup/general/pub-meta/) – support for:
- automatic [document navigation](https://www.mkdocs.org/user-guide/configuration/#nav) creation based on file names order,
- document publication status,
- possibility to define document and directories URL (good for SEO),
- document creation and update date (good for SEO),
- [pub-blog](https://mkdocs-publisher.github.io/setup/general/pub-blog/) – blogging capability:
- index creation,
- support for blog post teasers,
- automatic creation of pages for archive, categories and tags,
- [pub-obsidian](https://mkdocs-publisher.github.io/setup/general/pub-obsidian/) – bindings for [Obsidian.md](https://obsidian.md) that allows you to use:
- [backlinks](https://help.obsidian.md/Plugins/Backlinks),
- [callouts](https://help.obsidian.md/Editing+and+formatting/Callouts),
- [wikilinks](https://help.obsidian.md/Linking+notes+and+files/Internal+links),
- [vega charts](https://vega.github.io/vega/) (using [Vega Visualization Plugin for Obsidian](https://github.com/Some-Regular-Person/obsidian-vega)) - advanced solution for creating charts,
- [pub-social](https://mkdocs-publisher.github.io/setup/seo-and-sharing/pub-social/) – social cards for social media sharing using document metadata,
- [pub-minifier](https://mkdocs-publisher.github.io/setup/seo-and-sharing/pub-minifier/) – file size optimization (good for SEO and overall page size optimization),
- [pub-debugger](https://mkdocs-publisher.github.io/setup/development/pub-debugger/) – logging on steroids with the possibility of creating of ZIP file with logs and additional information (can be used for better issue reporting).
## Installation
```commandline
pip install mkdocs-publisher
```
More information about installation methods and plugin setup can be found on this [documentation page](https://mkdocs-publisher.github.io/setup/installation/).
> [!warning]
> Before any use, make sure you have a backup of your data.
> [!note]
> As a base for any development, [mkdocs-material](https://squidfunk.github.io/mkdocs-material/) theme was used. If you are willing to use any other theme, you may (or may not) face some issues. If this happens, please submit an [issue](https://github.com/mkdocs-publisher/mkdocs-publisher/issues).
After installation, you have to enable plugins and Material for MkDocs theme in `mkdocs.yml` file:
```yaml
theme: material
plugins:
- search # Material for MkDocs search plugin
- pub-debugger
- pub-blog
- pub-obsidian
- pub-social
- pub-meta
- pub-minifier
```
## Planned features
A full list of planned developments can be found on [this documentation page](https://mkdocs-publisher.github.io/development/other/backlog/). I'm planning to move it to the project [GitHub issues](https://github.com/mkusz/mkdocs-publisher/issues) with proper badges and longer descriptions, but it's time-consuming and at this stage I'd rather spend it developing a project.
## Version history
The entire version history can be found in the project [version history](https://mkdocs-publisher.github.io/development/changelog/) document and inside [releases](https://github.com/mkusz/mkdocs-publisher/releases).
Raw data
{
"_id": null,
"home_page": null,
"name": "mkdocs-publisher",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.9",
"maintainer_email": null,
"keywords": "blog, categories, debugger, docs, documentation, frontmatter, markdown, minifier, mkdocs, mkdocs-plugin, navigation, obsidian, publisher, tags",
"author": null,
"author_email": "Maciej 'maQ' Kusz <maciej.kusz@gmail.com>",
"download_url": "https://files.pythonhosted.org/packages/2d/73/2120374a528c6ef58bac387f0562226d4c3072702a4730b8e4fb314f5fe9/mkdocs_publisher-1.4.8.tar.gz",
"platform": null,
"description": "# Publisher for MkDocs\n\n[](https://opensource.org/license/mit/)\n[](https://pypi.org/project/mkdocs-publisher/)\n[](https://www.python.org)\n[](https://pypistats.org/search/mkdocs-publisher)\n[](https://github.com/mkusz/mkdocs-publisher/commits/main)\n[](https://github.com/pre-commit/pre-commit)\n\n\nPublisher for [MkDocs](https://www.mkdocs.org/) is a set of plugins that helps with content creation and publication.\n\n## Features\n\n- [pub-meta](https://mkdocs-publisher.github.io/setup/general/pub-meta/) \u2013 support for:\n\t- automatic [document navigation](https://www.mkdocs.org/user-guide/configuration/#nav) creation based on file names order,\n\t- document publication status,\n\t- possibility to define document and directories URL (good for SEO),\n\t- document creation and update date (good for SEO),\n- [pub-blog](https://mkdocs-publisher.github.io/setup/general/pub-blog/) \u2013 blogging capability:\n\t- index creation,\n\t- support for blog post teasers,\n\t- automatic creation of pages for archive, categories and tags,\n- [pub-obsidian](https://mkdocs-publisher.github.io/setup/general/pub-obsidian/) \u2013 bindings for [Obsidian.md](https://obsidian.md) that allows you to use:\n\t- [backlinks](https://help.obsidian.md/Plugins/Backlinks),\n\t- [callouts](https://help.obsidian.md/Editing+and+formatting/Callouts),\n\t- [wikilinks](https://help.obsidian.md/Linking+notes+and+files/Internal+links),\n\t- [vega charts](https://vega.github.io/vega/) (using [Vega Visualization Plugin for Obsidian](https://github.com/Some-Regular-Person/obsidian-vega)) - advanced solution for creating charts,\n- [pub-social](https://mkdocs-publisher.github.io/setup/seo-and-sharing/pub-social/) \u2013 social cards for social media sharing using document metadata,\n- [pub-minifier](https://mkdocs-publisher.github.io/setup/seo-and-sharing/pub-minifier/) \u2013 file size optimization (good for SEO and overall page size optimization),\n- [pub-debugger](https://mkdocs-publisher.github.io/setup/development/pub-debugger/) \u2013 logging on steroids with the possibility of creating of ZIP file with logs and additional information (can be used for better issue reporting).\n\n## Installation\n\n```commandline\npip install mkdocs-publisher\n```\n\nMore information about installation methods and plugin setup can be found on this [documentation page](https://mkdocs-publisher.github.io/setup/installation/).\n\n> [!warning]\n> Before any use, make sure you have a backup of your data.\n\n> [!note]\n> As a base for any development, [mkdocs-material](https://squidfunk.github.io/mkdocs-material/) theme was used. If you are willing to use any other theme, you may (or may not) face some issues. If this happens, please submit an [issue](https://github.com/mkdocs-publisher/mkdocs-publisher/issues).\n\nAfter installation, you have to enable plugins and Material for MkDocs theme in `mkdocs.yml` file:\n\n```yaml\ntheme: material\n\nplugins:\n - search # Material for MkDocs search plugin\n - pub-debugger\n - pub-blog\n - pub-obsidian\n - pub-social\n - pub-meta\n - pub-minifier\n```\n\n## Planned features\n\nA full list of planned developments can be found on [this documentation page](https://mkdocs-publisher.github.io/development/other/backlog/). I'm planning to move it to the project [GitHub issues](https://github.com/mkusz/mkdocs-publisher/issues) with proper badges and longer descriptions, but it's time-consuming and at this stage I'd rather spend it developing a project.\n\n## Version history\n\nThe entire version history can be found in the project [version history](https://mkdocs-publisher.github.io/development/changelog/) document and inside [releases](https://github.com/mkusz/mkdocs-publisher/releases).\n",
"bugtrack_url": null,
"license": null,
"summary": "Publisher for MkDocs - set of plugins for content creators",
"version": "1.4.8",
"project_urls": {
"Bug Tracker": "https://github.com/mkdocs-publisher/mkdocs-publisher/issues",
"Documentation": "https://mkdocs-publisher.github.io/",
"Homepage": "https://mkdocs-publisher.github.io/",
"Repository": "https://github.com/mkdocs-publisher/mkdocs-publisher"
},
"split_keywords": [
"blog",
" categories",
" debugger",
" docs",
" documentation",
" frontmatter",
" markdown",
" minifier",
" mkdocs",
" mkdocs-plugin",
" navigation",
" obsidian",
" publisher",
" tags"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "66cee5d3f233c916ba38c8d38e179149e6277871be402451ef61a008be91d1e5",
"md5": "a63687cb56c7f5d53247aa2ab127a374",
"sha256": "8b559ff3f5283f1804212cf9426695ca0319d612c8d88b175fe06bf9a84cf508"
},
"downloads": -1,
"filename": "mkdocs_publisher-1.4.8-py3-none-any.whl",
"has_sig": false,
"md5_digest": "a63687cb56c7f5d53247aa2ab127a374",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.9",
"size": 92459,
"upload_time": "2025-07-12T12:43:25",
"upload_time_iso_8601": "2025-07-12T12:43:25.726923Z",
"url": "https://files.pythonhosted.org/packages/66/ce/e5d3f233c916ba38c8d38e179149e6277871be402451ef61a008be91d1e5/mkdocs_publisher-1.4.8-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "2d732120374a528c6ef58bac387f0562226d4c3072702a4730b8e4fb314f5fe9",
"md5": "121633f79b422c99e235a64aa91a3755",
"sha256": "8d1542bcc2e5b009695c61e2bac46487e91bb5de8b2a6577d2a8b555a150e98e"
},
"downloads": -1,
"filename": "mkdocs_publisher-1.4.8.tar.gz",
"has_sig": false,
"md5_digest": "121633f79b422c99e235a64aa91a3755",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.9",
"size": 42051,
"upload_time": "2025-07-12T12:43:27",
"upload_time_iso_8601": "2025-07-12T12:43:27.429474Z",
"url": "https://files.pythonhosted.org/packages/2d/73/2120374a528c6ef58bac387f0562226d4c3072702a4730b8e4fb314f5fe9/mkdocs_publisher-1.4.8.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-07-12 12:43:27",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "mkdocs-publisher",
"github_project": "mkdocs-publisher",
"travis_ci": false,
"coveralls": false,
"github_actions": true,
"lcname": "mkdocs-publisher"
}