`.md` Guide

1. 直覺的 markdown 寫作

typora ^<- ^Notice: ^Will ^Charge ^@ ^Ver1.0!

What's typora use like?

使用技巧

區塊公式、程式碼：打出前綴後換行會自動出現區塊，離開區塊直接按 [↓]

清單/列表：結尾時，[換行] 連打兩次會升階(凸排)，凸到最後會直接出去清單變成一般段落
善用 Home/End/(Shift+)換行/(Shift+)Tab/BackSpace
強烈建議在設定打開「停留在…顯示其原始碼」、「自動存檔」兩個選項

SmartPhone 呢? 同步筆記呢?

打字app + 雲端硬碟 + PC管理/編排

2. 對你的 `.md` 檔做各種事情

雖然 Typora 就支援轉檔 Word/html/TeX 檔，但術業有專攻…

網路快速發表簡報/手冊

先在 hackmd.io 匯入你的 .md 檔(們)

!圖片多半要重新連結(或透過HackMD上傳到imgur)

HackMD 簡報

在 .md 需要換頁處加上(要空行)：
```
---
```
在 \(\cdots\) 打開「簡報模式」，Done!

(在 Rmarkdown 也是用類似方法做簡報)

HackMD 手冊

建立新筆記，開始打手冊標題
用項目或列表連結所有章節
(Hint: 輸入[時會開始搜尋已上傳筆記)
在 \(\cdots\) 打開「書本模式」，Done!
(Hint: 在列表的連結前加上/s/可去掉工作列)

(在 Rmarkdown 的 bookdown 裡面也是類似方法讓多個文檔變成書本章節)

謝謝大家

(以下開始五分鐘講不完)

A. 熟捻 markdown 語法

使用 stackedit.io Web App

免安裝
Welcome file -> 光看一遍就學完語法
編輯區"不藏Code的"即時渲染 -> 直覺了解操作結果

B1. Typora 建議設定(外觀&Markdown)

設定名稱	設定選項	說明
視窗樣式	◉一體化	簡潔
側邊欄	✅左側欄允許收放
markdown 擴展支援	全部都✅	方便
markdown 語法偏好	✅嚴格模式	相容性

B2. Typora 建議設定(編輯器&系統)

設定名稱	設定選項	說明
自動配對	全部都✅	方便
即時顯示	✅停留在…顯示其原始碼	好改
存檔時整理縮排	✅整理縮排	原始碼美觀
預設換行符號	◉LF(Unix Sty..)	相容性
儲存並恢復	自動儲存	直覺

C. R markdown to \(\LaTeX\)

C1. R markdown 是甚麼?

~~R 的 Jupyter Notebook (大霧!!!)~~

R & RStudio & Rmarkdown package
+
Pandoc
+
\(\LaTeX\)軟體

C2. 安裝工作

安裝 R、RStudio、\(\LaTeX\)(MiKTeX or TeX Live)、Pandoc
在 R 中安裝 rmarkdown package：
```
install.packages("rmarkdown")
```

C3. Rmd 語法

C4. Rmd 輸出

按 Knit 按鈕

C5. 各種文檔的輸出方式

報告：直接輸出
簡報：
1. 跟 HackMD 一樣用 --- 分頁
2. 透過設定的齒輪圖示調整 YAML 設定更改
  (透過 Beamer 分頁規則較為特殊須注意)
書本：
1. 跟 HackMD 一樣用一個文檔當 index
2. 透過 bookdown 把多個文檔轉成一個電子書

C6. 中文要怎麼設定

假如以 \(\LaTeX\) 相關的輸出，需要先進行設定，首先我們要在 YAML 加入：

output:
  pdf_document:
    includes:
      in_header: 中文化表頭tex檔路徑
    latex_engine: xelatex # 才可以用 Uincode

其中使用 includes: in_header: 是要讓 Rmarkdown 轉 \(\LaTeX\) 時，在檔頭加入中文化相關的 userpackage 與設定，請新建立一個 .tex 檔，並加入如下程式碼：

% Set CJK
\usepackage{fontspec}
\usepackage{xeCJK}
\setCJKmainfont{標楷體} %設定中文為系統上的字型，而英文不去更動，使用原TeX字型
\XeTeXlinebreaklocale "zh"
\XeTeXlinebreakskip = 0pt plus 1pt %這兩行一定要加，中文才能自動換行

謝謝大家

接下來的東西真的閃電秀不可能有時間講

Chunk 細說

撰寫程式碼的地方，可用 Insert 按鈕設定：

或是直接在編輯器裡打出這樣的內容：

```{使用程式語言代碼 Chunk名稱,  # 實際上這邊不能換行
    Chunk參數名稱=Chunk參數設定, # 實際上這邊不能換行
    下一個Chunk參數名稱=Chunk參數設定}
程式碼區域
```

chunk 參數調整

設定完後按 Apply 會自動幫你補齊參數設定。

若要一次設定所有 chunk 一些固定的參數，可以在整篇文件的最前面加上一個 chunk：

```{r setup, include=FALSE}
knitr::opts_chunk$set(Chunk參數名稱=Chunk參數設定, ...)
```

SAS 怎麼辦？

假如要使用 SAS 在 Rmarkdown 裡面的話，可以使用 SASmarkdown Package，安裝方法是在 R console 下執行：

install.packages("SASmarkdown")

其餘請上網參考其文檔，或參考吾人筆記

.md Guide