{"id":13602129,"url":"https://github.com/Enveloppe/obsidian-enveloppe","last_synced_at":"2025-04-11T08:31:34.133Z","repository":{"id":37240095,"uuid":"479063777","full_name":"Enveloppe/obsidian-enveloppe","owner":"Enveloppe","description":"Enveloppe helps you to publish your notes on a GitHub repository from your Obsidian Vault, for free!","archived":false,"fork":false,"pushed_at":"2025-03-12T07:55:46.000Z","size":4515,"stargazers_count":770,"open_issues_count":7,"forks_count":40,"subscribers_count":4,"default_branch":"master","last_synced_at":"2025-04-03T04:58:24.936Z","etag":null,"topics":["api","github","markdown","note","obsidian","plugin","publish"],"latest_commit_sha":null,"homepage":"https://enveloppe.ovh/","language":"TypeScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Enveloppe.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG-beta.md","contributing":null,"funding":".github/FUNDING.yml","license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null},"funding":{"github":"mara-li","ko_fi":"mara__li","custom":["https://paypal.me/MaraLi"]}},"created_at":"2022-04-07T16:25:39.000Z","updated_at":"2025-04-01T09:45:08.000Z","dependencies_parsed_at":"2024-04-10T10:45:11.498Z","dependency_job_id":"7ede9704-961c-49ab-96c9-4d6d3758108e","html_url":"https://github.com/Enveloppe/obsidian-enveloppe","commit_stats":{"total_commits":1812,"total_committers":14,"mean_commits":"129.42857142857142","dds":0.1241721854304636,"last_synced_commit":"6ef166401d449dce6000d0fecfbd84cfbe786058"},"previous_names":["enveloppe/obsidian-enveloppe","obsidianpublisher/obsidian-github-publisher"],"tags_count":476,"template":false,"template_full_name":"obsidianmd/obsidian-sample-plugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Enveloppe%2Fobsidian-enveloppe","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Enveloppe%2Fobsidian-enveloppe/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Enveloppe%2Fobsidian-enveloppe/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Enveloppe%2Fobsidian-enveloppe/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Enveloppe","download_url":"https://codeload.github.com/Enveloppe/obsidian-enveloppe/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":247574085,"owners_count":20960496,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","github","markdown","note","obsidian","plugin","publish"],"created_at":"2024-08-01T18:01:14.753Z","updated_at":"2025-04-11T08:31:34.124Z","avatar_url":"https://github.com/Enveloppe.png","language":"TypeScript","funding_links":["https://github.com/sponsors/mara-li","https://ko-fi.com/mara__li","https://paypal.me/MaraLi","https://ko-fi.com/X8X54ZYAV'"],"categories":["TypeScript","HarmonyOS","api"],"sub_categories":["Windows Manager"],"readme":"![Obsidian Downloads](https://img.shields.io/badge/dynamic/json?logo=obsidian\u0026color=%23483699\u0026label=downloads\u0026query=%24%5B%22obsidian-mkdocs-publisher%22%5D.downloads\u0026url=https%3A%2F%2Fraw.githubusercontent.com%2Fobsidianmd%2Fobsidian-releases%2Fmaster%2Fcommunity-plugin-stats.json)\n\n# ✉️ Enveloppe : An Obsidian GitHub Vault Publisher\n\nPublish your notes in your own GitHub repository for free and do whatever you want with them. ✨\n\nThis allows you to set up any template: Jekyll, Mkdocs, Hugo, or custom-made ones!\n\n## 📑 [Documentation](https://enveloppe.ovh/)\n\nHere, you will only get a quick setup!\n\n## 🪄 Features\n\n- Converting `[[wikilinks]]` to markdown links\n- Linking to other notes and updating the links according to your settings\n- Cleaning the repo by removing depublished and deleted files\n- Folder notes (renaming them to a specific name, like `index.md`)\n- All dataview queries are supported (including `dataviewjs`, inline DQL and inline `dataviewJS`.)\n- Supporting any markdown syntax supported by your template, as well as other formats like Mermaid or Latex\n- And many more :sparkles:\n\n\u003e [!WARNING]\n\u003e Do not use this plugin to sync or save your Obsidian Vault!\n\u003e Avoid opening the converted files from your repository in Obsidian!\n\n---\n\n## 🖥️ Initial setup\n\nThere are plenty of options available, some of which are pre-configured and others are optional.\n\nBefore you begin, you will need to configure your GitHub repository.\n\n1. Fill in your username, repository name, and branch.\n2. Generate a GitHub token from the settings link and paste it here.\n3. Click the button to check if everything is working as intended.\n4. Now, let's try publishing your first note! To achieve this, you need to set the key `share: true` in the frontmatter of a file, like this:\n   ```\n   ---\n   share: true\n   ---\n   ```\n5. Now, run the command to publish: `Upload single current active note`\n6. If everything is good, a PR will be created on your repository and will be automatically merged (this can be disabled if desired!).\n\nThat's it! However, there are many options that a simple README cannot cover, so please refer to the documentation for more information. 💕.\n\n## ⚙️ Usage\n\nThe plugin adds 8 commands in the palette, one of which is also available in the right-click menu.\n\n- `Upload single current active note` (_available in the right-click menu_)\n- `Upload all notes`\n- `Upload unpublished notes`\n- `Refresh published and upload new notes`\n- `Refresh all published notes`\n- `Purge depublished and deleted files`\n- `Test the connection to the configured repository`\n- `Check the rate limit of the GitHub API`\n\nEach of the commands are explained [here](https://enveloppe.ovh/Commands).\n\n## 🤖 How it works\n\n1. The plugin will create a branch named after your vault, where spaces are replaced by a `-`.\n2. The plugin will perform all conversion (based on your settings) and push the note(s) into the branch.\n3. By default, the branch will be merged once all the notes (and their embedded files) have been processed.\n\n\u003e [!WARNING]\n\u003e Sometimes, the branch may not be merged due to merge conflicts. This can occur if you push too frequently.\n\n## 🪛 Developing\n\nYou can :\n\n- [Maintaining the project and adding new function](https://enveloppe.ovh/Getting%20Started/Developing/#plugin-development)\n- [Help with the translation](https://enveloppe.ovh/Getting%20Started/Developing/#translation-or-paraphrasing)\n\n## 🪧 Looking for something?\n\n→ [Settings explanation](https://enveloppe.ovh/Settings/Plugin_config/)\n← [Commands references](https://enveloppe.ovh/Getting%20Started/Commands/)\n→ [GitHub Discussion](https://github.com/orgs/Enveloppe/discussions)\n\n---\n\nIf you find this plugin and workflow useful, you can give me some coffee money!\u003cbr\u003e\n\u003ca href='https://ko-fi.com/X8X54ZYAV' target='_blank'\u003e\u003cimg height='36' style='border:0px;height:36px;display:block;margin-left:50%;' src='https://cdn.ko-fi.com/cdn/kofi1.png?v=3' border='0' alt='Buy Me a Coffee at ko-fi.com' /\u003e\u003c/a\u003e\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FEnveloppe%2Fobsidian-enveloppe","html_url":"https://awesome.ecosyste.ms/projects/github.com%2FEnveloppe%2Fobsidian-enveloppe","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2FEnveloppe%2Fobsidian-enveloppe/lists"}