Markdown 语法

markdown - 更简洁、更高效

=================================================

强烈建议开发者认真阅读本文档,掌握md及HBuilderX对md的强大支持。
窄屏幕下,可按Alt+滚轮横向滚动

很多人只把markdown用于网络文章发表,这糟蹋了markdown。
markdown不止是HTML的简化版,更重要的是txt的升级版、word的轻量版、笔记的最佳载体。
作为一种简单的格式标记语言,不同于txt的无格式,不同于HTML的复杂标记,也不同于word的鼠标调整样式。markdown通过简单的几个字符键入,就可以快捷的定义文档的样式。
比如在行首敲一个“#”,就把这行定义为了1级标题,并且在HBuilderX里有直观完善的着色,这样无需发布为web页面,可直接当word用。
掌握markdown,你可以完全抛弃txt和笔记软件的编辑器,并且在大多数场景下替代掉复杂臃肿的word。享受简洁之美、享受效率提升。
而HBuilderX,可以被称为最强大的markdown书写工具了。

下面的示例列举了markdown语法及对应的HBuilderX使用技巧:

开始前,可以先按下文档结构图的快捷键Alt+w(Mac是Ctrl+w),浏览本文的大纲。

标题语法

markdown的标题是行首以#号开头,空格分割的,不同级别的标题,在HX里着色也不同。如下:

标题1

标题2

标题3

标题4

标题5
标题6

标题使用技巧:

  1. Emmet快速输入:敲h2+Tab即可生成二级标题【同HTML里的emmet写法,不止标题,HX里所有可对应tag的markdown语法均支持emmet写法】。仅行首生效
  2. 智能双击:双击#号可选中整个标题段落
  3. 智能回车:行尾回车或行中Ctrl+Enter强制换行后会自动在下一行补#。而连续2次回车后将自动补的#去掉。(体验同word)
  4. 回车后再次按Tab可递进一层标题,再按Tab切换列表符
  5. 在# 后回车,可上插一个空标题行【同word】,或任意位置按Ctrl+Shift+Enter也可以上插空标题行
  6. 折叠:
    • 点标题前的-号可折叠该标题段落,快捷键是Alt+-(展开折叠是Alt+=)
    • 多层折叠时折叠或展开子节点,快捷键是Alt+Shift+-或=
    • 全文全部折叠或展开,快捷键是Ctrl+Alt+Shift+-或=
    • 折叠其他区域,快捷键是Alt+Shift+o。这对长文档管理非常有用,可以专注于当前章节
    • 可以在菜单-跳转-折叠中随时找到这些功能

列表

markdown的列表支持有序列表、无序列表以及特殊的任务列表。
同样也是在行前加一个特殊符号,并空格后再跟列表文字内容。

有序列表

有序列表就是有顺序的列表,依靠行前的数字标记顺序。

  1. 有序列表1 【设置或取消有序列表符的快捷键:Ctrl+Alt+1,可选中多行批量设置序号;支持多光标批量设置列表符,即按Ctrl+鼠标左键添加多光标】
  2. 有序列表2 【列表后回车会自动补序号】
  3. 有序列表3 【智能双击:双击前面的数字,可重新对数字排序,修正序号错误,并选中有序列表段落(左边的4是故意写错让你体验的)】

无序列表

无序列表就是列表不排序,无序列表因书写随意而被更广泛的使用。
无序列表有3种前缀,HX里分别用于表示1级列表、2级列表、3级列表。

  • 无序列表1 【快捷键:Ctrl+Alt+-;智能双击:双击-号可选中整段无序列表;再次按Tab会更换二级列表符】
  • 无序列表2
    • Emmet:li后敲Tab可生成*号列表符,行首生效
    • 快捷键:Ctrl+Alt+8【8即*对应的数字】,支持多光标批量设置列表符,即按Ctrl+鼠标左键添加多光标
    • 智能双击:双击*号可选中整段无序列表
    • 智能回车:行尾回车或行中Ctrl+Enter强制换行后会自动续列表;连续按回车会清除列表符;再次按Tab会更换列表符;在列表符后回车或行尾Shift+回车,上一行留出列表符
    • *号常用于二级列表,列表符后继续Tab,可切换列表符
  • 无序列表3 【快捷键:Ctrl+Alt+=;常用于三级列表;其他同上】

