內容簡介
Bristlecone Markdown 讓使用者能夠在 WordPress 中以 Markdown 格式撰寫內容，並保留原始碼以便日後編輯。此外掛是 Jetpack Markdown 功能的獨立替代方案，並與 iA Writer 的語法相容。
【主要功能】
• 支援區塊編輯器的 Markdown 區塊
• 經典編輯器的整篇 Markdown 撰寫
• 支援註解的 Markdown 格式
• 兼容 Jetpack Markdown，避免重複處理
• 支援 YAML 前置資料和數學公式
外掛標籤
開發者團隊
原文外掛簡介
Bristlecone Markdown lets you write WordPress content in Markdown and keep the source for later edits. It is a self-contained replacement for Jetpack’s Markdown features, and its syntax is aligned with iA Writer (Markdown support only, not the rest of the iA Writer app).
The plugin is developed by Bristlecone IT Services. Plugin homepage: bristleconeit.com/bristlecone-markdown. Source and issues are on GitHub.
Writing surfaces
Markdown block in the block editor, with source and preview tabs
Whole-document Markdown for the Classic Editor, the REST API, and iA Writer’s Publish command
Comment Markdown, enabled separately
HTML is stored in post_content (and in the block’s saved markup). The Markdown source is kept in post_content_filtered for document-mode posts, so the site still displays if you deactivate the plugin.
Syntax
CommonMark plus:
Strikethrough ~~text~~
Highlight ==text==
Tables
Footnotes [^1] and iA Writer inline footnotes [^this is the note.]
Heading permalinks and cross-references ([Heading][], optional {#id} / [Label] on headings)
Table of contents placeholder {{TOC}}
YAML front matter and [%key] interpolation
$inline$ and $$block$$ math (KaTeX, loaded only when needed)
Superscript ^2 / y^(a+b)^ and subscript x~z
Page break +++
Unpublished // comments (stripped from output)
MultiMarkdown-style citations [p. 23][#CiteKey]
Safe inline HTML
Fenced code blocks can be highlighted on the server (no extra JavaScript). Theme developers can override .hljs or dequeue bristlecone-markdown-highlight.
Jetpack Markdown
If Jetpack Markdown is still active, Bristlecone Markdown does not convert posts or comments, so content is not processed twice. An admin notice offers a one-click control to disable the Jetpack Markdown module. Existing Jetpack Markdown posts (_wpcom_markdown and post_content_filtered) are adopted automatically afterward.
iA Writer
In iA Writer you can publish drafts to WordPress 5.6+ over the REST API as Markdown. Bristlecone Markdown converts that body on save and returns Markdown source to non-Gutenberg clients on edit.
YAML keys such as title, excerpt, tags, categories, and slug are mapped onto the WordPress post when present. If title is applied to an auto-draft and slug is omitted, the permalink is generated from the title. Other keys are stored and available for [%key] interpolation.
Intentionally not converted
Task lists (- [ ]) — local writing aid; skip on publish
Content Blocks / file transclusion — these depend on iA Writer’s local library. WordPress cannot see that library. Compile or export the transcluded document in iA Writer before publishing.
Footnotes
Footnote IDs are namespaced with the post ID (bristlecone-markdown-fn-{id}-…) so archives and the core Footnotes block are less likely to clash. New posts are converted again after insert so those IDs are not left as a placeholder. Footnote markup can still be sensitive to theme CSS and to wpautop on classic (non-block) content; we disable wpautop for document-mode Markdown posts. If a theme styles sup unusually, footnotes may need a CSS tweak. Footnote lists still render on archive views for each post that contains them.
![Disable Comments – Remove Comments & Stop Spam [Multi-Site Support]](https://ps.w.org/disable-comments/assets/icon-256x256.png?rev=2509854){kind=icon}
