Obsidian / Publish and Substitute

Choose a public service and the role of generation and distribution

Do you need Obsidian Publish?
Compare Quartz and hosting options

This page was machine-translated from Japanese. Read the Japanese original

Choose from the scope of management and the work you can do yourself to make your notes readable on the web. The official description of Publish and the results of actually building Quartz in this environment have been separated and organized.

Entrust hosting or manage the products yourself

Publish is the official hosting service that publishes notes on the web. Quartz is a tool that generates a site from Markdown, and selects the delivery destination of the product separately. GitHub Pages is one of the delivery destinations. When combining Quartz and GitHub Pages, it deals with two roles: generation and delivery.

Select the notes you want to publish and check the Publish conditions if you want to leave the hosting of the site to the service. If you can execute commands, change settings, and manage the delivery destination yourself, try static generation such as Quartz with a small note. If you don't need to publish only the saved notes on the web, decide on the purpose before choosing additional services for publication.

Publish・Quartz・GitHub Pages, the scope of responsibility is different

OptionRoles and what you doConfirmation this time
Obsidian PublishOfficial cloud hosting. Prepare an account and Publish contract, and manage the notes and sites to be published.Check the official Introduction/Set up with a fixed source. Contract, Public actual operation, and actual disclosure have not been carried out.
QuartzA tool that generates sites from Markdown, etc. Handle Node/npm, settings, input files, and products yourself.Fixed commit of v4 branch, actual npm ci local build browser display in package 4.5.2.
GitHub PagesA service that distributes static sites from the repository. Manage the repository, public source, workflow, public/private and plan conditions.Check the official materials from a fixed source. New repository creation, setting, deployment, and actual distribution have not been carried out.

This table is not a ranking that compares all functions. Being able to build with Quartz does not mean the same service features as Publish or successful delivery from GitHub Pages.

Check the fee separately from the contract, delivery destination, and operation

The current amount of Publish has not been reconfirmed in this environment. Please check the latest amount and annual and monthly billing period at Obsidian official fee. From the success of this real build, we did not get the result that Publish would be free.

The fixed Quartz source was a MIT license. This is a condition for the use of the software, and it is not a condition that the cost of distribution destination, original domain, and update work will be uniformly zero. The cost of this execution is also unknown.

The fixed GitHub official document can use Pages in public repositories in GitHub Free and GitHub Free for organizations, and the conditions of Pro/Team/Enterprise support public and private repositories. Check the plan, public coverage, restrictions and terms and conditions of the account you actually choose. I haven't changed my account or hosting settings this time either.

The existing price list is an article that confirmed the official display on September 9, 2026. This time, it will not be treated as an independent confirmation of the current fee, and the latest purchase conditions will be divided into information that requires official confirmation. Sync between Publish and synchronization between terminals is also a separate service.

Check the generation with three small notes and attachments

Instead of the user's storage room, we prepared three fictional Japanese Markdown and one SVG created by the author directly. Frontmatter's title/tags/date, wiki link, and attachment are eligible. The date is a fixed value in the fixture, not the web publication date.

fixture/
  index.md
  手順/確認.md
  参考.md
  assets/fixture-diagram.svg

index → 手順/確認 → 参考 → index

The full text of the entrance file is 340 bytes. This is not a record created by the Obsidian editor.

View the full text of the entrance Markdown
---
title: 著者作成の公開前メモ
tags: [検証]
created: 2026-09-30
modified: 2026-09-30
---

# 著者作成の公開前メモ

これはローカルビルドのための架空の短文です。利用者の記録ではありません。

次は [[手順/確認|確認ノート]] を開きます。

![[assets/fixture-diagram.svg]]

Deploy the fixed source, check the dependencies and settings, and build

  1. I checked the v4 branch of the official Quartz and deployed the source archive of commit d25a6eabf96751ffca56f8a8139272def7a65041 in scratch.
  2. Checked the build process of README, MIT license, package.json, package-lock.json, and CLI. The package version is 4.5.2, and the required version is Node 22 or higher and npm 10.9.2 or higher. The actual environment was Node 24.19.0 and npm 11.9.0.
  3. npm ci was executed with a fixed lockfile. 491 packages are installed and exit 0. The 597 entries of lockfile are records that include dependencies such as compatible OS, and do not mean the same as the number of installation displays. The bytes of the original lockfile have not changed.
  4. I changed my private settings and created it with Quartz CLI for three notes. The following will explain the setting change and the first failure.

The form of the executed command is as follows. The input and output folder in the example specifies the location you have prepared.

npm ci --no-audit --no-fund
node quartz/bootstrap-cli.mjs build   --directory /path/to/fixture   --output /path/to/generated   --concurrency 1

The execution log leaves the absolute path in scratch and the isolated npm cache designation. The path shown here is a replacement for explanation. A command that omits audit does not mean that it has passed a dependent security audit. The article is not a record of the deployment procedure to a public server.

Changed settings in this local example

