段落、換行與標題
• 段落
- 每個段落中間多空一行就對了!
•換行
- 想要多空一行請輸入 <br /> 或加入反斜線 ( ) 在行尾
• 標題
# This is a H1 header
## This is a H2 header
### This is a H3 header
#### This is a H4 header
##### This is a H5 header
3
4.
清單、檢查清單
• 項目清單、編號清單
* Red
*Green
* Blue
• 檢查清單
- [ ] A
- [ ] B
- [ ] C
- [x] A
- [x] B
- [x] C
4
- Red
- Green
- Blue
+ Red
+ Green
+ Blue
1. Red
2. Green
3. Blue
1. Red
1. Green
1. Blue
5.
多行清單
• 正常行距的多行清單
* Loremipsum dolor sit amet, consectetuer.
Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,
* Donec sit amet nisl. Aliquam semper ipsum sit amet velit.
Suspendisse id sem consectetuer libero luctus adipiscing.
• 加大行距的多行清單
* Lorem ipsum dolor sit amet, consectetuer.
Aliquam hendrerit mi posuere lectus. Vestibulum enim wisi,
* Donec sit amet nisl. Aliquam semper ipsum sit amet velit.
Suspendisse id sem consectetuer libero luctus adipiscing.
5
分隔線、引言、行內程式碼
• 分隔線
*** ** * --- - - - ----------------
• 引言 (blockquote)
> ## This is a header.
>
> 1. This is the first list item.
> 2. This is the second list item.
• 行內程式碼
This is `ASP.NET Core 5.0`.
7
認識幾條重要的 MarkdownLint Rules
•MarkdownLint Rules
- https://github.com/DavidAnson/markdownlint/blob/main/doc/Rules.md
• Rules
- MD001 - Heading levels should only increment by one level at a time
- MD012 - Multiple consecutive blank lines
- MD013 - Line length
- MD028 - Blank line inside blockquote
- MD029 - Ordered list item prefix
- MD034 - Bare URL used
- MD041 - First line in a file should be a top-level heading
- MD044 - Proper names should have the correct capitalization
23
Markdown Extension Pack
•markdownlint
• Markdown All in One
• Markdown Table Prettifier
• Markdown Paste Image
• Excel to Markdown table
• Copy Markdown as HTML
25
26.
必須記得的好用快速鍵
• Ctrl +B 切換粗體 (Toggle Bold)
• Ctrl + I 切換斜體 (Toggle Italic)
• Alt + S 切換刪除線 (Toggle Strikethrough)
• Alt + C 核取工作清單項目 (Check/Uncheck item)
• Ctrl + Alt + V 貼上圖片 ( res/... )
• Shift + Alt + V 貼上從 Excel 複製的剪貼簿內容
• Ctrl + Shift + V 從第二編輯器進行 Markdown 預覽
• Ctrl + . 快速修正違規 (Quick Fix)
• Alt + Shift + . 自動修正所有違規
• Alt + Shift + F 自動格式化文件(含表格)
• Ctrl + Alt + Shift + F 強迫格式化文件(自動修正所有格式)
(需安裝 Prettier - Code formatter 才有此功能)
26
相關連結
• Markdown 語法說明( https://markdown.tw )
• Azure DevOps
- Syntax guidance for basic Markdown usage
- Syntax guidance for Markdown usage in Wiki
- Keyboard shortcuts for managing Wiki pages
• GitHub
- Mastering Markdown
• Visual Studio Code
- Markdown and Visual Studio Code
- Markdown Extension Pack extension 👍
30
31.
聯絡資訊
• The WillWill Web
記載著 Will 在網路世界的學習心得與技術分享
- http://blog.miniasp.com/
• Will 保哥的技術交流中心 (臉書粉絲專頁)
- http://www.facebook.com/will.fans
• Will 保哥的推特
- https://twitter.com/Will_Huang
31