跳至主要內容

Markdown常用语法

黄曦大约 9 分钟markdownmarkdown

markdown 语法

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

标题语法

markdown 的标题是行首以#号开头,空格分割的。如下:

标题 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+回车,上一行留出列表符

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

  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+←】

链接文字open in new window

  1. Emmet:a 后敲 Tab
  2. 打开链接:Alt+鼠标单击;如果是本地文件,可通过 Shift+Alt+单击,在另一分栏打开文件
  3. 智能粘贴:粘贴 URL 会自动变成超链接格式;粘贴本地文件进来也会自动创建引用链接
  4. 智能双击:双击语法区开头,即[左侧,选中包含定义符的整段文字
图片描述文字
图片描述文字
  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 拥有迷人的输入体验,但分享并不方便,尤其是缺少免费、稳定、高速的图床。
uniCloudopen in new window提供了免费、稳定、高速的服务器和 cdn。 HBuilderX,基于 uniCloud,提供了
markdown 的一键分享功能。

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

更多见: MarkDown 一键分享使用说明open in new window

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

  • 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 找上一个

引用他人笔记,承诺不用于任何商业用途,仅供学习参考