ItemThis setting and confirmation range
Display and connectionJapanese locale, author-created title, localhost base URL, analytics null, system font that does not use external fonts.
Datefrontmatter/file attribute priority. We use the source archive and do not use the Git history as proof of the date.
Arbitrary OG generationCustomOgImages emitter is disabled. Quartz's unique OG generation has not been verified.
FormulaFor the first time, the standard Latex requested an external KaTeX CSS/JS and was blocked on the environment side. I disabled unused Latex and rebuilt it with the same fixture without a formula.

Both builds exit 0, each 20 file was generated. I leave a record of the initial creation and the failed browser, and check the product after the configuration change in a separate folder. It does not extend to the conclusion that the standard Quartz does not communicate externally or the compatibility of formulas.

Generated HTML, wiki link, actually open attachments

I opened the product on the local server and checked the four widths of 320/390/768/1440 px. I read the title, Japanese text, verification tag, and SVG, and actually clicked on the entrance → confirmation → reference → entrance at each width. It is a limited confirmation of a total of 12 clicks.

Open the generated Quartz entrance with 1440 width, and the actual browser screen where you can see the Japanese text and SVG attachments
Real local display of 1440 width. Check the author's short text and attachment. Open the original image
Link to the Japanese title verification tag confirmation note that opened the Quartz entrance with 390 width and SVG
390 wide real screen. Frontmatter title, tag, text and wiki link. Open the original image
390 wide screen where you can actually open the confirmation note with the wiki link and see the link to the reference note
Confirmation notes after clicking on the wiki link at the entrance. Open the original image
Open the reference note and see the text that it is not the result of publication or synchronization and the link back to the entrance
The actual screen of the reference note. The display position remains the same, and the top is partially cut off. Open the original image

For all eight generated files—three HTML files, one CSS file, two JS files, contentIndex, and an SVG—the bytes and SHA256 of the actual localhost HTTP responses matched the generated originals. The attached SVG also matched its input original. At the four tested viewport widths after the settings change, there was no horizontal overflow and no console, page, or resource error on the tested page.

Graphs and backlink widgets in the image are displayed, but I haven't tried all of their functions. Since the body heading was also written in the fixture, it overlaps with the title of the article on the Quartz side. It is not counted as proof of current fee confirmation, SEO performance, large Vault, and web publication.

Save the four files used for the actual build

The following file is the same bytes as the original actual build input. Keep the relative path of the table and manage the attachments you refer to together with Markdown. The capture on the reader's side and the build of another environment have not been verified.

Relative path in the inputOriginal file
index.mdSave index.md (340 bytes)
手順/確認.mdSave 確認.md (284 bytes)
参考.mdSave 参考.md (256 bytes)
assets/fixture-diagram.svgSave fixture-diagram.svg (502 bytes)

Frequently Asked Questions

Do I need a Publish contract to publish Obsidian notes on the web?
If you want to use Publish, you will need a Obsidian account and a valid Publish contract in the official guide. Another method is to place the site generated from Markdown in Quartz to the distribution destination of your own choice. This time, I checked the local generation of Quartz and did not try the Publish contract or external distribution.
Are Quartz and GitHub Pages the same type of service?
Quartz is a tool that converts Markdown to HTML, CSS, JavaScript, etc., and GitHub Pages is a service that distributes static sites from the repository. It is configured to place products made with Quartz on GitHub Pages, etc. GitHub We have not set up, deployed, or actually distributed to Pages this time.
Where can I check the fees for Publish and alternative methods?
You can check the latest amount and billing period of Publish on the official price page. In this environment, the current fee page cannot be re-acquired, and the current amount has not been confirmed. The fixed source of Quartz was a MIT license, but the delivery destination, domain, and operating costs will be confirmed separately. Please also refer to the official document for the plan conditions for the public and private repositories of GitHub Pages.
Can I judge the compatibility of web publishing and all functions just by checking Quartz this time?
We cannot determine that. For three author-created Markdown files and one SVG, we checked a local build of a pinned commit, four viewport widths, internal links, and generated files. The configuration includes changes such as disabling unused Latex and optional OG image generation. Formulas, large vaults, all Obsidian features, external hosting, synchronization, integration with SimpleMemo, and effects on speed or productivity were not tested.

Fixed source and the range that can be confirmed

The UTC date for actual build and browser confirmation is September 30, 2026, and Japan time is October 1, 2026. The actual version of Node/npm/Quartz, source/lock, setting difference, first failure, and saved original are summarized in verification record. The error in the language expectation of the first browser and the omission due to the overwriting of the failed JSON are also specified.

  • Execution confirmation: Private CLI npm ci and two builds, local four widths, internal links, attachments, HTTP originals after setting changes. The actual Obsidian GUI is not entered.
  • Official description: Publish introduction/setup, Quartz source/docs, GitHub Pages roles and plan conditions are confirmed with a fixed commit.
  • Unconfirmed:Publish Current amount, contract, actual operation, GitHub Pages/Deployment and delivery of other distribution destinations, formulas, optional Quartz OG, full functions, iOS/Sync/SimpleMemo, full environment, speed, productivity, inflow effect.

Source

This site is the developer site of the independent app "SimpleMemo". It is not an official article of Obsidian/Quartz/GitHub, nor is it the result of these contracts or distribution on behalf of you.