svemagie.net/obsidian-micropub
1
0
Fork 0
mirror of https://github.com/svemagie/obsidian-micropub.git synced 2026-05-14 19:38:50 +02:00
Code Issues Packages Projects Releases Wiki Activity

docs: document post-status draft/publish workflow and visibility values

Browse Source 
Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
This commit is contained in:
svemagie
2026-04-27 15:31:56 +02:00
parent 7ead745866
commit 4e44912016
1 changed files with 4 additions and 1 deletions
Download Patch File Download Diff File Expand all files Collapse all files
README.md
+4 -1
View File
@@ -142,9 +142,12 @@ mp-url: "https://example.com/articles/2026/on-building-in-public"
| `mp-url` / `url` | Existing post URL — triggers an **update** rather than create | | `mp-url` / `url` | Existing post URL — triggers an **update** rather than create |
| `postType` | Force post type: `article` (sets `name`), `note` (skips `name`) | | `postType` | Force post type: `article` (sets `name`), `note` (skips `name`) |
| `title` / `name` | Sets the post `name`; presence auto-detects post type as article | | `title` / `name` | Sets the post `name`; presence auto-detects post type as article |
| `post-status` | `draft` (default) / `published` — controls whether the post is saved as draft or published live |
If no `postType` is set: a note with a `title` or `name` field publishes as an article; a note without one publishes as a note. If no `postType` is set: a note with a `title` or `name` field publishes as an article; a note without one publishes as a note.
**Draft / publish workflow:** every note defaults to `draft` unless you explicitly set `post-status: published`. When a draft is successfully submitted, the local frontmatter is left unchanged (status stays `draft`). When published, `post-status: published` is written back to the note.
### Content ### Content
| Property | Effect | | Property | Effect |
@@ -152,7 +155,7 @@ If no `postType` is set: a note with a `title` or `name` field publishes as an a
| `created` / `date` | Sets `published` date; `created` takes priority (matches Obsidian's default) | | `created` / `date` | Sets `published` date; `created` takes priority (matches Obsidian's default) |
| `tags` + `category` | Both merged into Micropub `category`; `garden/*` and bare `garden` tags are filtered out | | `tags` + `category` | Both merged into Micropub `category`; `garden/*` and bare `garden` tags are filtered out |
| `summary` / `excerpt` | Sets the `summary` property | | `summary` / `excerpt` | Sets the `summary` property |
| `visibility` | `public` / `unlisted` / `private` | | `visibility` | `public` (default) / `unlisted` / `private` — `public` is only sent if your **Default visibility** setting is non-public |
| `photo` | Featured photo: a URL string, array of URLs, or `[{url, alt}]` objects | | `photo` | Featured photo: a URL string, array of URLs, or `[{url, alt}]` objects |
| `related` | List of `[[WikiLinks]]` or URLs to related posts; WikiLinks are resolved to `mp-url` | | `related` | List of `[[WikiLinks]]` or URLs to related posts; WikiLinks are resolved to `mp-url` |