任务列表

任务列表非常实用,管理待办、已办非常便利。
[ ] 任务列表-未完成任务 【快捷键:Ctrl+Alt+[】
[x] 任务列表-已完成任务 【快捷键:Ctrl+Alt+]】
1. 智能双击:双击方括号内可切换勾选状态,把任务标记为完成或未完成;双击方括号右侧可选中任务列表段落
2. 智能回车:回车后自动补任务列表前缀符号;连续按回车清除前缀符号;在列表符后回车或行尾Shift+回车,上一行留出列表符

  • 如需发布到web渲染,需增加无序列表- 的前缀

以上三种列表,均支持批量修改列表符,有如下方式建议依次学习尝试:

  1. 选中多行,按快捷键Ctrl+Alt+“1”或“-”或“[”或“]”,批量设置列表符
  2. 如果需要跳行设置有序或无序列表,通过Ctrl+鼠标左键点中目标多行(可不连续),产生多光标,然后按快捷键Ctrl+Alt+“1”或“-”或“[”或“]”,可跳行设置列表符,尤其是有序列表,数字也会跳行加1
  3. 按Alt+鼠标选中行首那列(列选择),这样每行行首都有光标,然后再键入或删除列表符即可批量操作
  4. 选中多行,按快捷键Ctrl+Shift+\(其实就是Ctrl+|),可以在每行行首添加一个光标

引用列表

引用1
引用2
快捷键:Ctrl+Alt+Shift+.
智能双击:双击>号可选中整段引用列表
智能回车:行尾回车或行中Ctrl+Enter强制换行后会自动续列表;连续按回车会清除列表符;在列表符后回车或行尾Shift+回车,上一行留出列表符

文字样式语法

