Header Ads

Markdown Syntax



Markdown Nedir ?
  Markdown bize düz yazı yazarken aslında formatlı bir biçimde yazmayı yani içeriğin doğrudan HTML’e çevrilmesini sağlayan yazılım özelliğidir. Markdown özelliği ilk defa John Gruber tarafından tasarlanmış ve kullanılmıştır. Kısacası Markdown Syntax‘ı öğrenilmesi kolay, hafif biçimlendirme dilinde yazılan bir yazı dilidir. Markdown syntax i kullanılarak yazılan metin .md uzantılı olarak kaydedilmelidir. Özellikle Github gibi platformlarda Markdown kulanımı olmazsa olmazdır. Markdown oluşturmak için en iyi ortamın "Stack Edit" olduğu kanaatine vardık. Stack Edit sayesinde bilgisayarınıza hiçbir program yüklemeye gerek kalmadan web üzerinden https://stackedit.io/ adresine gidip, Start Writing diyerek hızlı ve kolay bir şekilde markdown syntax 'i ile uğraşmaya gerek kalmadan metinlerinizi düzenleyebilirsiniz. Örnek ekran görüntüleri aşağıdaki gibidir:



# Başlık 1
## Başlık 2
### Başlık 3

kalın => **KALIN**
italic => *ITALIC*
kalın ve italic => ***KALIN ve ITALIC***

Madde işaretleri ile okunurluğu kolaylaştırılabilir bir metin yazmak için:
- Swift
- Objective C
- Java
stilini kullanabilirsiniz. Ayrıca alt maddelendirme girintiler ile sağlanır:
- iOS
  - Swift
  - Objective C
- Android
  - Java
  - Kotlin
şeklinde kullanılır. 

Maddelerin numaralı bir şekilde listelenmesi için maddenin ilgili indisi başına yazılır:
1. Nesne Yönelimli Programlama
  a. C++
  b. Java
  c. Ruby
2. Yapısal Programlama
  a. C

  Bağlantılar
Bağlantıdaki hedef url parantez içinde belirtilirken, görüntülecek olan metin köşeli parantez içinde yazılmalıdır.
Örneğin:
[Anasayfa](www.yazilimkaravani.net)
[İletişim](www.yazilimkaravani.net/p/iletisim.html)

Örnek Çıktı:
Anasayfa

İletişim

Ayrıca otomatik bağlantılar için <www.example.com> yapısı kullanılabilir.
Görseller için
![alt text](https://example.com/example.png "Fotoğraf Başlığı")
ifadesi kullanılmalıdır.


Kod Parçaları aşağıdaki konsepte uygun bir şekilde yazılmalıdır:
```dilinismi
  kodlar
```

 dil isimlerine örnek olarak
Java için     java
Node.js için    nodejs
Python    python
Ruby    ruby
SQL/T-SQL    sql
C#    csharp
Objective-C     objc
C++     cpp
ve daha fazlası kullanılabilir...

```java
// HelloWorld.java
public class HelloWorld {
  public static void main(String[] args) {
    System.out.println("Hello, World");
  }
}
```




UML Diyagramları ve Flow Chart Sembolleri
UML Örneği:
```sequence
Mehmet->Ahmet: Merhaba Ahmet, nasılsın?
Note right of Ahmet: Ahmet düşünüyor..
Ahmet-->Mehmet: İyiyim, teşekkürler..
```



Flow Chart Örneği:
```flow
st=>start: Başla
e=>end: Son
op=>operation: İşlem
cond=>condition: Koşul

st->op->cond
cond(yes)->e
cond(no)->op
```



En temel haliyle markdown kullanımını bu şekilde tamamlayabiliriz. https://stackedit.io/  adresinden daha fazla kullanım şekli ve pratiği kazanabilirsiniz, iyi çalışmalar...

Kaynaklar
https://wmaraci.com/nedir/markdown
http://omeryaylaalti.github.io/blog/markdown/
https://docs.microsoft.com/tr-tr/contribute/help-crr/help-content/contribute/contribute-how-to-write-use-markdown
https://github.com/adam-p/markdown-here/wiki/Markdown-Cheatsheet
https://stackedit.io/


Hiç yorum yok

Blogger tarafından desteklenmektedir.