Belge analizi: Markdown gösterimi

Döküm Araçları'nda Azure Content Understanding, yapılandırılmamış belgeleri GitHub Flavored Markdown'a dönüştürürken, doğru aşağı akış kullanımı için içerik ve düzeni korur. Bu makalede, her içerik ve düzen öğesinin Markdown'da nasıl temsil edilir açıklanmaktadır.

Sözcükler ve seçim işaretleri

Tanınan sözcükler ve algılanan seçim işaretleri Markdown'da düz metin olarak gösterilir. Seçim işaretleri Unicode karakterleri ☒ (seçili) ve ☐ (temizlenmiş) kullanılarak kodlanır. Markdown biçimlendirme söz dizimiyle belirsizliği önlemek için içerikten kaçınılabilir.

Barkodlar

Barkodlar alternatif metin ve başlıkla Markdown görüntüleri olarak temsil edilir: ![alt text](url "title").

İçerik türü Markdown şablonu Örnek
Barkod ![{barcode.kind}]({barcode.path} "{barcode.value}") ![QRCode](barcodes/1.2 "https://www.microsoft.com")

Formüller

Matematiksel formüller Markdown'da LaTeX kullanılarak kodlanır:

  • Satır içi formüller, metin akışını korumak için tek dolar işareti ($...$) içine alınır.
  • Görüntüleme formülleri, tek başına görüntüleme için çift dolar işareti ($$...$$) kullanır.
  • Çok satırlı formüller, boş satırlar araya girmeden ardışık görüntüleme formülleri olarak temsil edilir. Bu yapı matematiksel ilişkileri korur.
Formül türü Markdown Görselleştirme
Satır içi $\sqrt { -1 } $ is $i$ $\sqrt { -1 } $ $i$'ye eşittir$
Ekran $$a^2 + b^2 = c^2$$ $a^2 + b^2 = c^2$
Çok satırlı $$( x + 2 ) ^ 2 = x ^ 2 + 4 x + 4$$
$$= x ( x + 4 ) + 4$$		 $$( x + 2 ) ^ 2 = x ^ 2 + 4 x + 4$$ $$= x ( x + 4 ) + 4$$

Resimler

Şekiller ve grafikler de dahil olmak üzere algılanan görüntüler standart Markdown resim söz dizimi kullanılarak temsil edilir. Alternatif metin, şekil içindeki algılanan metni içerir ve sözdizimi yapılandırma seçeneklerine göre değişir.

Görüntü gösterimi desenleri

Konfigürasyon Markdown şablonu Description
Temel ![detected text](figures/path) Açıklama olmadan standart görüntü
şekil açıklamasını etkinleştir ![detected text](figures/path "description") Oluşturulan görüntü açıklamasını içerir
ŞekilTanımınıEtkinleştir + ŞekilAnaliziniEtkinleştir ![detected text](figures/path "description") ardından bir grafik, markdown tablosu veya denizkızı diyagramı Açıklama ve ekli şekil analizi (grafik, tablo veya diyagram) içeren resim
yalnızca Şekil Analizini Etkinleştir ![detected text](figures/path) ardından bir grafik, markdown tablosu veya denizkızı diyagramı Açıklama ve ekli şekil analizi (grafik, tablo veya diyagram) olmayan resim

Bir şekilde algılanan metin olmadığında, hizmet alternatif metin olarak tek bir boşluk ekler, böylece resim doğru şekilde işlenir, örneğin ![ ](figures/1.1).

Örnekler

"Enable Figure Description" özelliği etkinleştirilmeden görüntü

![Line1 Line2](figures/1.1)

enableFigureDescription ile görüntü

![Line1 Line2](figures/1.1 "This is a generated image description.")

"EnableFigureDescription" ve "EnableFigureAnalysis" ile birlikte görüntü

![Line1 Line2](figures/1.1 "This is a generated image description.")
Seçenek 1: Grafik şekil analizi
{ ...chart config... }
Seçenek 2: Markdown tablo görsel analizi
| Month | Value |
|-------|-------|
| Jan   | 100   |
| Feb   | 150   |
| Mar   | 200   |
| Apr   | 250   |
| May   | 300   |
| Jun   | 275   |

enableFigureDescription ve enableFigureAnalysis aktif olmadan bir görüntü

![Line1 Line2](figures/1.1)

