Obsidian Stats logoObsidian Stats

Typecho Publisher

by SKYue
5
4
3
2
1
Score: 35/100
New Plugin
Install Code

Description

This plugin has not been manually reviewed by Obsidian staff. Publish Obsidian notes to Typecho blog via XML-RPC, with Cloudflare R2 image hosting.

Reviews

No reviews yet.

Stats

stars
0
downloads
0
forks
0
days
NaN
days
NaN
days
0
total PRs
0
open PRs
0
closed PRs
0
merged PRs
0
total issues
0
open issues
0
closed issues
0
commits

Latest Version

Invalid date

Changelog

See all version on GitHub

README file from

Github

Typecho Publisher

中文用户请阅读 简体中文版说明。

Publish Obsidian notes to Typecho blog via XML-RPC, with configurable image hosting.

Features

  • One-click publish new posts or update existing ones
  • Image upload to Cloudflare R2 or Typecho's built-in media library
  • Image upload cache to avoid re-uploading
  • Custom frontmatter field mapping to Typecho XML-RPC fields
  • Strict frontmatter property type validation
  • Wiki-link to blog URL conversion
  • Content cutoff by section headings (e.g., hide draft sections)
  • Progress modal with success/error feedback and article URL link
  • Auto-detect Obsidian language, supports English and Simplified Chinese

Configuration

Typecho Connection

Fill in your Typecho site XML-RPC URL, username, and password.

Frontmatter Field Mapping

Map your custom frontmatter keys to Typecho fields. The dateCreated field is mandatory and must use Obsidian's "Date & Time" property type. Each field has a type requirement — publishing will fail if the type doesn't match.

Example:

---
published: 2026-06-14 22:00
aliases: My First Post
categories: [tech, obsidian]
tags: [obsidian, typecho]
slug: my-first-post
---

Slug Fallback

When no slug is set in frontmatter, it's auto-generated from the publish date using a configurable format string (tokens: YYYY, YY, MM, DD, HH, mm, ss).

Wiki-Link Conversion

Enable to convert [[wikilinks]] to blog post URLs when the target note is also a published blog post (has the dateCreated frontmatter field). Non-blog notes are converted to plain text. Configure a URL template with variables: {slug}, {postid}, {year}, {month}, {day}.

Content Cutoff

Specify section headings (comma-separated) that mark content to be excluded from publishing. Sections after (and including) these headings are stripped. Useful for hiding drafts, changelogs, or private notes.

Validation

Optionally require the <!--more--> tag in post body. Publish will fail if missing.

Image Hosting

Toggle between two modes:

  • Disabled — Images are uploaded to Typecho's built-in media library via metaWeblog.newMediaObject.
  • Enabled — Select an external hosting provider. Currently supports Cloudflare R2.

To set up Cloudflare R2:

  1. Create an R2 bucket in Cloudflare Dashboard
  2. Generate R2 API tokens (R2 → Manage R2 API Tokens)
  3. Enable public access for your bucket
  4. Fill in Account ID, Access Key, Secret Key, Bucket name, and Public URL

The upload path prefix supports date variables: {YYYY}, {YY}, {MM}, {DD}, {HH}, {mm}, {ss} (based on publish date).

Usage

  • Open a Markdown note and run the Publish to Typecho command
  • Right-click a .md file in the file explorer and select Publish to Typecho
  • Use the editor context menu

On first publish, the plugin checks if the note lacks typecho_postid and asks for confirmation to create a new post. The typecho_postid field is automatically added to the frontmatter after publishing. Subsequent publishes update the existing post.

A progress modal shows upload status and the final result, including a clickable link to the published article (if a wiki-link URL template is configured).

License

MIT

Sponsors