加粗 【快捷键:Ctrl+B,支持多光标;Emmet:b后敲Tab】
加粗2
倾斜【Emmet:i后敲Tab;前后包围:选中文字按Ctrl+\是在选区两侧添加光标,可以继续输入
倾斜
删除线
单行代码
包围插入:先选中文字内容,然后按
*~`等符号,会自动在2侧加包围
智能双击:双击语法区前面的定义符号,选中包含定义符的整段文字
去包围:选中整段文字后,按Ctrl+Shift+],可去除2侧包围符号

引号括号虽然不属于markdown语法,但也支持相同的包围、选择、去包围操作。
引号括号智能双击选择时略特殊的是:双击引号括号内侧,选中引号括号里的内容(不含引号括号);按下Alt+双击引号括号内侧,则选中包含符号的整段文字

HBuilderX还支持以下对2侧文本高效处理的手段

  1. 选中文字按Ctrl+\是在选区两侧添加光标,可以继续输入~~,会在2侧同时输入
  2. 向2侧扩大选择:【Win:Alt+Shit+→ 、Mac:Ctrl++Shit+→】;由2侧向内减少选择:【Win:Alt+Shit+← 、Mac:Ctrl++Shit+←】

链接文字

  1. Emmet:a后敲Tab
  2. 打开链接:Alt+鼠标单击;如果是本地文件,可通过Shift+Alt+单击,在另一分栏打开文件
  3. 智能粘贴:粘贴URL会自动变成超链接格式;粘贴本地文件进来也会自动创建引用链接
  4. 智能双击:双击语法区开头,即[左侧,选中包含定义符的整段文字

[图片上传失败...(image-871f9-1619335753308)]

  1. Emmet:img后敲Tab
  2. 智能粘贴:粘贴剪切板里的图形时会自动保存为本md文档的附件;删除文档中的图片语法,保存md文档时会自动删除对应的图片附件;粘贴图片文件时自动变成链接引用格式;
  3. 悬浮预览:鼠标移到图片语法上,本地图片会自动显示出来
  4. 智能双击:双击语法区开头,即!左侧,选中包含定义符的整段文字

表格

  1. Emmet:table3*3后敲Tab,表示生成3行3列的表格,行首生效
  2. md表格对齐是传统md的痛点,按下Ctrl+K可以自动整理表格格式(暂未兼容不同缩放模式和字体的情况)
  3. 支持从excel、wps、word、number的表格中复制粘贴表格进来(不支持合并单元格和单元格换行)

分割线

------------- 【Emmet:hr后敲Tab】


=============

代码区

    var a = document

Emmet:code后敲Tab,行首生效
智能双击:双击语法区开头,即!左侧,选中包含定义符的整段文字
支持代码直接高亮着色,这应该是只有HBuilderX才有的功能。注意需要在代码区开头指定语言类型

注释


快捷键:Ctrl+/
智能双击:双击注释首尾的定义符,选中整段注释

其他emmet快捷输入

day后敲Tab,当前日期。注意day需在行首或前面有空格
time后敲Tab,当前时间。注意time需在行首或前面有空格

文档结构图

文章很长时,word里有文档结构图,HBuilderX也有。
菜单视图-文档结构图,快捷键Alt+W(mac是ctrl+W),轻松管理长文档

运行、预览和打印PDF

对md文件点工具栏或菜单里的浏览器运行,可以使用外部浏览器预览此md文件,会自动渲染为HTML。
点右上角的预览【快捷键Alt+p】,可在HBuilderX右侧预览该md文档的HTML渲染结果。
在浏览器中点打印,选择打印到PDF,可将md输出为PDF格式。(注意在打印选项里去掉页眉页脚)

一键分享

markdown拥有迷人的输入体验,但分享并不方便,尤其是缺少免费、稳定、高速的图床。
uniCloud提供了免费、稳定、高速的服务器和cdn。
HBuilderX,基于uniCloud,提供了markdown的一键分享功能。

利用uniCloud的前端网页托管,将markdown稳定转成了HTML网页,并发布为在线的URL。您可以把URL发送给任何想要分享的人。
同时markdown里涉及的图片也会自动上传到前端网页托管里免费cdn中。

更多见: MarkDown一键分享使用说明

其他常用但你可能不知道的快捷操作技巧

  • Ctrl+鼠标左键添加多光标,然后敲字或粘贴,可批量处理。Ctrl+鼠标左键拖选,可选中多个选区。
  • Ctrl+鼠标右键删除多光标
  • 不选内容按Ctrl+C或X可复制或剪切整行
  • 选中2个选区后,按Ctrl+Shift+X,可互换选区内容。如无选区,只是2个光标,则互换2行
  • Ctrl+上下键可上下移动行
  • Ctrl+Insert可重复插入当前行,如果有选中内容,可重复插入选中内容
  • Ctrl+Shift+K可合并多行(是格式化Ctrl+K的反操作)
  • 删除
    • 按Ctrl+D可删除选中行,支持多光标
    • Shift+Del删除到行尾
    • Shift+Backspace删除到行首
  • 选择
    • Ctrl+E选相同词(mac是Command+D),连续按可选中多词进一步操作,比替换更方便
    • Ctrl+L可连选多行,Ctrl+Shift+L也是选择行,但不选行首尾的空白字符
    • Ctrl+=可逐级放大选区
    • 双击标题、列表符可选中相应段落
    • 双击英文引号、括号内侧,可选中内部内容
    • 双击缩进符,可选中同缩进段落
    • 双击连字符比如-或_,可选中相连的词,比如双击这里试试,uni-app
  • 查找
    • Ctrl+P查找文件
    • Ctrl+Alt+F可在当前目录的所有文档中搜索指定关键字(mac是Command+Shift+f)
    • 选中文字按F3,查找下一个,Shift+F3找上一个
  • 云同步:HBuilderX+markdown用于云同步笔记的技巧,请参考http://ask.dcloud.net.cn/article/13097

都学会了吗?
markdown语法其实很简单,认真学半小时就能掌握。
HBuilderX的极客操作则需要不停反复练习,熟练掌握这些技巧,你将成为高效极客!

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

推荐阅读更多精彩内容