```mermaid
{ ...mermaid diagram... }

Şekil analizi

Belgelerde algılanan grafikler ve diyagramlar, özelleştirilmiş işleme biçimlerine sahip yapılandırılmış şekil içeriği olarak temsil edilir.

Grafikler

Grafikler, JSON biçiminde Chart.js söz dizimi kullanılarak şekil içeriğinde gösterilir. Ayara config.chartFormat (chartJs veya markdown) bağlı olarak grafikler Chart.js kod blokları veya Markdown tabloları olarak gösterilebilir.

Chart.js biçimi (chartFormat=chartJs)

{
  "type": "bar",
  "data": {
    "labels": ["Jan", "Feb", "Mar", "Apr", "May", "Jun"],
    "datasets": [{
      "label": "Values",
      "data": [100, 150, 200, 250, 300, 275],
      "backgroundColor": "rgba(54, 162, 235, 0.2)",
      "borderColor": "rgba(54, 162, 235, 1)",
      "borderWidth": 1
    }]
  },
  "options": {
    "scales": {
      "y": {
        "beginAtZero": true
      }
    }
  }
}

Markdown tablo biçimi (chartFormat=markdown)

Ay Değerler
Jan 100
Şubat Yüz elli
Mar 200
Nisan 250
Mayıs 300
Haz 275

Diyagramlar

Diyagramlar, şekil içeriğinde Mermaid söz dizimi kullanılarak temsil edilir ve Markdown'da Mermaid kod blokları olarak işlenir.

graph TD
    A[Start] --> B{Decision}
    B -->|Yes| C[Action 1]
    B -->|No| D[Action 2]
    C --> E[End]
    D --> E

İşleme desteği

Popüler Markdown uzantıları ve görüntüleyicileri hem Chart.js hem de Mermaid kod bloklarının görsel olarak işlenmesini destekler:

  • Chart.js: Etkileşimli grafikleri çizer
  • Mermaid: Akış çizelgelerini, sıralı diyagramları ve diğer diyagram türlerini işler
  • Modern Markdown işlemcilerinin çoğu her iki biçim için de eklentiler içerir

İmzalar

Algılanan imzalar, şekillere benzer şekilde Markdown görüntüleri olarak temsil edilir. Alternatif metin, imza bölgesinin içinde tanınan tüm metinleri içerir.

Note

İmza algılama yalnızca 2026-06-01-preview API sürümünde kullanılabilir.

İmzalar stil, yönlendirme ve okunabilirlik açısından büyük ölçüde farklılık gösterdiğinden, imza bölgesi içinde tanınan metnin doğruluğu farklılık gösterebilir ve standart yazdırılan metne göre daha düşük olabilir. Tanınan metni yetkili transkripsiyon yerine tamamlayıcı bir sinyal olarak kabul edin.

İçerik türü Markdown şablonu Örnek
Signature ![{recognized text}](signatures/{path}) ![Mary Hell](signatures/1.1)

İmzada tanınan metin olmadığında, hizmet alternatif metin olarak tek bir boşluk ekleyerek görüntünün doğru şekilde işlenmesini sağlar:

![ ](signatures/1.1)

İmza alt bilgi gibi bir sayfa bölgesiyle ilişkilendirildiğinde, bu bölgeyle birlikte HTML açıklaması olarak kodlanır:

<!-- PageFooter="![Mary Hell](signatures/1.1)" -->

Satırlar ve paragraflar

Paragraflar Markdown'da boş satırlarla ayrılmış bir metin bloğu olarak gösterilir. Satırlar mevcut olduğunda, her belge satırı Markdown'daki ayrı bir satıra eşlenir.

Bölümler

Başlık veya bölüm başlığı rolleri olan paragraflar Markdown başlıklarına dönüştürülür. Varsa başlık, düzey-1 başlığıyla atanır. Algılanan hiyerarşik yapıyı korumak için diğer tüm bölümlerin başlık düzeyleri atanır.

Tablolar

Tablolar şu anda Markdown'da, birleştirilmiş hücreler için <table> ve <tr> öznitelikleri ve zengin üst bilgiler için <th> aracılığıyla destek sağlayan HTML tablo işaretlemesi (<td>, rowspan, colspan, ve <th>) kullanılarak temsil edilir. Herhangi bir altyazı <caption> öğesi aracılığıyla temsil edilir. İlişkili dipnotlar, tablodan hemen sonra metin olarak görünür.

<table>
<caption>Table 1. Example</caption>
<tr><th>Header A</th><th>Header B</th></tr>
<tr><td>Cell 1A</td><td>Cell 1B</td></tr>
<tr><td>Cell 2A</td><td>Cell 2B</td></tr>
</table>
This is a footnote.
Tablo 1. Örnek
Üst Bilgi AÜst Bilgi B
Hücre 1AHücre 1B
Hücre 2AHücre 2B
Bu bir dipnot.

Sayfa meta verileri

Markdown sayfa numaraları, üst bilgiler, alt bilgiler ve kesmeler gibi sayfa meta verilerini yerel olarak kodlamaz. Bu bilgiler aşağı akış uygulamaları için yararlı olabileceği için HTML açıklamaları gibi meta verileri kodlarız.

Meta veriler Markdown
Sayfa numarası <!-- PageNumber="1" -->
Sayfa başlığı <!-- PageHeader="Header" -->
Sayfa alt bilgisi <!-- PageFooter="Footer" -->
Sayfa sonu <!-- PageBreak -->

Dijital içerikten algılanan köprüler, standart Markdown bağlantı söz dizimi kullanılarak temsil edilir. Hizmet, özgün belgedeki hem görüntüleme metnini hem de hedef URL'yi korur.

Bağlantı türü Markdown şablonu Örnek
Standart bağlantı [display text](url) [Visit Microsoft](https://www.microsoft.com)

Örnekler

For more information, visit the [Microsoft Foundry](https://aka.ms/ai-foundry) portal.

Contact our support team at [support@contoso.com](mailto:support@contoso.com "Email support").

See the [official documentation][docs] for detailed instructions.

[docs]: https://learn.microsoft.com

Açıklamalar

Vurgular, alt çizgiler ve açıklamalar gibi belge ek açıklamaları, parametre tarafından annotationFormat denetlenen farklı biçimler kullanılarak Markdown'da gösterilebilir.

Not formatları

Biçim Description Kullanım örneği
none Markdown'da ek açıklama bilgisi yok Açıklama gösterimi üzerinde tam denetim
frontMatter HTML span etiketleriyle YAML ön içeriğinde ek açıklamalar Tam belge bağlamı ile basit RAG senaryoları
markdown Yerli Markdown belirtme söz dizimi Standart Markdown uyumluluğu

Biçim: hiçbiri

annotationFormat=none ayarladığınızda, Markdown herhangi bir ek açıklama bilgisi içermez. Ek açıklamaları ayıklamak için hem enableAnnotation hem de returnDetails, true olarak ayarlayın.

This is the document content without any annotation markers.
Use the annotations JSON property to customize representation.

Biçim: frontMatter (varsayılan)

YAML ön bilgisindeki ek açıklamaları, ek açıklama ayrıntılarına başvuran id özniteliklerini içeren HTML etiketleriyle kodlar.

---
fields:
  title: "Document Title"
annotations:
- id: underline-1
  author: Paul
  type: underline
  comments:
  - message: "Please review this section"
    author: Paul
    tags: "approved,👍3"
- id: highlight-2
  author: Sarah
  type: highlight
  comments:
  - message: "Important information"
    author: Sarah
---

This is <span id="underline-1">underlined text</span> in the document.

This section contains <span id="highlight-2">highlighted content</span> for emphasis.

<!-- Annotations without spans appear at page end -->
<span id="note-3" />

Biçim: markdown

Hedef Markdown işlemcisi tarafından desteklendiğinde ek açıklamalar için yerel Markdown söz dizimini kullanır.

This text has ==highlighted content== for emphasis.

This text has ++underlined content++ for attention.

> **Note:** This is an annotation comment.

Sonuç

Content Understanding Markdown öğeleri, analiz edilen belgelerin yapısını ve içeriğini göstermek için güçlü bir yol sağlar. Bu Markdown öğelerini düzgün bir şekilde anlayıp kullandığınızda, belge işleme iş akışlarınızı geliştirebilirsiniz. Ayrıca daha gelişmiş içerik ayıklama uygulamaları da oluşturabilirsiniz.

İlgili içerik

  • Son güncelleştirme: