mkdocs-embed-file-plugins 1.2.13

A plugin to quote file from docs

Embed File

A way to embed a file present in your docs. Support both wikilinks & normal links. Intended to be used by obsidian user.

Activate the plugin

1. Run pip install mkdocs-embed-file-plugins
2. Update your mkdocs.yml with :

   plugins:
     - search
     - embed_file 
   

3. Override your main.html with :

   {% extends "base.html" %}
   {% block extrahead %}
   
       <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/@fortawesome/fontawesome-free@5.15.4/css/fontawesome.min.css" integrity="sha384-jLKHWM3JRmfMU0A5x5AkjWkw/EYfGUAGagvnfryNV3F9VqM98XiIH7VBGVoxVSc7" crossorigin="anonymous">
   {% endblock %}
   

Usage

Usage	wikilinks	markdown links
cite a entire file	![[filename]]	
Cite a heading part	![[filename#heading]]	
Cite a block	![[filename#^blockid]]	

CSS

The plugin will create :

• A link to the original file, with the form of : <a href="original link" class="link_citation"><i class='fas fa-link'></i></a>
• A div with the founded content : <div class="citation">content founded</div>
• In case of the link / contents is not found : <div class="not_found">filename#part</div>

You can add a css in your docs/assets/css (or whatever the path is), and add it to your mkdocs.yml :

extra_css:
    - assets/css/embed_link.css

You can find an example of custom css in docs

Limitation

• The embed file don't use plugin you would use.
• Wikilinks ambiguity are not supported : the first file with the name are used.

Credit

Thanks to midnightprioriem for the tooltip plugin.