~~(5分鐘內絕對講不完的)~~
# `.md` Guide
*Peter Hsiao @ NTNU Math*
---
## 1. 直覺的 markdown 寫作
==[typora](https://typora.io/)== ^<-^ ^Notice:^ ^Will^ ^Charge^ ^@^ ^Ver1.0!^
---
### What's typora use like?
{%vimeo 150510402%}
---
### 使用技巧
- 區塊公式、程式碼：打出前綴後換行會自動出現區塊，離開區塊直接按 \[↓\]
---
- 清單/列表：結尾時，\[換行\] 連打兩次會升階(凸排)，凸到最後會直接出去清單變成一般段落
- 善用 Home/End/(Shift+)換行/(Shift+)Tab/BackSpace
- 強烈建議在設定打開「停留在...顯示其原始碼」、「自動存檔」兩個選項
---
SmartPhone 呢? 同步筆記呢?
### 打字app + 雲端硬碟 + PC管理/編排
---
## 2. 對你的 `.md` 檔做各種事情
雖然 Typora 就支援轉檔 Word/html/TeX 檔，但術業有專攻...
---
### 網路快速發表簡報/手冊
0. 先在 [hackmd.io](https://hackmd.io) 匯入你的 `.md` 檔(們)
\!圖片多半要重新連結(或透過HackMD上傳到imgur)
---
#### HackMD 簡報
1. 在 `.md` 需要換頁處加上(要空行)：
```markdown
---
```
2. 在 $\cdots$ 打開「簡報模式」，Done!
---
(在 Rmarkdown 也是用類似方法做簡報)
---
#### HackMD 手冊
1. 建立新筆記，開始打手冊標題
2. 用項目或列表連結所有章節<br>(Hint: 輸入`[`時會開始搜尋已上傳筆記)
3. 在 $\cdots$ 打開「書本模式」，Done!<br>(Hint: 在列表的連結前加上/s/可去掉工作列)
---
(在 Rmarkdown 的 bookdown 裡面也是類似方法讓多個文檔變成書本章節)
---
## 謝謝大家
### (以下開始五分鐘講不完)
---
## A. 熟捻 markdown 語法
使用 ==[stackedit.io](https://stackedit.io/app#)== Web App
- 免安裝
- Welcome file -> 光看一遍就學完語法
- 編輯區"不藏Code的"即時渲染 -> 直覺了解操作結果
---
## B1. Typora 建議設定(外觀&Markdown)
|設定名稱|設定選項|說明|
|:------|:-------|:---|
|==視窗樣式==|==◉一體化==|簡潔|
|側邊欄|✅左側欄允許收放||
|==markdown<br>擴展支援==|==全部都✅==|方便|
|markdown<br>語法偏好|✅嚴格模式|相容性|
---
## B2. Typora 建議設定(編輯器&系統)
|設定名稱|設定選項|說明|
|:------|:-------|:---|
|==自動配對==|==全部都✅==|方便|
|==即時顯示==|==✅停留在...顯示<br>其原始碼==|好改|
|存檔時<br>整理縮排|✅整理縮排|原始碼<br>美觀|
|預設換行<br>符號|◉LF(Unix Sty..)|相容性|
|==儲存並恢復==|==自動儲存==|直覺|
---
## C. [R markdown](https://rmarkdown.rstudio.com/) to $\LaTeX$
---
### C1. R markdown 是甚麼?
~~R 的 Jupyter Notebook (大霧!!!)~~
> R & RStudio & Rmarkdown package
> \+
> Pandoc
> \+
> $\LaTeX$軟體
---
### C2. 安裝工作
1. 安裝 [R](https://cloud.r-project.org/)、[RStudio](https://www.rstudio.com/products/rstudio/download/#download)、$\LaTeX$([MiKTeX](https://miktex.org/) or [TeX Live](https://www.tug.org/texlive/))、[Pandoc](https://pandoc.org/installing.html)
2. 在 R 中安裝 rmarkdown package：<br>
```R
install.packages("rmarkdown")
```
---
### C3. Rmd 語法
---
### C4. Rmd 輸出
按 Knit 按鈕
---
### C5. 各種文檔的輸出方式
- 報告：直接輸出
- 簡報：
1. 跟 HackMD 一樣用 `---` 分頁
2. 透過設定的齒輪圖示調整 YAML 設定更改
(透過 Beamer 分頁規則較為特殊須注意)
- 書本：
1. 跟 HackMD 一樣用一個文檔當 index
2. 透過 [bookdown](https://bookdown.org/) 把多個文檔轉成一個電子書
---
### C6. 中文要怎麼設定
假如以 $\LaTeX$ 相關的輸出，需要先進行設定，首先我們要在 YAML 加入：
```yaml
output:
pdf_document:
includes:
in_header: 中文化表頭tex檔路徑
latex_engine: xelatex # 才可以用 Uincode
```
---
其中使用 `includes: in_header:` 是要讓 Rmarkdown 轉 $\LaTeX$ 時，在檔頭加入中文化相關的 userpackage 與設定，請新建立一個 `.tex` 檔，並加入如下程式碼：
```latex
% Set CJK
\usepackage{fontspec}
\usepackage{xeCJK}
\setCJKmainfont{標楷體} %設定中文為系統上的字型，而英文不去更動，使用原TeX字型
\XeTeXlinebreaklocale "zh"
\XeTeXlinebreakskip = 0pt plus 1pt %這兩行一定要加，中文才能自動換行
```
---
## 謝謝大家
接下來的東西真的閃電秀不可能有時間講
---
### Chunk 細說
撰寫程式碼的地方，可用 Insert 按鈕設定：
或是直接在編輯器裡打出這樣的內容：
```R
```{使用程式語言代碼 Chunk名稱, # 實際上這邊不能換行
Chunk參數名稱=Chunk參數設定, # 實際上這邊不能換行
下一個Chunk參數名稱=Chunk參數設定}
程式碼區域
```
```
---
chunk 參數調整
設定完後按 Apply 會自動幫你補齊參數設定。
---
若要一次設定所有 chunk 一些固定的參數，可以在整篇文件的最前面加上一個 chunk：
```markdown
```{r setup, include=FALSE}
knitr::opts_chunk$set(Chunk參數名稱=Chunk參數設定, ...)
```
```
---
### SAS 怎麼辦？
假如要使用 SAS 在 Rmarkdown 裡面的話，可以使用 SASmarkdown Package，安裝方法是在 R console 下執行：
```R
install.packages("SASmarkdown")
```
其餘請上網參考其文檔，或參考[吾人筆記](https://hackmd.io/s/S1Vjf9Wa7#Chunk)
---
### YAML 設定
---
{"metaMigratedAt":"2023-06-14T20:39:38.556Z","metaMigratedFrom":"YAML","title":"`.md` Guide","breaks":true,"contributors":"[{\"id\":\"812b4291-1b64-4ae9-8c5f-a1e3bac402f8\",\"add\":11360,\"del\":7274}]"}