My Obsidian & Mkdocs workflow

Hello Everyone,

I wanted to share with you my workflow with Obsidian and Mkdocs. And why I chose both.

I’m an Instructor & Technical Writer. I wanted a tool that:

  1. Supports publishing my .md files
  2. Supports Multi-language (ltr +rtl)
  3. Supports HTML & javaScript tags

Mkdocs is a great static site generator tool, build using Python. It’s extremely easy to use and modify.

All what you need to after finishing modifications - CSS & YAML - is to open the /docs folder as your vault in Obsidian.

In regards to multi-language support, I’m writing in both Arabic & English. So I need to create a duplicate of each markdown file with a slight change. ex: & So when the used switch languages from the main navigation bar, files are going to be replaced with the correct language.

Here is a link of a quick live version on github:

Here is a screenshot:

I’ve installed exactly:

  1. Mkdocs Material
  2. Mkdocs Gruvbox
  3. Mkdocs i18n plugin

And some other dependencies in the virtual environment. It was very easy thanks to God.

Please let me know if you have any suggestions, ideas or questions. I’ll be very happy to help :slight_smile:


Your site is very tidy and attractive. The instructional content looks clear and well organized. Good job.

A very tidy website!
Do you think it’s possible to share only some note? I don’t want to have all my notes in github.

IIRC, mkdocs material does not support Mermaid. How did you draw diagram like in your demo post? Thanks.

1 Like

I also like how you did the tabs for the code-blocks

mind sharing the source md-files?