Jupyter Notebook'ta Markdown Eğitimi

Başlıklar

Başlıklar '#', yani kare işareti ve ardından bir boşlukla başlar; toplamda altı seviye başlık vardır: en büyük başlık tek kare, en küçük başlıklar ise altı kare işareti kullanır.

# (Başlık 1, başlık)

## (Başlık 2, ana başlıklar)

### (Başlık 3, alt başlıklar)

#### (Başlık 4)

##### (Başlık 5)

###### (Başlık 6)``

Alternatif olarak başlıklar, aşağıdaki sözdizimleriyle h1'den h6'ya kadar olan İşaretleme Etiketleriyle de başlayabilir.

<h1>Başlık 1,başlık<h1>
<h2>Başlık 2,ana başlıklar<h2>
<h3>Başlık 3,alt başlıklar<h3>
<h4>Başlık 4<h4>
<h5>Başlık 5<h5>
<h6>Başlık 6<h6>

Yukarıdaki her iki sözdizimi de araç çubuğunda 'Run' tıklandıktan sonra h1'den h6'ya kadar başlıkları oluşturur.

Alıntı Blokları

Alıntı blokları büyük metin parçalarını tutabilir ve genellikle girintilidir. Markdown'da '>' sembolüyle veya <blockquote>alıntı için metin</blockquote> şeklinde elde edilebilirler.

• >Bu güzel
• <blockquote>Bu güzel</blockquote>

Yukarıdaki her iki sözdizimi de araç çubuğunda 'Run' tıklandıktan sonra metni girintili biçimde oluşturur.

Kod Bölümü

Kod bölümü, farklı programlama dillerine ait kodu belirten kısımdır ve satır içi kod, etrafına ters tırnak konularak ' `satır içi kod buraya` ' şeklinde yazılır; kod bloğu ise üç ters tırnakla ' ``` blok kod satırı buraya ``` ' başlar. Ayrıca, Kod bölümü için İşaretleme etiketi ' <code>kod buraya<code> ' şeklindedir.

Satır içi kod örneği aşağıdadır:
`x =5`

"Run" sonrasında satır içi kodun vurgulanarak oluşturulduğunu görebilirsiniz.

Kod bölümü örnekleri aşağıdadır:

• Markdown Kullanarak
```Python

str = "This is block level code"

print(str)

```
• İşaretleme Etiketleri Kullanarak
<code>Python

str = "This is a block level code"

print(str)

</code>

Markdown ile, programlama dilinin adı '```' üç ters tırnaktan sonra belirtilirse sözdizimi vurgulaması elde edebilirsiniz; örnek aşağıdadır:

Markdown kullanıldığında sözdizimi renklendirmesi olmaz, ancak kod vurgulanır:

Matematiksel Sembol

Markdown'da matematiksel semboller, dolar sembolü ile çevrelenen '\$ matematiksel ifade buraya \$' içinde yer alır; İşaretlemede daha fazla ayrıntı için şu bağlantıyı takip edebilirsiniz: Matematiksel Operatörler. Aşağıda matematiksel sembollerin kullanımına bir örnek görebilirsiniz.

\$\sqrt{k}$

Yukarıdaki örnek, matematiksel ifadeyi kalın biçimde oluşturacaktır.

Satır Sonu

Satır sonu etiketi, kapanış etiketi olmayan <br> etiketiyle başlar; satırı böler ve kalan içerik aşağıdaki örnekte gösterildiği gibi yeni bir satırda başlar.

The line breaks after using <br> br tags and it is awesome.

Araç çubuğunda 'Run' tıklandıktan sonra, <br> etiketi kullanıldıktan sonra satır sonunu görebilirsiniz. Kalan metin yeni bir satırda başlar.

Kalın ve İtalik Metin

Aşağıdaki sözdizimiyle kalın metin elde etmek için <b> etiketlerini, '**' yani 'çift yıldız' veya '__' yani 'çift alt çizgi'yi kullanabilirsiniz.

• <b>Bu kalın metindir </b>

• ** Bu kalın metindir

• __ Bu kalın metindir

Yukarıdaki tüm sözdizimleri, araç çubuğunda 'Run' tıklandıktan sonra kalın metni oluşturabilir.

Aşağıdaki sözdizimiyle italik metin elde etmek için <i> etiketlerini, '*' yani tek yıldız veya '_' yani tek alt çizgiyi kullanabilirsiniz.

• <i>Bu italik metindir </i>

• * Bu italik metindir

• _ Bu italik metindir

Yukarıdaki tüm sözdizimleri, araç çubuğunda 'Run' tıklandıktan sonra italik metni oluşturabilir.

Yatay Çizgi

Yatay bir çizgiyi Markdown'da '---' üç kısa çizgi veya İşaretleme etiketi <hr> kullanarak elde edebilirsiniz.

Yukarıdaki her iki sözdizimi de "Run" tıklandıktan sonra bir uçtan diğer uca yatay çizgiyi oluşturacaktır.

Sıralı Liste

Sıralı Liste, <ol> etiketiyle başlayıp </ol> etiketiyle biten ve gerekli öğelerin <li> ve </li> etiketleri arasında yer aldığı numaralı listedir. 'ol' etiketi sıralı listenin, 'li' ise liste öğesinin kısaltmasıdır. Örneğin, aşağıda market alışverişi için öğeler içeren bir Sıralı Liste görebilirsiniz.

<ol>
<li>Balık</li>
<li>Yumurta</li>
<li>Peynir</li>
</ol>

Alternatif olarak, aşağıdaki örnekte olduğu gibi '1. ' yani gerekli sayı ve ardından bir boşlukla da listeleyebilirsiniz.

