高级 Markdown 技巧

当你觉得 markdown 做不了一些事的时候,可能其实它可以做到。

由于简书markdown中无法使用html标签,有关html的内容可能无法正常显示。欢迎前往采叶小火的博客查看原文:https://mikelyou.com/2020/04/08/advanced-markdown-skill/。转载请保留此链接。

本文介绍了本人从各处搜集到的 markdown 高级技巧,有一些可能使用起来并不高效,甚至有把简单的markdown复杂化的可能性,但这些用法真的很少人分享,我又想用,所以姑且分享一下我了解的。希望能帮到你。

谁适用阅读本文: 已经可以闭着眼写markdown的人 或 写markdown像写纯文本一样熟练自由的人。

如果你还不熟悉 markdown 语法,推荐以下几个很好的教程:菜鸟教程GitHub Markdown语法思否SegmentFault(推荐这个,可玩性较高)。别人已经写得很好了,我就没必要再写啦

在 Markdown 中使用 HTML 元素

Markdown 注释

学过点编程的人可能都有写注释的欲望,一段内容想删但又不舍得,纠结使人头大。而 markdown 本身作为轻量级语言,是没有注释语法的。想要写注释的话,需要使用 html 注释(参考):

<!-- 这是 html 注释, 在 markdown 中也不会被编译, 可以作为注释的方法 -->

输出为:

折叠网页内容

