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:
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ı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.
![alt text](https://example.com/example.png “Fotoğraf Başlığı”)
ifadesi kullanı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 Ö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
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/