[WordPress] 外掛分享： External Markdown

前言介紹

  • 這款 WordPress 外掛「External Markdown」是 2021-02-04 上架。
  • 目前有 100 個安裝啟用數。
  • 上一次更新是 2023-08-29，距離現在已有 614 天。超過一年沒更新，安裝要確認版本是否可用。以及後續維護問題！
  • 外掛最低要求 WordPress 4.7 以上版本才可以安裝。
  • 外掛要求網站主機運作至少需要 PHP 版本 7.0 以上。
  • 有 2 人給過評分。
  • 還沒有人在論壇上發問，可能目前使用數不多，還沒有什麼大問題。

外掛協作開發者

preya |

外掛標籤

Github | gitlab | markdown |

內容簡介

這是一個 WordPress 外掛，可使用短碼 [external_markdown] 從外部網站（例如 GitHub、GitLab 等）嵌入 Markdown 文件到 WordPress 內容中。可能的使用情況是在 WordPress 網站上顯示單一事實來源（如 GitHub 存儲庫）的內容。

功能特色

內嵌其他網站上任何公開可訪問的 Markdown 檔案
使用公共且免費的 GitHub API將 Markdown 轉換為 HTML（有負載限制，所以不要過度使用）
支援快取（可以設置從源頭獲取檔案的頻率，預設是每小時一次）
可自定 Markdown 容器的 CSS 類別以調整樣式

使用說明 / 範例

下載並解壓縮或複製此存儲庫到您的 wp-content/plugins 文件夾中，使 PHP 檔案位於 wp-content/plugins/external-markdown/external-markdown.php。

如果您使用 Guttenberg 編輯器，首先需要添加「短碼」塊。如果您使用傳統編輯器，可以立即使用短碼。

簡單內嵌

url 參數接受您希望嵌入的 Markdown 檔案的 URL。在使用 GitHub、GitLab 等時，請確保使用原始的 URL。
[external_markdown url="https://raw.githubusercontent.com/pReya/wordpress-external-markdown/main/README.md"]

調整快取持續時間

ttl 參數控制使用快取版本的持續時間，直到再次獲取。值以秒為單位。因此，24 小時（24* 60 *60）的值為 86400。
[external_markdown ttl=86400 url="https://raw.githubusercontent.com/pReya/wordpress-external-markdown/main/README.md"]

調整容器 CSS 類別

class 參數接受您希望設置的外部 Markdown 容器的類別名稱。容器的預設類別名稱為 class='external-markdown'。
[external_markdown class="my-classname" url="https://raw.githubusercontent.com/pReya/wordpress-external-markdown/main/README.md"]

使用 GitHub、GitLab 等時注意

在嵌入來自 GitHub 或 GitLab 等 Git 托管服務的內容時，您需要確保使用正確的原始 Markdown URL。您可以在網頁檢視的右上角找到此 URL。

來源

本外掛受到偉大的 wordpress-markdown-git 外掛的啟發，後者有類似的功能，但使用 Git 提供者 API 擷取原始 Markdown 檔案- 比這個方法稍微複雜一些。

原文外掛簡介

This is a plugin for WordPress to embed Markdown files from external web sources (e.g. GitHub, GitLab, etc) into WordPress content using the shortcode [external_markdown]. A possible use case for this is to show content from a single source of truth (like a GitHub repository) on your WordPress website.
Features

Embed any publicly accessible markdown file from other websites
Uses the public and free GitHub API to transform Markdown to HTML (there is a rate limit – so don’t overdo it)
Caching support (so you can configure how often the file is being fetched from the source – default is a once per hour maximum)
Customise the CSS class of the markdown container to adjust styles

Instructions / Examples
Download and unpack or clone this repository into your wp-content/plugins folder, so the PHP file resides in wp-content/plugins/external-markdown/external-markdown.php.
If you use the Guttenberg editor, you need to add a “Shortcode” block first. If your’re using the classic editor, you can use the shortcode right away.
Simple embed
The url parameter takes the URL to the Markdown file you want to embed. Make sure to use the “raw” URL when you use GitHub, GitLab, etc.
[external_markdown url="https://raw.githubusercontent.com/pReya/wordpress-external-markdown/main/README.md"]
Adjust caching duration
The ttl parameter controls how long the cached version is used, before it’s fetched again. The value is given in seconds. So 24 hours (24* 60 *60) result in a value of 86400.
[external_markdown ttl=86400 url="https://raw.githubusercontent.com/pReya/wordpress-external-markdown/main/README.md"]
Adjust container CSS class
The class parameter takes your desired class name for the external markdown container. The default class name for the container is class='external-markdown'.
[external_markdown class="my-classname" url="https://raw.githubusercontent.com/pReya/wordpress-external-markdown/main/README.md"]
Attention when using GitHub, GitLab, etc.
When embedding content from Git hosting services like GitHub or GitLab, you need to make sure to use the proper “raw” markdown URL. You can find this URL in the upper right corner of the web view.
Attribution

