Review fixes for contextual notices and WordPress.org translation delivery.\nJapanese UI requires a separately available language pack.<\/p>","0.1.0":"
First public release.<\/p>"},"ratings":[],"assets_icons":[],"assets_banners":[],"assets_blueprints":{},"all_blocks":[],"tagged_versions":["0.1.1"],"block_files":[],"assets_screenshots":[],"screenshots":[]},"plugin_section":[],"plugin_tags":[186892,6941,6566,4608,166215],"plugin_category":[],"plugin_contributors":[276902],"plugin_business_model":[],"class_list":["post-365135","plugin","type-plugin","status-publish","hentry","plugin_tags-asciimath","plugin_tags-documentation","plugin_tags-latex","plugin_tags-markdown","plugin_tags-mermaid","plugin_contributors-ozekihiroshi","plugin_committers-ozekihiroshi"],"banners":[],"icons":{"svg":false,"icon":"https:\/\/s.w.org\/plugins\/geopattern-icon\/ozeki-markdown-documents.svg","icon_2x":false,"generated":true},"screenshots":[],"raw_content":"\n
Ozeki Markdown Documents keeps Markdown as the canonical document source.\nRendered HTML is generated output that can be safely rebuilt at any time.<\/p>\n\n
Each Markdown document is an independent WordPress object with its own title,\nstatus, author, revisions, permalink, and stable numeric ID. A published\ndocument can be displayed directly or reused from another post or page with a\nshortcode.<\/p>\n\n
Features include:<\/p>\n\n
.md<\/code> and .markdown<\/code> import and export.<\/li>\n- WordPress revisions for the canonical Markdown source.<\/li>\n
- CommonMark and GitHub-Flavored Markdown rendering.<\/li>\n
- Tables, task lists, fenced code blocks, and strikethrough.<\/li>\n
- Locally bundled Mermaid diagram rendering.<\/li>\n
- Locally bundled KaTeX rendering for LaTeX and beginner-friendly AsciiMath.<\/li>\n
- An explicit Copy LaTeX control without changing mixed-selection copying.<\/li>\n
- Interactive Markdown, Mermaid, and mathematics example libraries.<\/li>\n
- Public document permalinks and shortcode reuse.<\/li>\n<\/ul>\n\n
The rendering pipeline escapes raw HTML, rejects unsafe links, applies the\nWordPress HTML allow-list, and keeps invalid diagram or formula source visible\ninstead of executing it. Browser libraries are bundled locally; the plugin\ndoes not require a CDN or send document content to a third-party service.<\/p>\n\n
This plugin does not replace the Gutenberg editor. It provides a separate,\nportable Markdown document model that can be referenced where needed.<\/p>\n\n
Source code and reproducible build instructions are maintained at:<\/p>\n\n
https:\/\/github.com\/ozekihiroshi\/ozeki-markdown-documents<\/p>\n\n
Quick Start<\/h3>\n\n\n- Open Markdown Documents > Add New Markdown Document.<\/li>\n
- Enter a title and write Markdown in the left pane.<\/li>\n
- Check the safe rendered output in the right pane.<\/li>\n
- Save a draft or publish the document.<\/li>\n
- Use its permalink directly, or embed a published document in another post\nor page with
[ozeki_markdown_document id=\"123\"]<\/code>.<\/li>\n<\/ol>\n\nThe Markdown Guide, Mermaid Examples, and Math Examples pages provide editable\npractice areas. Changes made in a guide are not saved. The explicit create\nbutton creates a new draft and never overwrites an existing document.<\/p>\n\n
Supported Markdown and Extensions<\/h3>\n\n
The server-side renderer supports CommonMark and GitHub-Flavored Markdown,\nincluding headings, lists, links, tables, task lists, fenced code blocks, and\nstrikethrough.<\/p>\n\n
Use a fenced mermaid<\/code> block for diagrams:<\/p>\n\n~~~mermaid\nflowchart LR\n Source[Markdown] --> Preview[Preview]\n~~~\n<\/code><\/pre>\n\nUse a prefixed inline code span or fenced block for formulas:<\/p>\n\n
\n- Inline AsciiMath:
`asciimath:a\/b`<\/code><\/li>\n- Inline LaTeX:
`math:\\frac{a}{b}`<\/code><\/li>\n- Display AsciiMath: an
asciimath<\/code> fenced block<\/li>\n- Display LaTeX: a
math<\/code> or latex<\/code> fenced block<\/li>\n<\/ul>\n\nAsciiMath is converted only for derived display output. The stored Markdown is\nnot rewritten. Hover over or focus a rendered formula to reveal Copy LaTeX.\nCopying a mixed selection of ordinary text and formulas retains normal browser\ncopy behavior.<\/p>\n\n
Security and Privacy<\/h3>\n\n
Raw HTML is escaped. Unsafe link protocols are rejected, and generated HTML is\nfiltered through the WordPress HTML allow-list. Mermaid runs with strict\nsecurity settings and HTML labels disabled. KaTeX runs with trust disabled,\nstrict error handling, and size and expansion limits. Invalid diagrams and\nformulas remain readable as source instead of being executed.<\/p>\n\n
The plugin does not collect telemetry, track users, contact an analytics\nservice, or send document content to a third party. Mermaid, KaTeX, AsciiMath,\nJavaScript, CSS, and fonts are bundled locally; no CDN is required. Ordinary\nWordPress administrators remain responsible for deciding who may edit or view\ntheir site content.<\/p>\n\n
Stored Data and Uninstall<\/h3>\n\n
Documents are stored as the dedicated public ozmd_document<\/code> custom post type. The\ncanonical Markdown source and generated render cache are stored as post meta.\nWordPress revisions preserve the Markdown source. Imported original filenames\nare retained only to suggest an export filename.<\/p>\n\nDeactivation and uninstall intentionally leave documents, revisions, and\nassociated post metadata unchanged. This prevents an accidental plugin removal\nfrom destroying authored content. Delete documents through WordPress when\npermanent removal is desired.<\/p>\n\n
Third-party Libraries<\/h3>\n\n
The release includes League CommonMark under BSD-3-Clause and Mermaid, KaTeX,\nand asciimath-parser under MIT-compatible licenses. License files and\n third-party-notices.txt are included in the plugin. Human-readable integration\nsource, lock files, and reproducible build tools are maintained in the public\nGitHub repository linked above.<\/p>\n\n
Current Scope<\/h3>\n\n
This release uses a dedicated Markdown document editor; Gutenberg is available\nfor placing shortcodes but is not the canonical Markdown editor. The plugin\ndoes not provide cloud synchronization, collaborative editing, Git publishing,\nor remote AI processing. Imported files must be valid UTF-8 .md<\/code> or\n .markdown files no larger than 5 MiB.<\/p>\n\n\n\n- Upload the plugin ZIP from Plugins > Add New > Upload Plugin, or install it from the WordPress Plugin Directory.<\/li>\n
- Activate Ozeki Markdown Documents.<\/li>\n
- Open Markdown Documents > Markdown Guide.<\/li>\n
- Create a blank document or import a UTF-8
.md<\/code> file.<\/li>\n- Publish the document after checking the live preview.<\/li>\n<\/ol>\n\n
To reuse a published document in a post or page, replace 123<\/code> with its ID:<\/p>\n\n[ozeki_markdown_document id=\"123\"]\n<\/code><\/pre>\n\n\n\nIs the Markdown source preserved?<\/h3><\/dt>\nYes. Markdown remains the canonical source. Rendered HTML, diagrams, and\nformula output are derived and can be regenerated.<\/p><\/dd>\n
Does uninstall delete my documents?<\/h3><\/dt>\nNo. Authored Markdown documents, revisions, and associated post metadata are\nintentionally preserved. Delete documents through WordPress when permanent\nremoval is desired.<\/p><\/dd>\n
Does the plugin load diagram or math libraries from a CDN?<\/h3><\/dt>\nNo. Pinned Mermaid, KaTeX, and AsciiMath assets are bundled locally. Pages\nwithout diagrams or formulas do not load the corresponding browser assets.<\/p><\/dd>\n
Does the plugin send Markdown or usage data to another service?<\/h3><\/dt>\nNo. It contains no telemetry or analytics and does not send document content\nto an external service. Browser rendering dependencies are served locally.<\/p><\/dd>\n
Is raw HTML supported?<\/h3><\/dt>\nRaw HTML is displayed as escaped text. This is intentional: Markdown remains\nportable while the rendered result follows a restrictive safety boundary.<\/p><\/dd>\n
Who can create and import Markdown documents?<\/h3><\/dt>\nUsers need the standard WordPress capability to edit posts. Export and editing\nactions also check access to the specific document and use WordPress nonces for\nstate-changing requests.<\/p><\/dd>\n
Is the interface translated?<\/h3><\/dt>\nInterface strings are translation-ready. WordPress.org language packs provide\ntranslations when available; this ZIP does not bundle translation catalogs.\nJapanese translation source remains in the public repository for contribution\nto translate.wordpress.org. Until a language pack is available, interface text\nfalls back to English. Editable Markdown, Mermaid and formula examples remain\nportable source code.<\/p><\/dd>\n
Can I import and export normal Markdown files?<\/h3><\/dt>\nYes. Imports accept UTF-8 .md<\/code> and .markdown<\/code> files up to 5 MiB and create a\nnew draft. Export returns only the canonical Markdown source.<\/p><\/dd>\nHow do I write formulas?<\/h3><\/dt>\nUse an inline code span such as asciimath:a\/b<\/code> or\n math:\\frac{a}{b}. For displayed formulas, use an asciimath<\/code>, math<\/code>, or\n latex fenced code block. The Math Examples page provides editable examples.<\/p><\/dd>\nHow do I write Mermaid diagrams?<\/h3><\/dt>\nUse a fenced code block whose language is mermaid<\/code>. The Mermaid Examples page\ncontains flowchart, sequence, state, class, ER, Gantt, and pie examples.<\/p><\/dd>\n\n<\/dl>\n\n\n0.1.1<\/h4>\n\n\n- Limit document operation notices to Markdown document screens.<\/li>\n
- Limit missing-dependency guidance to the Plugins screen.<\/li>\n
- Use WordPress.org language packs instead of bundled translation loading.<\/li>\n<\/ul>\n\n
0.1.0<\/h4>\n\n\n- First public release.<\/li>\n
- Added canonical Markdown documents, revisions, import\/export, permalinks, and shortcode reuse.<\/li>\n
- Added safe side-by-side live preview with CommonMark and GitHub-Flavored Markdown.<\/li>\n
- Added locally bundled Mermaid, LaTeX, and AsciiMath rendering.<\/li>\n
- Added interactive Markdown, Mermaid, and mathematics guides.<\/li>\n<\/ul>","raw_excerpt":"Manage Markdown as reusable WordPress documents with live preview, import\/export, Mermaid diagrams, and LaTeX or AsciiMath formulas.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/uz.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/365135","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/uz.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/uz.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/uz.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=365135"}],"author":[{"embeddable":true,"href":"https:\/\/uz.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/ozekihiroshi"}],"wp:attachment":[{"href":"https:\/\/uz.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=365135"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/uz.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=365135"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/uz.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=365135"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/uz.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=365135"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/uz.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=365135"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/uz.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=365135"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}