Ozeki Markdown Documents

开发者	ozekihiroshi
更新时间	2026年9月10日 13:44
PHP版本:	8.1 及以上
WordPress版本:	7.1
版权:	GPLv2 or later
版权网址:	版权信息

下载

0.1.1

详情介绍:

Ozeki Markdown Documents keeps Markdown as the canonical document source. Rendered HTML is generated output that can be safely rebuilt at any time. Each Markdown document is an independent WordPress object with its own title, status, author, revisions, permalink, and stable numeric ID. A published document can be displayed directly or reused from another post or page with a shortcode. Features include:

A dedicated Markdown document editor.
Side-by-side editing and safe live preview.
Exact UTF-8 .md and .markdown import and export.
WordPress revisions for the canonical Markdown source.
CommonMark and GitHub-Flavored Markdown rendering.
Tables, task lists, fenced code blocks, and strikethrough.
Locally bundled Mermaid diagram rendering.
Locally bundled KaTeX rendering for LaTeX and beginner-friendly AsciiMath.
An explicit Copy LaTeX control without changing mixed-selection copying.
Interactive Markdown, Mermaid, and mathematics example libraries.
Public document permalinks and shortcode reuse.

The rendering pipeline escapes raw HTML, rejects unsafe links, applies the WordPress HTML allow-list, and keeps invalid diagram or formula source visible instead of executing it. Browser libraries are bundled locally; the plugin does not require a CDN or send document content to a third-party service. This plugin does not replace the Gutenberg editor. It provides a separate, portable Markdown document model that can be referenced where needed. Source code and reproducible build instructions are maintained at: https://github.com/ozekihiroshi/ozeki-markdown-documents

安装:

Upload the plugin ZIP from Plugins > Add New > Upload Plugin, or install it from the WordPress Plugin Directory.
Activate Ozeki Markdown Documents.
Open Markdown Documents > Markdown Guide.
Create a blank document or import a UTF-8 .md file.
Publish the document after checking the live preview.

To reuse a published document in a post or page, replace 123 with its ID: [ozeki_markdown_document id="123"]

升级注意事项:

0.1.1 Review fixes for contextual notices and WordPress.org translation delivery. Japanese UI requires a separately available language pack. 0.1.0 First public release.

常见问题:

Is the Markdown source preserved?

Yes. Markdown remains the canonical source. Rendered HTML, diagrams, and formula output are derived and can be regenerated.

Does uninstall delete my documents?

No. Authored Markdown documents, revisions, and associated post metadata are intentionally preserved. Delete documents through WordPress when permanent removal is desired.

Does the plugin load diagram or math libraries from a CDN?

No. Pinned Mermaid, KaTeX, and AsciiMath assets are bundled locally. Pages without diagrams or formulas do not load the corresponding browser assets.

Does the plugin send Markdown or usage data to another service?

No. It contains no telemetry or analytics and does not send document content to an external service. Browser rendering dependencies are served locally.

Is raw HTML supported?

Raw HTML is displayed as escaped text. This is intentional: Markdown remains portable while the rendered result follows a restrictive safety boundary.

Who can create and import Markdown documents?

Users need the standard WordPress capability to edit posts. Export and editing actions also check access to the specific document and use WordPress nonces for state-changing requests.

Is the interface translated?

Interface strings are translation-ready. WordPress.org language packs provide translations when available; this ZIP does not bundle translation catalogs. Japanese translation source remains in the public repository for contribution to translate.wordpress.org. Until a language pack is available, interface text falls back to English. Editable Markdown, Mermaid and formula examples remain portable source code.

Can I import and export normal Markdown files?

Yes. Imports accept UTF-8 .md and .markdown files up to 5 MiB and create a new draft. Export returns only the canonical Markdown source.

How do I write formulas?

Use an inline code span such as asciimath:a/b or math:\frac{a}{b}. For displayed formulas, use an asciimath, math, or latex fenced code block. The Math Examples page provides editable examples.

How do I write Mermaid diagrams?

Use a fenced code block whose language is mermaid. The Mermaid Examples page contains flowchart, sequence, state, class, ER, Gantt, and pie examples.

更新日志: