#
Publish limitations
Members of our awesome community have devised workarounds for some of these limitations. For more information, please visit our Publish Resources thread on the Obsidian forums.
#
Community plugins
Obsidian Publish has minimal support for Community plugins.
Plugins which output in raw markdown, such as the Waypoint plugin, are compatible with Publish because they do not require the application to render their data.
Whereas a plugin that requires a plugin codeblock to render, such as Dataview or Fantasy Statblocks, will not work by default in Publish.
#
Graph
Publish offers basic color customization for its graph view using CSS. You can modify the node colors in your publish.css file by utilizing the Graph View CSS variables.
Note that the published graph does not support the comprehensive sorting and viewing options available in the application's Graph view.
#
Media files
Obsidian Publish is not optimized for streaming video or large audio files. We include some best practices for handling your media files in these documents.
To improve the experience for your visitors, we recommend that you instead use a video hosting service, such as YouTube or Vimeo.
You can upload files up to 50mb in size to your Publish site.
#
PDFs
On mobile devices, tablets, and computers with small screens, you may encounter issues where an embedded PDF won't load or only the first page is displayed. This is due to limitations with the PDF Renderer on mobile devices.
For content aimed at mobile users, we suggest providing links to PDFs hosted externally or including internal links that allow users to download the PDF directly to their device.
#
Search
Publish has basic support for searching plain text in published content. Preference for search results is given to:
- File names
- Aliases
- Header names
After searching the above for matches, the search will then include plain text of the published notes.
To improve the searchability of your published site, it is recommended to use descriptive file names, incorporate multiple aliases, and select header names that accurately reflect the content.
Additionally, Publish does not currently support the application's embedded search results feature.
See also
Obsidian Publish lets you host notes and various media types, including images and video clips, with a limit of 4 GB per site. For more details,
Obsidian makes it easy to create and edit wikis, knowledge bases, documentation, and other types of websites. It can be used as an editing tool or
Search is a core plugin that helps you find data in your Obsidian vault by using search terms and operators to narrow down results.
In this guide, you'll enable Obsidian Publish for your vault, create a site, and publish your notes to it.
This page details some common problems that you may run into when using Obsidian Publish