一日一技:如何正確渲染大模型返回的Markdown?

2025年06月08日18:32:03 科技 1739

一日一技:如何正確渲染大模型返回的Markdown? - 天天要聞

我們經常讓大模型返回markdown格式的文本,然後通過Pythonmarkdown庫把文本渲染成HTML

但不知道大家有沒有發現,大模型返回的Markdown並不是標準的Markdown。特別是當返回的內容包含列表時,大模型返回的內容有問題。例如下面這段文本:

**關於這個問題,我有以下看法**
* 第一點
* 第二點
* 第三點

你粗看起來沒有問題,但當你使用markdown模塊去把它渲染成HTML時,你會發現渲染出來的結果不符合你的預期,如下圖所示:

一日一技:如何正確渲染大模型返回的Markdown? - 天天要聞

這是因為標準的Markdown對換行非常敏感,列表項與它上面的文本之間,必須有一個空行,才能正確解析,如下圖所示:

一日一技:如何正確渲染大模型返回的Markdown? - 天天要聞

不僅是空行,還有多級列表的縮進問題。標準Markdown的子列表項縮進應該是4個空格,但大模型返回的子列表縮進經常只有3個空格,這就導致解析依然有問題。如下圖所示:

一日一技:如何正確渲染大模型返回的Markdown? - 天天要聞

而且這個空行問題和縮進問題,我嘗試過反覆在Prompt裡面強調,但大模型依然會我行我素,無論是國產大模型還是Claude或者Gemini 2.5 Pro這些最新大模型,都有這個問題。

我曾經一度被憋得沒辦法,讓大模型給我返回JSON,我再寫代碼把JSON解析出來手動拼接成標準Markdown。

後來,我發現主要的問題還是Python的markdown庫對格式要求太嚴格了,其實換一個更寬容的庫就可以解決問題。於是我找到了mistune這個庫。使用它,直接就解決了所有問題。如下圖所示:

一日一技:如何正確渲染大模型返回的Markdown? - 天天要聞

mistune的用法非常簡單:

import mistune

html = mistune.html('一段markdown')

並且它天然支持數學公式、腳註等等高級語法。更多高級操作,可以查看它的官方文檔[1]。

參考文獻

[1] 官方文檔: https://mistune.lepture.com/en/latest/guide.html

科技分類資訊推薦

差價6萬多,小鵬G7為什麼還要對比特斯拉Model Y? - 天天要聞

差價6萬多,小鵬G7為什麼還要對比特斯拉Model Y?

小鵬G7正式上市了,售價19.58-22.58萬元,相比預售時公布的23.58萬元要低了不少。當小米YU7在6月底以25.35萬元起的價格狂攬3分鐘20萬台大定訂單時,恐怕很多人都會想,小鵬G7相比特斯拉Model Y和小米YU7才便宜兩三萬,這怎麼打得過別人
自改好還是官改好?  上汽大眾重磅推出改裝新生態 - 天天要聞

自改好還是官改好? 上汽大眾重磅推出改裝新生態

隨著國家汽車改裝政策的鬆綁、改裝文化的興起,汽車定製市場開始步入爆發窗口期。而在改裝新規的「靴子」落地之前,上汽大眾已經率先推出了改裝新生態:自2022年起,上汽大眾已經開始陸續為全系產品打造個性化改裝及配附件選購服務,當前,上汽大眾超級APP上正式推出專門設
領克10 EM-P全球首秀!標配四驅+激光雷達樹新標 - 天天要聞

領克10 EM-P全球首秀!標配四驅+激光雷達樹新標

2025年7月4日,在新能源市場「價格戰」白熱化的當下,領克只卷價值,卷技術,卷產品。在此背景下,領克首款中大型豪華運動轎車——領克10 EM-P迎來首秀亮相。新車定位「智能電混四驅轎車」,標配四驅和激光雷達,首次將高端配置一同下放至20萬級主流汽車市場。這種
小米深圳國際總部開始入駐:上班也能看海景,開 1000 平小米之家 - 天天要聞

小米深圳國際總部開始入駐:上班也能看海景,開 1000 平小米之家

IT之家 7 月 7 日消息,小米員工 @筍寸 今日發文稱透露小米深圳國際總部已經開始入駐,新家官方名字為「深圳小米大廈」。從其曬出的圖片來看,小米深圳國際總部毗鄰海邊,窗外有大面積的綠化並且還有海景可以觀看。深圳小米大廈地下 1 層為公司食堂,1 到 2 層為小米之家,3 層為會議室,4 層為手機實驗室,5 層為空中花園...
重磅!財務BP獨家解讀天貓1月經營報告:這些信號,不容錯過! - 天天要聞

重磅!財務BP獨家解讀天貓1月經營報告:這些信號,不容錯過!

年中到了,不少企業都在忙著總結上半年、規划下半年。但很多老闆和團隊負責人跟我吐槽:看著經營分析報告里一堆數字,頭都大了,卻根本看不出問題出在哪兒!別慌,今天我就用一份真實的天貓平台1月經營分析報告當例子,手把手教你做真正有用的經營分析。
iPhone 17 Pro和Pro Max區別曝光:續航差距可能不小 - 天天要聞

iPhone 17 Pro和Pro Max區別曝光:續航差距可能不小

【CNMO科技消息】按照慣例,蘋果將於今年9月發布iPhone 17系列,除了Air機型替代Plus機型外,Pro與Pro Max機型也可能出現更顯著的差異。CNMO從外媒獲悉,iPhone 17 Pro Max機型將繼續保持更大尺寸:iPhone 17 Pro配備6.3英寸屏幕,Pro Max則為6.9英寸。更大的機身空間使其能容納更大容量電池,續航優勢將
OPPO Find N6曝光:2026年Q1首發驍龍8 Elite 2,再度定義最薄摺疊旗艦 - 天天要聞

OPPO Find N6曝光:2026年Q1首發驍龍8 Elite 2,再度定義最薄摺疊旗艦

7月7日消息,知名數碼博主@數碼閑聊站 近日爆料,OPPO下一代摺疊旗艦Find N6已在緊鑼密鼓研發中,計劃於2026年第一季度正式亮相。新機將繼續堅持「輕薄全能大摺疊」定位,搭載高通尚未發布的旗艦平台驍龍8 Elite 2,並延續OPPO在摺疊屏晶元平台的獨佔優勢。這將是OPPO摺疊旗艦第二次獲得高通頂級平台的獨佔期。今年2月推出...
強腦科技與喜臨門合作推出腦電感應AI產品 - 天天要聞

強腦科技與喜臨門合作推出腦電感應AI產品

央廣網北京7月7日消息(記者 鄒煦晨)近日,「杭州六小龍」之一的強腦科技(BrainCo)與我國床墊行業首家上市公司喜臨門(603008.SH)在浙江紹興簽署獨家戰略合作協議,並發布一款整合腦電監測技術的智能床墊產品「寶褓BrainCo」。