Title: Markdown Comment Block Author: Rich Tabor Published: 2021 年 6 月 25 日 Last modified: 2024 年 7 月 14 日 --- 搜尋外掛 ![](https://ps.w.org/markdown-comment-block/assets/banner-772x250.png?rev=3117642) 這個外掛**並未在最新的 3 個 WordPress 主要版本上進行測試**。開發者可能不再對這個 外掛進行維護或提供技術支援，並可能會與更新版本的 WordPress 產生使用上的相容性問題。 ![](https://ps.w.org/markdown-comment-block/assets/icon-256x256.png?rev=3117642) # Markdown Comment Block 由 [Rich Tabor](https://profiles.wordpress.org/richtabor/) 開發 [下載](https://downloads.wordpress.org/plugin/markdown-comment-block.1.0.0.zip) * [詳細資料](https://tw.wordpress.org/plugins/markdown-comment-block/#description) * [使用者評論](https://tw.wordpress.org/plugins/markdown-comment-block/#reviews) * [安裝方式](https://tw.wordpress.org/plugins/markdown-comment-block/#installation) * [開發資訊](https://tw.wordpress.org/plugins/markdown-comment-block/#developers) [技術支援](https://wordpress.org/support/plugin/markdown-comment-block/) ## 外掛說明 ### Comments that only render in the block editor I honestly enjoy drafting articles either locally in Ulysses, or on [my blog](https://richtabor.com) using the [Iceberg Editor](https://useiceberg.com/?utm_source=wp-org&utm_medium=markdown-comment-block&utm_campaign=readme-description). While I do love Iceberg, once I publish an article I typically bring back the default Gutenberg experience — thus removing any comments I previously added. Having the ability to add, and keep, any relevant editing comments within my posts, without rendering them on the front-end, means that I am freed up to mentally jot any idea down without thinking about it. It is simply natural and convenient. [Learn more about Markdown Comment →](https://richtabor.com/markdown-comments/?utm_source=wp-org&utm_medium=markdown-comment-block&utm_campaign=readme-learnmore) ### What’s interesting about Markdown Comment: #### 1. Editor only The block only renders within the editor. For developers reading this, that means there’s no save function. I don’t want my unfinished ideas, reminders, and notes rendered within my post – even if they’re hidden by CSS. #### 2. Helpful block transforms I added a couple transforms, to and from headings and paragraphs, and a raw shortcut when you type `%%` and hit the [space] key. This lets me quickly add comments, and even convert whole paragraphs or headings to a comment. #### 3. Easily resolve comments To support that path towards simplicity, I wanted a method to quickly resolve — i.e. banish — a comment entirely. So, I added a toolbar control to quickly resolve the comment, removing the block entirely. #### 4. No rich text support Comments need to have minimal impact on editing, and feel as natural as possible. That’s why there are no typical RichText controls (although you can still bold, italicize and add hyperlinks). And while you _can_ change the color of the comment— there are no other typographic controls. #### 5. Entirely CSS Variable ready Global styles and full site editing are opening the door for themes to be heavily powered by CSS variables. Blocks should be designed with that same mentality, which is exactly what I did here. I added simple CSS variables with fallbacks that are the default values. To further theme the comment, there’s no need to override any styles with classes, just write a few CSS variables. ## 螢幕擷圖 * [[ * Quickly resolve comments from the block toolbar. * [[ * Installable via the WordPress Block Directory. ## 適用於區塊編輯器 這個外掛提供 1 個可供 Gutenberg/區塊編輯器使用的區塊。 * Markdown Comment Add a comment that does not render on the front-end. ## 安裝方式 1. Upload the `markdown-comment-block` folder to your `/wp-content/plugins/` directory or alternatively upload the markdown-comment-block.zip file via the plugin page of WordPress by clicking ‘Add New’ and selecting the zip from your local computer. 2. Activate the plugin through the ‘Plugins’ menu in WordPress. 3. Search for the block within the Gutenberg block editor. ## 常見問題集 ### Can the Markdown Comment block be used with my theme? Yes! If you’re using Gutenberg (i.e. the block editor) on your site, you should have no issues with the block. It’s relatively simple to modify the CSS variables to tweak the comment styling if you’d like — learn more [here](https://richtabor.com/markdown-comments/?utm_source=wp-org&utm_medium=markdown-comment-block&utm_campaign=readme-faq). ### Where can I send feedback or ideas? Please reach out via the official [plugin support forum](https://wordpress.org/support/plugin/markdown-comment-block). ### Who’s Rich Tabor? As a WordPress entrepreneur, designer and developer all wrapped up in one, [@richard_tabor](http://twitter.com/richard_tabor) is recognized as one of the top leaders in this post-Gutenberg era of WordPress. His design chops have topped the 2018 Automattic Design Awards and led him to found CoBlocks – a top-notch set of page builder blocks and tools for Gutenberg, ThemeBeans– a premier WordPress theme shop and [Iceberg](https://useiceberg.com/?utm_source=wp-org&utm_medium=markdown-comment-block&utm_campaign=readme-faq)– a markdown editor for Gutenberg. ## 使用者評論 ![](https://secure.gravatar.com/avatar/8a9bdcebe282e77a72a9ac3ac445864ecd07d696523d4058bd8005b8a155afc0? s=60&d=retro&r=g) ### 󠀁[Very useful for editorial flow](https://wordpress.org/support/topic/very-useful-for-editorial-flow/)󠁿 [Lightend](https://profiles.wordpress.org/lightend/) 2022 年 7 月 15 日 I have found the best use of this comment block. I create drafts and reusable blocks containing comments for the writers, and they can publish posts without any need to delete the comments. [ 閱讀全部 1 則使用者評論 ](https://wordpress.org/support/plugin/markdown-comment-block/reviews/) ## 參與者及開發者 以下人員參與了開源軟體〈Markdown Comment Block〉的開發相關工作。 參與者 * [ Rich Tabor ](https://profiles.wordpress.org/richtabor/) 〈Markdown Comment Block〉外掛目前已有 2 個本地化語言版本。 感謝[全部譯者](https://translate.wordpress.org/projects/wp-plugins/markdown-comment-block/contributors) 為這個外掛做出的貢獻。 [將〈Markdown Comment Block〉外掛本地化為台灣繁體中文版](https://translate.wordpress.org/projects/wp-plugins/markdown-comment-block) ### 對開發相關資訊感興趣？ 任何人均可[瀏覽程式碼](https://plugins.trac.wordpress.org/browser/markdown-comment-block/)、 查看 [SVN 存放庫](https://plugins.svn.wordpress.org/markdown-comment-block/)，或 透過 [RSS](https://plugins.trac.wordpress.org/log/markdown-comment-block/?limit=100&mode=stop_on_copy&format=rss) 訂閱[開發記錄](https://plugins.trac.wordpress.org/log/markdown-comment-block/)。 ## 變更記錄 #### 1.0.0 * Set default control for text color #### 0.1.8 * Add block.json to registerBlockType #### 0.1.7 * WordPress 5.9 support * Ensure text color is properly applied #### 0.1.6 * Resolve package error #### 0.1.5 * Improve styling to work with theme.json * Add example theme.json file for themes to leverage #### 0.1.3 * Tweak block title * Tweak styles #### 0.1.0 * Initial release ## 中繼資料 * 版本 **1.0.0** * 最後更新 **2 年前** * 啟用安裝數 **300+** * WordPress 版本需求 ** 5.7 或更新版本 ** * 已測試相容的 WordPress 版本 **6.6.5** * PHP 版本需求 ** 7.0 或更新版本 ** * 語言 * [English (US)](https://wordpress.org/plugins/markdown-comment-block/)、[German](https://de.wordpress.org/plugins/markdown-comment-block/)、 及 [Vietnamese](https://vi.wordpress.org/plugins/markdown-comment-block/). * [將這個外掛本地化為你的母語版本](https://translate.wordpress.org/projects/wp-plugins/markdown-comment-block) * 標籤: * [block](https://tw.wordpress.org/plugins/tags/block/)[blocks](https://tw.wordpress.org/plugins/tags/blocks/) [comments](https://tw.wordpress.org/plugins/tags/comments/)[gutenberg](https://tw.wordpress.org/plugins/tags/gutenberg/) [markdown](https://tw.wordpress.org/plugins/tags/markdown/) * [進階檢視](https://tw.wordpress.org/plugins/markdown-comment-block/advanced/) ## 評分 5 星，滿分為 5 星 * [ 1 個 5 星使用者評論 ](https://wordpress.org/support/plugin/markdown-comment-block/reviews/?filter=5) * [ 0 個 4 星使用者評論 ](https://wordpress.org/support/plugin/markdown-comment-block/reviews/?filter=4) * [ 0 個 3 星使用者評論 ](https://wordpress.org/support/plugin/markdown-comment-block/reviews/?filter=3) * [ 0 個 2 星使用者評論 ](https://wordpress.org/support/plugin/markdown-comment-block/reviews/?filter=2) * [ 0 個 1 星使用者評論 ](https://wordpress.org/support/plugin/markdown-comment-block/reviews/?filter=1) [Your review](https://wordpress.org/support/plugin/markdown-comment-block/reviews/#new-post) [查看全部使用者評論](https://wordpress.org/support/plugin/markdown-comment-block/reviews/) ## 參與者 * [ Rich Tabor ](https://profiles.wordpress.org/richtabor/) ## 技術支援 使用者可在技術支援論壇提出意見反應或使用問題。 [檢視技術支援論壇](https://wordpress.org/support/plugin/markdown-comment-block/)