This plugin was inspired by the great wordpress-markdown-git plugin, which serves a similar purpose, but uses the Git provider APIs to fetch the raw Markdown files – which is a little more complicated than this approach here.

各版本下載點

  • 方法一：點下方版本號的連結下載 ZIP 檔案後，登入網站後台左側選單「外掛」的「安裝外掛」，然後選擇上方的「上傳外掛」，把下載回去的 ZIP 外掛打包檔案上傳上去安裝與啟用。
  • 方法二：透過「安裝外掛」的畫面右方搜尋功能，搜尋外掛名稱「External Markdown」來進行安裝。

（建議使用方法二，確保安裝的版本符合當前運作的 WordPress 環境。

0.0.1 | trunk |

延伸相關外掛（你可能也想知道）

  • WP Githuber MD – WordPress Markdown Editor 》一個全方位的 WordPress Markdown 外掛程式，提供多種功能，包括 Markdown 編輯器、即時預覽、圖片貼上、HTML 到 Markdown 換算工具等等。, 如需詳細資訊，請...。
  • Import Markdown – Versatile Markdown Importer 》Import Markdown 讓您輕鬆地基於 Markdown 檔案生成文章。, Ultimate Markdown, 我們也運行一個WordPress外掛，將Markdown整合進區塊編輯器中。如需更多信息...。
  • WP Mermaid 》使用mermaid.js，以類似 Markdown 的方式從文本生成圖表和流程圖。, WP Mermaid 足夠智能，只會在文章中包含 Mermaid 語法的時候加載 mermaid.js，通過檢測短...。
  • WP-Markdown 》這個外掛允許您使用 Markdown 語法來撰寫任何文章類型的文章。在儲存文章之前，外掛會將 Markdown 轉換為 HTML。編輯文章時，外掛會將其轉換回 Markdown 語法...。
  • WP Editor.md – The Perfect WordPress Markdown Editor 》WP Editor.md是一款美觀且實用的Markdown文件編輯器。, 使用Editor.md提供WordPress支持。, 此外掛使用WordPress Jetpack中的Markdown模組進行內容的解析和保...。
  • Ultimate Markdown – Markdown Editor, Importer, & Exporter 》Ultimate Markdown 是一個 WordPress 外掛，可以讓您使用流行的 Markdown 語法來創建 WordPress 文章。, 安裝這個外掛後，您可以：, , 從現有的 Markdown 檔...。
  • WP Markdown Editor (Formerly Dark Mode) 》如果你想在 WordPress 快速編輯內容，而不用考慮區塊，那麼 WP Markdown Editor 就是您的完美選擇！使用最酷的編輯器－WP Markdown Editor，獲取身臨其境、寧...。
  • Markup Markdown 》這個外掛可以在編輯頁面上將 Gutenberg 區塊編輯器（或經典的 TinyMCE 編輯器）替換為基於 CodeMirror 的 Markdown 編輯器 EasyMDE。, 內容以 Markdown 語法...。
  • Markdown Comment Block 》只顯示於區塊編輯器的評論, 我喜歡在 Ulysses 本地或使用 我的部落格 的 Iceberg 編輯器 草擬文章。雖然我很喜歡 Iceberg，但當我發布一篇文章時，我通常會切...。
  • Todo List Block 》易於編輯的區塊, 在進行這個項目時，我探索了一些可以改善個人發布流程的地方。其中一個地方是使用我的Markdown Comment區塊，將編輯者的評論帶入Gutenberg之...。
  • Markdown Editor 》Markdown Editor會將預設的WordPress編輯器替換為一個Markdown編輯器，供您在文章和頁面中使用。此外，該外掛使用Jetpack Markdown模組將Markdown轉換為HTML...。
  • Documents from Git 》官方文件: https://github.com/gis-ops/wordpress-markdown-git, 這個WordPress外掛讓您能夠輕鬆地從您最喜愛的遠端Git平台上發布、協作和版本控制您的[...。
  • Git it Write – Write posts from GitHub 》Git it Write允許將存儲在Github存儲庫中的markdown文件發布到您的WordPress網站中。因此，使用此外掛程序，當存儲庫中添加、更新文件時，WordPress文章將相...。
  • WP Gatsby Markdown Exporter 》這個外掛可以建立包含已轉換為 Markdown 格式的文章的 zip 檔案。此外，還可以使用 WP-CLI 命令進行網站的大量內容匯出。其他的功能包括：, , - 將 WordPress...。
  • Mytory Markdown 》ugin allows you to convert Markdown files to HTML and display them in your post content. You can provide a URL for the Markdown file, like a GitHub...。

文章
Filter
Apply Filters
Close
Mastodon