有时候我们希望在博文中折叠部分细节的讨论,这时候可以使用 <summary> 来折叠内容,不过在纯 markdown 编辑器中大概不行。(参考

<details>
<summary>展开查看</summary>
啊啦~被你发现啦!
</details>

显示如下:

<details>
<summary>展开查看</summary>
啊啦~被你发现啦!
</details>

我喜欢搭配表格使用,这样可以清晰的现实哪些是折叠部分的内容:

<details>
<summary><b>See what's inside &darr;</b></summary>
  <table border="1">
    <tr>
      <th><a href="https://www.runoob.com/html/html-quicklist.html">如何使用html元素添加表格</a></th>
    </tr>
    <tr>
      <td>
        这个样子<br>
        多行内容<br>
        不至于让分不清哪里是折叠内容的结束
      </td>
    </tr>
  </table>
</details>

输入如下:

<details>
<summary><b>See what's inside ↓</b></summary>
<table border="1">
<tr>
<th><a href="https://www.runoob.com/html/html-quicklist.html">如何使用html元素添加表格</a></th>
</tr>
<tr>
<td>
这个样子

多行内容

不至于让分不清哪里是折叠内容的结束
</td>
</tr>
</table>
</details>

应该也可以定义 CSS 样式代替表格吧?回头试试,可以的话会好看很多。

其他 HTML 标签

不在 Markdown 涵盖范围之内的标签,都可以直接在文档里面用 HTML 撰写。(参考

目前支持的 HTML 元素有:<kbd> <b> <i> <em> <sup> <sub> <br>等 ,如:

使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重启电脑

使用 <kbd>Ctrl</kbd>+<kbd>Alt</kbd>+<kbd>Del</kbd> 重启电脑

这是一句话,可以<b>粗体</b>或<i>斜体</i>或<em>强调文本</em>,<br>
还能使用<sup>上标</sup>和<sub>下标</sub>。使用<br>换行。

这是一句话,可以<b>粗体</b>或<i>斜体</i>或<em>强调文本</em>,

还能使用上标下标。使用
换行。

可以使用的应该还有很多,大家可以自己尝试。不过能用 markdown 自身语法实现的功能,比如粗体,就不要使用 html 标签了,否则有种本末倒置的感觉了。应该只有在 markdown 无法实现某个功能是再尝试使用 html 标签。

字符转义

Markdown 使用了很多特殊符号来表示特定的意义,如果需要显示特定的符号则需要使用转义字符。Markdown 使用反斜杠转义特殊字符,支持以下这些符号:<code></code> <code>`</code> <code>*</code> <code>_</code> <code>{}</code> <code>[]</code> <code>#</code> <code>+</code> <code>-</code> <code>.</code> <code>!</code>.

至于我要怎么写才能把上面一行内容显示在网页上,这又是一个套娃问题,我知道怎么写但不知道怎么把怎么写写出来,看看这个回答大家应该就清楚了。

插入公式

使用一对美元符号$可以显示公式,双美元符号$$会使公式单独占一行,公式的语法与 LaTeX 一样。

不过这需要加载 Mathjax 进行渲染。并非所有 markdown 编辑器都拥有这个功能,我所了解的 简书马克飞象 是可以支持公式渲染的。

本博客模板添加了 Mathjax 支持所以可以直接写公式。在 Atom 中需要安装插件,但公式渲染和同步滚动两个功能无法同时实现。

太过复杂的公式可能不太好办,比如那种箭头上下都有文字的化学反应,主要是很难写的好看;不过我觉得一般人都用不到那种,能写个表格矩阵的就够复杂了。我在另一篇博文中讨论了更多关于在博客中的 LaTeX 写作的细节。

公式示例:

小明买了$m$ 跟铅笔,每根 $n$ 元, 那么他一共花了这么多元

$$y = m * n$$

输出如下:

小明买了m 跟铅笔,每根 n 元, 那么他一共花了这么多元

y = m * n


本人水平有限,如有错误或更好的实现方法,欢迎指正

©著作权归作者所有,转载或内容合作请联系作者
  • 序言:七十年代末,一起剥皮案震惊了整个滨河市,随后出现的几起案子,更是在滨河造成了极大的恐慌,老刑警刘岩,带你破解...
    沈念sama阅读 203,362评论 5 477
  • 序言:滨河连续发生了三起死亡事件,死亡现场离奇诡异,居然都是意外死亡,警方通过查阅死者的电脑和手机,发现死者居然都...
    沈念sama阅读 85,330评论 2 381
  • 文/潘晓璐 我一进店门,熙熙楼的掌柜王于贵愁眉苦脸地迎上来,“玉大人,你说我怎么就摊上这事。” “怎么了?”我有些...
    开封第一讲书人阅读 150,247评论 0 337
  • 文/不坏的土叔 我叫张陵,是天一观的道长。 经常有香客问我,道长,这世上最难降的妖魔是什么? 我笑而不...
    开封第一讲书人阅读 54,560评论 1 273
  • 正文 为了忘掉前任,我火速办了婚礼,结果婚礼上,老公的妹妹穿的比我还像新娘。我一直安慰自己,他们只是感情好,可当我...
    茶点故事阅读 63,580评论 5 365
  • 文/花漫 我一把揭开白布。 她就那样静静地躺着,像睡着了一般。 火红的嫁衣衬着肌肤如雪。 梳的纹丝不乱的头发上,一...
    开封第一讲书人阅读 48,569评论 1 281
  • 那天,我揣着相机与录音,去河边找鬼。 笑死,一个胖子当着我的面吹牛,可吹牛的内容都是我干的。 我是一名探鬼主播,决...
    沈念sama阅读 37,929评论 3 395
  • 文/苍兰香墨 我猛地睁开眼,长吁一口气:“原来是场噩梦啊……” “哼!你这毒妇竟也来了?” 一声冷哼从身侧响起,我...
    开封第一讲书人阅读 36,587评论 0 258
  • 序言:老挝万荣一对情侣失踪,失踪者是张志新(化名)和其女友刘颖,没想到半个月后,有当地人在树林里发现了一具尸体,经...
    沈念sama阅读 40,840评论 1 297
  • 正文 独居荒郊野岭守林人离奇死亡,尸身上长有42处带血的脓包…… 初始之章·张勋 以下内容为张勋视角 年9月15日...
    茶点故事阅读 35,596评论 2 321
  • 正文 我和宋清朗相恋三年,在试婚纱的时候发现自己被绿了。 大学时的朋友给我发了我未婚夫和他白月光在一起吃饭的照片。...
    茶点故事阅读 37,678评论 1 329
  • 序言:一个原本活蹦乱跳的男人离奇死亡,死状恐怖,灵堂内的尸体忽然破棺而出,到底是诈尸还是另有隐情,我是刑警宁泽,带...
    沈念sama阅读 33,366评论 4 318
  • 正文 年R本政府宣布,位于F岛的核电站,受9级特大地震影响,放射性物质发生泄漏。R本人自食恶果不足惜,却给世界环境...
    茶点故事阅读 38,945评论 3 307
  • 文/蒙蒙 一、第九天 我趴在偏房一处隐蔽的房顶上张望。 院中可真热闹,春花似锦、人声如沸。这庄子的主人今日做“春日...
    开封第一讲书人阅读 29,929评论 0 19
  • 文/苍兰香墨 我抬头看了看天上的太阳。三九已至,却和暖如春,着一层夹袄步出监牢的瞬间,已是汗流浃背。 一阵脚步声响...
    开封第一讲书人阅读 31,165评论 1 259
  • 我被黑心中介骗来泰国打工, 没想到刚下飞机就差点儿被人妖公主榨干…… 1. 我叫王不留,地道东北人。 一个月前我还...
    沈念sama阅读 43,271评论 2 349
  • 正文 我出身青楼,却偏偏与公主长得像,于是被迫代替她去往敌国和亲。 传闻我的和亲对象是个残疾皇子,可洞房花烛夜当晚...
    茶点故事阅读 42,403评论 2 342

推荐阅读更多精彩内容

  • 关于Markdown 一整个学期下来,我觉得让我收获最大之一的是学会markdown语言。我们平常都是使用Word...
    Dacade阅读 927评论 0 2
  • Title:MarkDown 语法说明&技巧使用&相关工具 标签(空格分隔): MarkDown 语法说明 技巧 ...
    SuperScfan阅读 1,060评论 0 0
  • << 访问 Wow!Ubuntu NOTE: This is Simplelified Chinese Edit...
    im蚂蚁阅读 1,442评论 4 4
  • 声明: 这份文档派生(fork)于繁体中文版,在此基础上进行了繁体转简体工作,并进行了适当的润色。此文档用 Mar...
    Cellei阅读 4,665评论 0 21
  • 为事业打拼的爸爸们经常会不在家,难怪孩子总会问:“爸爸去哪儿了?”为了让爸爸们重新审视自己,尝试回到孩子身边,学习...
    罗泽荣201701阅读 105评论 0 1