# Enveloppe plugin for Obsidian
Enveloppe, by Mara-Li (formerly known as "Obsidian GitHub Publisher" and "MkDocs Publisher"), publishes selected vault notes to a [[GitHub]] repository. The typical setup pairs it with a static site generator — MkDocs, Hugo, Jekyll, Eleventy (11ty), or any pipeline that builds from a repo — so pushing notes automatically becomes publishing a website.
Publication is frontmatter-gated: only notes carrying a share property (e.g. `share: true`) are ever sent, which keeps the private vault private by default and makes going public a deliberate per-note decision. On publish, Enveloppe converts Obsidian-specific syntax for the outside world: wikilinks become regular markdown links (resolved only among shared notes), embeds and attachments are copied across, dataview blocks can be rendered, and paths and filenames can be rewritten per configurable rules.
The plugin also keeps the remote repository in sync with the vault: when a shared note is deleted or unshared, the corresponding file is removed from the repo on the next publish. This makes the whole publishing chain automatic — edit in [[Obsidian]], toggle a property, and CI on the repository rebuilds and deploys the site. It is a flexible self-managed alternative to [[Obsidian Publish]].
## References
- Download: https://obsidian.md/plugins?id=obsidian-mkdocs-publisher
- Source code: https://github.com/Enveloppe/obsidian-enveloppe