Mkdocs Publisher

Mkdocs is now deprecated, no support and help will be provided.

Quick installation tutorial

1. Click on use this template
2. Use the name of your choice
3. Set and edit the mkdocs.yml in the root of the repository. You can set up this by following the tutorial here

Plugin configuration

🆕Obsidian Publisher 6.1.0 : You can load the settings from the preset using the button “Preset” and selecting mkdocs in the selector!

The majority of the settings are optional and help you to manage your repository.

The mandatory settings are :

1. In Upload configuration :
   • Folder behavior: YAML frontmatter or Obsidian Path
   • Root folder: docs
   • Folder note: index.md
   • Excluded files : (Only if you use the auto-clean up function) : docs/assets/js, docs/assets/meta, docs/assets/css, tags.md, graph.md
2. Content’s conversion :
   • Internal Links : Toggle on
3. Embed files :
   • Transfer attachments:✅
   • Default attachment folder: docs/assets/img
     The images must be in the docs/ folder, but you can change the assets/img part as you want.

Support

• Wiki links ([[Links]])
• File transclusion/embed, both wiki links and markdown links
• Obsidian callout and custom callouts
• Folder notes and their citations
• Custom attributes
• Sharing state and custom folder hierarchies
• Mobile and desktop compatibility
• File mini preview on hover
• Graph view 🎉 (using obsidiantools)