1. Balık
2. Yumurta
3. Peynir

Yukarıdaki her iki sözdizimi de araç çubuğunda 'Run' tıklandıktan sonra numaralı listeyi oluşturabilir.

Sırasız Liste

Sırasız liste, <ul> etiketi kullanılarak elde edilen ve </ul> etiketiyle biten madde işaretli listedir; aşağıdaki örneğe bakınız:

<ul>
<li>Balık</li>
<li>Yumurta</li>
<li>Peynir</li>
</ul>

Alternatif olarak, Sırasız liste boşlukla birlikte '-' sembolüyle başlayabilir; bu siyah daire simgesi verir. Ayrıca boşlukla birlikte '*' sembolüyle de başlayabilir; bu siyah kare simgesi verir.

-   Balık
-   Yumurta
-   Peynir

Yukarıdaki örnek, öğelerden önce boşlukla birlikte '-' sembolünün kullanıldığı ve siyah daire simgesi veren bir madde işaretli listeyi göstermektedir.

Yukarıdaki her iki sözdizimi de araç çubuğunda 'Run' tıklandıktan sonra listedeki öğelerin siyah daire olarak göründüğü aynı sonucu oluşturabilir.

Dahili ve Harici Bağlantı

Dahili Bağlantı Markdown'da, 'id' özniteliğiyle tanımlanmış benzersiz kimliğe sahip <a> etiketiyle başlar ve aşağıdaki örnekte olduğu gibi not defterinde bağlantı oluşturulabilir:

<a id = "division_ID"text buraya></a>

Ayrıca, yukarıda tanımlanan id, bağlantıyı tıklanabilir yapan aşağıdaki kod ile not defterindeki bir bölüme bağlanabilir.

[Bölüm başlığı](#division_ID)

Yukarıdakinin bir örneği aşağıda görülebilir; burada tanımlanan id bir bölüme bağlanmıştır ve araç çubuğunda "Run" tıklandıktan sonra tıklanabilir bağlantı elde edilir.

Harici Bağlantı Markdown'da <a> ile başlar ve <a> etiketi ile biter; <a> bağlantıyı tanımlayan çapa anlamına gelir ve 'href' özniteliğine sahiptir; bu öznitelik bağlantının hedef adresini veya URL'yi içerir ve etiketler arasındaki metin görünürdür, tıklanarak aşağıda gösterildiği gibi hedef adrese açılır.

<a> href="https://www.google.com" >Google'a Bağlantı</a>

Alternatif olarak, metin bağlantısı köşeli parantez içinde ve sitenin URL'si parantez içinde olmak üzere, her iki yanında çift alt çizgi bulunan __[metin bağlantısı](site için URL)__ biçiminde de başlayabilir.

Google'a Bağlantı

Yukarıdaki her iki sözdizimi de araç çubuğunda 'Run' tıklandıktan sonra tıklanabilir ve altı çizili metnin yeni bir sayfaya yönlendirdiği aşağıdaki aynı sonucu oluşturabilir.

Tablo

Tablo, bilgileri satır ve sütunlarda içerir ve her sütunu ayırmak için '|' yani 'dikey çubuk' ve başlığı oluşturmak için '-' yani kısa çizgi sembolünün birleşimiyle oluşturulur; boş satır yani dikey çubuk ve kısa çizgilerin birleşimi tablo biçimini oluşturur.

Ayrıca, hücreleri sütunlarla kabaca hizalayabilirsiniz; not defteri, verilen hücredeki içeriği otomatik olarak yeniden boyutlandıracaktır.

|Name|Address|Salary| |-----|-------|------| |Hanna|Brisbane|4000| |Adam|Sydney|5000|

Alternatif olarak, Markdown kullanarak da tablolar oluşturulabilir; < table > bir tablonun yüzdelik genişliğiyle tanımlanmasını sağlar. <tr> tablo satırını ayarlar; üst kısımdaki tablo başlığını tanımlayan <th> kalın ve ortalanmış metin verir; tablodaki diğer girişler ise <td> yani tablo verisi etiketi ile ayarlanır.

<table style="width:20%">
<tr>
<th><Name></th>
<th><Address></th>
<th><Salary></th>
</tr>

<tr>
<td><Hanna></td>
<td><Brisbane></td>
<td><4000></td>
</tr>

<tr>
<td><Adam></td>
<td><Sydney></td>
<td><5000></td>
</tr>
</table>

Yukarıdaki her iki sözdizimi de araç çubuğunda 'Run' tıklandıktan sonra aşağıdaki aynı sonucu oluşturabilir.

Görseller

Bir görseli araç çubuğundan, Düzenle menüsünden 'Görsel Ekle'yi seçerek ekleyebilir ve aşağıda gösterildiği gibi gerekli görsele göz atabilirsiniz.

Görsel, kaynak yani src özniteliği ile bağlantıyı içeren ve isteğe bağlı genişlik ve yükseklik özelliklerine sahip <img> Markdown etiketiyle de eklenebilir; örneği aşağıdadır.

<img> <src="https://i.imgur.com/WWrydEh.png" width ="500" height=500 >

Yukarıdaki her iki işlem de araç çubuğunda 'Run' tıklandıktan sonra aynı görseli oluşturabilir.

Sonuç

Bu eğitimde, İşaretleme diliyle tanımlanan farklı İşaretleme etiketlerini ve içeriği daha etkili bir şekilde açıklamak için kodla yan yana kullanılan Jupyter Notebook'a özgü Markdown hücreleriyle ilgili sözdizimini öğrendiniz.

Markdown hakkında daha fazla bilgi edinmek isterseniz, Markdown Kılavuzu'na göz atın.