<h2> 目錄 </h2>
注:這個目錄有點問題,正在找原因。。。
<h2 id = '1.1'> 背景 </h2>
前天作為一名未來的ThoughtWorker參加了ThoughtWorks的大講堂,了解了許多關(guān)于日后所要工作的公司的文化、技術(shù)以及價值觀。怎么說呢,感覺好像突然明白了“路漫漫其修遠兮 吾將上下而求索”的感覺。公司文化中的處處都能讓人感受到對于技術(shù)應(yīng)用的自由、對于新鮮事物的渴望以及對于社會公正的使命感。而我,作為一個新人而言,目前能做的,也就是從簡單開始,一步一步學(xué)習(xí),一點一點積累,向著一個合格的ThoughtWorker成長。
大講堂的最后,小buddy見面會上,我見到自己的專屬buddy小日子先生ray,一個感覺挺暖的哥們。也就是從他這里,我第一次了解到Markdown標(biāo)記語言,聽說了Markdown對于寫博客、寫論文都有所幫助后,我立刻決定將學(xué)習(xí)它作為我的第一個學(xué)習(xí)任務(wù)。下面,就要進入正題啦。
<h2 id = '1.2' > 標(biāo)記語言MarkDown </h2>
在我看來,MarkDown就是一種為了方便用戶在博客、評論等網(wǎng)絡(luò)書寫區(qū)里快速排板而產(chǎn)生的文本標(biāo)記語言。它將一些特殊的符號和一些規(guī)則與HTML中的標(biāo)簽相對應(yīng),這樣經(jīng)過MarkDown編輯的文本在瀏覽器上顯示出來的時候,就不單單是簡單的text文本,而是將文本放入對應(yīng)的HTML區(qū)塊元素中,以便實現(xiàn)一些作者想要的效果,再通過瀏覽器顯示出來。
關(guān)于Markdown常用語法,我的同期TW安洋寫的Markdown學(xué)習(xí)筆記里總結(jié)得很是圖文并茂,易于入門。
但我在學(xué)習(xí)過程中,發(fā)現(xiàn)MarkDown中沒有可以生成目錄索引的功能,這個讓人很是郁悶。因此,接下來我要嘗試一下如何能夠利用MarkDown生成目錄索引。
<h2 id = '1.3'> 利用Markdown生成目錄索引 </h2>
MarkDown生成目錄時,主要有兩種方式,一種是需要其他擴展包的方式,具體方法見MarkDown生成目錄索引,因為這種方式需要安裝一些其他插件拓展MarkDown功能,而我目前還是剛?cè)腴T,所以沒有選擇這種方式。而采用了另一種方法MarkDown+HTML混編(這種方法在簡書上貌似有BUG)。具體如下:
將要生成目錄的標(biāo)題部分利用HTML標(biāo)簽包裹,如圖:
注意,這里的id屬性一定要有,之后的跳轉(zhuǎn)鏈接會用到。
目錄部分利用列表+鏈接的格式實現(xiàn)頁內(nèi)跳轉(zhuǎn),如下圖所示:
注意,這里采用鏈接格式的括號里寫入#+對應(yīng)標(biāo)題的id(取代原本填寫跳轉(zhuǎn)地址)。
最終生成的目錄如下:
注:在文章發(fā)布后,并沒有實現(xiàn)頁內(nèi)跳轉(zhuǎn)的預(yù)期效果,正在尋找原因。。。
原因分析(后續(xù)更新)##
通過比較在文本編輯時自己所書寫的MarkDown文件和發(fā)布后的文章在瀏覽器控制臺檢查HTML代碼,發(fā)現(xiàn)發(fā)布后標(biāo)題元素的id屬性消失。
由此可以得知無法完成頁內(nèi)跳轉(zhuǎn)的原因是由于錨點丟失造成的。
在名為Typora的MarkDown編輯器中采用同樣的方法生成本文目錄,截圖如下:
查看標(biāo)題的HTML節(jié)點屬性:
可見其id屬性未丟失,并且生成的目錄可以使用,實現(xiàn)頁內(nèi)跳轉(zhuǎn)功能。
由此得知造成錨點丟失的原因,為簡書的MarkDown編輯器不完全支持這種混編形式。因此之后要想在簡書中生成目錄,只能使用第一種安裝拓展包的方式實現(xiàn)。等新系統(tǒng)裝好后,再去嘗試一下這種擴展包的方法。
參考資料:
Markdown學(xué)習(xí)筆記
MarkDown頁內(nèi)跳轉(zhuǎn)實現(xiàn)
MarkDown技巧:兩種方式實現(xiàn)頁內(nèi)跳轉(zhuǎn)
MarkDown生成目錄索引
<h2 id = '1.4'>總結(jié)</h2>
這兩天只是對MarkDown做了淺顯的學(xué)習(xí),但是僅僅是這樣,就遇到了上述的問題,那么如果要往深入學(xué),應(yīng)該還會有更多的問題需要我去想辦法解決。
另外,關(guān)于自己的學(xué)習(xí)方式,其實以前一直沒有寫過東西去記錄自己的學(xué)習(xí)歷程,但是這次因為參與了TW大講堂,有了這么一個機會,也做了這樣一次嘗試,感覺還不錯。希望之后能堅持下去,待到三五年后,也算有個回首往事的印記吧。